手册目录
DreamShow 用户手册
逐步讲解 DreamShow 的每一项功能，并附软件界面截图。DreamShow 中也内置同一份手册：按 F1 键，或点击每个窗口的“?”按钮。 下载完整 PDF 手册，可离线阅读或打印。
开始使用
- 欢迎使用 DreamShow — DreamShow 是一款运行于 Windows 的灯光、音响与视频演出控制软件。它通过 DMX 控制您的灯具，播放声音和视频，并协调其他舞台设备。所有内容都在一系列场景中准备好，每个场景都有自己的时间线，演出时再用 GO 按钮逐个场景地重放。
- 入门 — 首次启动时，DreamShow 不会让您面对一片空白的面板：它会提供三种开始方式，然后给出一份包含六个操作的小清单，每个操作做一次即可掌握要点。这些都不是必须的。
- 创建您的第一场演出（音乐演出或戏剧） — 创建我的第一场演出 向导会为您编写一场完整、可立即运行的演出：音乐演出基于一首或多首音乐，戏剧则基于一份节点列表。您从一个可以正常运行的演出出发，然后在时间线中进行修改。
- 添加您的灯具（场地向导） — 添加我的灯具 向导可在一分钟内用您的真实设备创建一个场地：您查找自己拥有的每种灯具型号，填写其 DMX 模式和数量。DreamShow 会分配 DMX 地址，为每种型号建立一个编组，并把灯具放到场地平面图上，之后您再进行调整。
- 安装、语言与更新 — 本页介绍如何安装 DreamShow、安装了哪些内容以及安装位置、如何选择界面语言、如何得知有新版本发布，以及如何在不丢失工作成果的情况下安装新版本。
- DreamShow 免费使用 — DreamShow 可免费使用：所有功能均开放，没有限制，也没有时间限制。无需安装许可证，也无需购买。
主界面
- 主界面概览 — DreamShow 的主界面就是编辑器：您在这里逐个场景地编写演出、调节灯光、把声音和视频放到时间线上，并在模拟中查看结果。本页介绍界面的各个区域，并链接到详细页面。
- “场景”面板 — DreamShow 的演出是一系列场景，通过 Go、自动或衔接的方式依次播放。场景 面板列出这些场景：您在这里添加、复制、删除和排列场景，选择要编辑的场景，并用 GO 按钮测试场景之间的切换。
- 场景设置 — 场景设置 面板的上半部分描述所选场景：名称、标签、离开方式（按 GO、自动或衔接）、渐变到下一场景、循环、显示给操作员的信息，以及进入场景时执行的命令。同一面板的下半部分（灯具选择、滑块、最终状态）在 中介绍。
- 选择灯具并调节灯光 — 为场景布光时，先勾选要调节的灯具（或编组），然后调节它们的亮度、颜色、位置和专用通道。这些设置构成场景的最终状态：即进入该场景时所呈现的稳定灯光。一切都在 场景设置 面板的下半部分完成。
- 预置 — 预置是一个命名的设置，可以在所有场景中重复使用：一种颜色（“琥珀”、“深夜蓝”）、一组摇头灯位置（“面光”、“歌手”），或一项光束设置（变焦、调焦、图案、棱镜…）。单击一下即可把预置应用到所选灯具。更重要的是，场景会保持与预置的关联：如果您更新了预置（某台摇头灯被移动了，或者色调不再满意），所有使用它的…
- 资源库 — 资源库 面板汇集了可以放到场景时间线上的所有内容：灯具编组、媒体（声音、视频、图像、DMX 流）、效果、轨迹以及其他事件（跳转、等待、黑场、音量…）。将它们拖到时间线的某条轨道上即可；其中一些也可以直接在这里用所选内容创建。
- 日志、音频与时钟 — 主界面底部有三个小面板。日志 记录 DreamShow 正在做的事情（播放的场景、启动的声音、接口错误…）。音频 面板提供一个用于切断声音的紧急按钮、左右音量以及电平表。时钟 显示当前时间、演出开始时间和时长，以及电脑的状态。
- 2D 与 3D 模拟 — 场地 面板显示场地及其灯具，可以俯视（2D）或立体（3D）查看，并显示光束、颜色和视频屏幕。它用于在没有设备的情况下查看演出、单击选择灯具，以及用鼠标让摇头灯指向。无需连接任何灯具，就可以编写并排练整场演出。
时间线
- 场景时间线 — 演出中的每个场景都有自己的时间线：一条按时间展开、分成若干轨道的时间带，您可以在上面放置各种块（灯光、效果、声音、视频、等待、跳转…）。场景开始时，一条红线从左向右扫过时间线，遇到每个块时就触发它。时间线结束后，场景稳定在其最终状态（即在 场景设置 中定义的灯光设置）。
- 灯光块与效果块 — 灯光块让照明在场景进行中发生变化：一个编组亮起又暗下，一种颜色闪过，一盏成像灯在一句台词期间亮起。它们放置在时间线上，叠加在场景的最终状态之上，持续时间由您设定。本页还介绍黑场块以及各类块的颜色。
- 渐变与混合 — DreamShow 让灯光从一个状态过渡到另一个状态有三种方式，它们的行为各不相同：场景渐变（从一个场景切换到下一个场景时）、块的渐变（块的渐亮和渐暗）以及混合（同一轨道上两个相互重叠的块）。分清它们可以避免意外：摇头灯跳动而不是平滑移动，或者颜色过渡时出现亮度低谷。
- 时间线上的声音与视频 — 演出中的声音和视频像灯光块一样放在场景的时间线上：红线到达时它们开始播放，带有各自的渐变，并在您于时间线中移动时跟随红线。本页还介绍其他列表中的停止声音、静音和音量块，以及 DMX 录制。
- 等待（按键、时刻、日期、太阳） — 等待块会让场景的时间线在某个精确位置停下，直到满足某个条件：按下指定的按键（等待按键…），或到达日历上的某个时刻（等待时刻、日期或日出日落…）：一段时长、某个时刻、一年中的某个日期、日出或日落。第二类等待会自行继续，无需任何人在控制位值守：这是建筑照明的基础。
- 等待台词（语音同步） — 等待台词… 块会让时间线停下，直到演员对着麦克风说出指定的台词。DreamShow 自行识别语音，无需联网：演员与机器人之间的对话，或一连串按文本触发的效果，都可以在无人操控的情况下进行。
- 跳转与场景标签 — 跳转会在红线到达它时，让演出程序从一个场景转到另一个场景，无需 GO：用于返回、跳过某一段，或让几个场景循环播放。场景的标签是一个简短而固定的名称，让跳转（以及并行序列）始终能定位到正确的场景，即使插入或移动了场景。本页还介绍实现循环的两种方式。
- 并行序列 — 并行序列是与演出程序同时运行的第二个播放头：它播放一个场景，然后按照后续场景的自动衔接继续播放，而您继续用 GO 推进演出程序。典型示例：一场暴风雨（闪电、雷声、雨声）在某个场景中开始，并在接下来的三个场景中持续，无论演出程序中发生什么，直到某个场景以渐变将其停止。
- 建筑照明 — 建筑立面、大厅、橱窗或花园每天晚上亮灯，无需任何人在控制位值守：日落时点亮，循环播放动画，转为固定照明，在固定时刻熄灭，第二天再全部重新开始。本页说明如何用 DreamShow 的等待块、循环和跳转来构建这样的程序。
- 动态效果 — 动态效果将一种波形（正弦、方波、追逐、随机等）应用于一组灯具的某个属性：亮度、颜色或位置。相位差让动作从一台灯具传递到另一台：亮度波浪、追逐、流动的彩虹、摇头灯的圆形扇面。效果是时间线上的一个块：它可以像其他块一样放置、调整大小和渐变。
- 像素映射 — 像素映射把 LED 灯条、矩阵和 LED 灯具的单元当作屏幕的像素来处理（从观众席看），并在上面播放动态画面：滚动的渐变、彩虹、波浪、等离子、追逐、闪烁、火焰，或您选择的一幅图片。它是时间线上的一个块，与演出程序同步。
指向、区域与轨迹
- 用摇头灯指向并覆盖区域 — 场地面板中的两个工具无需拖动滑块即可调整摇头灯（电脑摇头灯）的水平（pan）和垂直（tilt）：指向让所有选中的摇头灯对准同一个点；区域把选中的摇头灯分布在您绘制的一块区域上（矩形或椭圆），可以在地面、舞台上或墙面上。DreamShow 根据每台摇头灯的位置、吊挂方式和水平 /…
- 轨迹 — 轨迹让摇头灯（或其他灯具）随时间运动：您设置若干关键帧，每个关键帧带有一组灯具状态（位置、颜色、亮度、变焦…），DreamShow 计算两个关键帧之间的全部变化。以块的形式放到时间线上后，轨迹可以在一个场景中让光束扫过舞台、让一片光旋转，或让颜色渐渐过渡。
- 摇头灯校准 — 为了指向，DreamShow 根据摇头灯在场地中的位置、吊挂方式以及其定义中的水平（pan）/ 垂直（tilt）行程来计算水平和垂直数值：这就是几何模型。它的效果不错，但如果摇头灯挂得稍有歪斜、吊杆高度与测量值不完全一致，或定义不够精确，都会导致指偏。4 点校准可以纠正这一点：您告诉…
场地
- 灯具、地址、位置 — 此窗口用于描述场地：它的尺寸、舞台、在地球上的位置，最重要的是灯具（“fixtures”）列表，包括各灯具的型号、DMX 模式、地址以及在场地中的位置。您就是在这里为场地“配接”（patch），也就是告诉 DreamShow 哪台灯具响应哪个 DMX…
- 灯具库 — 灯具库包含灯具的定义：对每个型号，记录其 DMX 通道、通道功能、模式、单元以及一些物理数据。向场地添加灯具时，您就在这里选择它的定义。DreamShow 自带 1 600 多个 QLC+ 格式的定义；您还可以导入、创建、编辑定义，并在线更新。
- DMX 连接 — “DMX 连接”窗口告诉 DreamShow 场地的各个 DMX 域（Universe）从哪里输出：网络上的 Art-Net 节点、sACN 接收端、USB DMX PRO 接口或 uDMX 接口。连接属于场地：它们保存在场地文件中，切换场地也会同时切换输出。
- 手动控制 — 有些设备不应跟随演出程序：吊机、摇头灯的供电、继电器、机械遮光器…… “手动控制”窗口把它们从演出程序中移出，让您手动控制。无论正在播放哪个场景，即使在全局黑场期间，它们的通道也始终被强制输出到 DMX。
- 视频屏幕 — 屏幕是演出播放视频和图片的表面：连接在电脑上的显示器或投影机，或者 IP 视频播放器（网络上的播放设备）。每个屏幕都有一个 名称：时间线上的视频块按此名称指向屏幕。屏幕还可以放置在场地中，让 3D 模拟在相应位置显示视频。
- 切换、重命名、复制场地 — 场地 描述一个演出地点：它的尺寸、灯具及其地址、编组、屏幕、DMX 连接和校准数据。您可以拥有多个场地（您的剧场、巡演场地、用于测试的办公室），并在它们之间切换。一个场地可供多个演出使用。
DMX 与控制
- DMX 数值与 DMX 推子 — DMX 菜单中的两个窗口，用于查看和强制 DreamShow 发送给灯具的内容。DMX 数值… 实时显示一个域的 512 个通道的发送值。DMX 推子… 可以在演出程序之上手动接管某个通道，用于测试灯具或在排练中排除故障。
- 可视化模式 — 可视化模式把 DreamShow 变成另一个软件或另一台灯光控制台的监看屏幕：2D/3D 模拟显示该设备在网络上发送的 DMX（Art-Net 或 sACN），而不是 DreamShow 的演出程序。它还可以把接收到的 DMX 录制成文件，供 DreamShow 和独立播放器回放。
- 声控灯光与速度 — DreamShow 可以实时聆听音乐（麦克风、线路输入，或本机正在播放的声音，例如 DJ 软件），并以两种方式加以利用：让一个灯具编组的亮度随声音的节奏变化，以及给出一个 速度（以 BPM 计，即每分钟节拍数），可每隔 N 拍触发一次 Go。速度也可以手动敲击（TAP），或来自调音台或软件的 MIDI 时钟。
- 时间码（LTC / MTC） — 时间码 是另一台设备持续发送的时间（时:分:秒:帧）：音轨、调音台、多轨录音机、视频或音乐软件。DreamShow 可以跟随它：每个设有起点时间的场景会在时间码到达该时间时开始，DreamShow 始终与之保持同步。当灯光必须与另一系统播放的音轨或视频严格对齐时，这就是解决方案。
- MIDI 控制器 — MIDI 控制器（带打击垫、按钮或推子的控制面板，通过 USB 连接）可以控制 DreamShow：Go、上一场景、跳转到某个场景、黑场、暂停、DMX 推子… 每个按钮或推子只需触碰一下即可 学习。如果控制器支持，其 LED 会根据演出状态（当前场景、黑场、是否可以 Go）亮起。
- 网页遥控 — 与演出控制电脑连接在同一网络中的手机或平板，可以通过浏览器控制演出：Go、返回、场景列表、黑场、暂停、复位到“就绪”、敲击速度，以及几个选定的 DMX 推子。手机上无需安装任何东西。便于在观众席、舞台上或后台启动演出。
- OSC 遥控 — OSC（Open Sound Control）是一种在演出控制中广泛使用的网络命令语言：平板应用、可编程按键盒、演出程序或视频播放软件都能发送 OSC 消息。DreamShow 接收这些消息来执行 Go、切换场景、黑场、接管 DMX 通道等，并把自己的状态（当前场景、黑场、能否…
- 遥控器（GO 按键） — 此窗口用于选择控制提示窗口（演出模式）的按键：GO、上一步 和 黑场。它主要用来连接 无线演示遥控器（用来翻动幻灯片的、带 2.4 GHz USB 接收器的小盒子）：这类遥控器的行为相当于键盘，会发送按键（下翻页、方向键等）。您只需告诉 DreamShow 每个按钮发送的是哪个键。
演出
- 演出模式与提示窗口 — 演出模式 是播放演出的方式。它会打开 提示窗口：一个简洁、远处也能看清的界面，显示当前场景、其进度、下一个场景以及给操作员的提示信息，并带有大号的 GO、◀ 上一步 和 黑场 按钮。这个窗口永远不会修改演出：它只是向播放引擎发送指令。它可以放到第二块屏幕上，也可以缩成一条小条（迷你），以便让编辑器保持可见。
- 崩溃或断电后的恢复 — 如果 DreamShow 意外停止（崩溃、强制关闭、断电），重新启动时它会建议您正好从停止的地方继续：同一场演出、同一个场景、时间线上的同一秒。在演出进行中，您重新启动 DreamShow，回答 是，继续，演出程序就会接着运行。
用 AI 创作
- 用 AI 创建演出 — 您已经有了一部戏的剧本、提示表或演出流程：一个对话式 AI（ChatGPT、Gemini、Claude、Le Chat…）会根据这份文档编写演出，包含灯光、声音，以及（如果场地里有的话）机器人和 LED 面具。DreamShow…
- 由 AI 生成 DMX 流 — 此功能让 AI 为一首音乐编写完整的灯光设计，逐帧生成，形式是一个 DMX 流（一个 .DmxStreaming 文件）。DreamShow 会准备一份请求，其中描述场地、逐通道列出的所选灯具，以及对音乐的分析（速度、拍子、小节、段落、重音）。您把它粘贴到一个能运行 Python 的 AI…
- AI 助手（设置场景） — 用几句话描述您想要的灯光，例如“蓝色全亮灯光覆盖舞台右半边”：助手会用您真实的灯具设置所选场景。它使用 Anthropic 的 AI —— Claude，以及 DreamShow 自己的工具：用摇头灯覆盖一个区域、对准一个点、颜色、亮度、变焦、频闪、调色板。它从不接触 DMX…
- 连接 AI（MCP） — 您平时使用的 AI 可以在您提出要求时设置 DreamShow 的场景：“右侧蓝色全亮”、“关闭舞台后方的摇头灯”…… 支持 Claude、ChatGPT、Claude Code、Cursor、VS Code（Copilot）、Windsurf、LM Studio、Gemini CLI…
舞台设备
- 独立播放器 — 独立播放器可以 无需电脑 重放 DreamShow 的演出：用于外立面、橱窗、大厅、灯光花园、旋转木马… DreamShow 预先逐场景地计算演出，生成一个 DMX 流（一个 .DmxStreaming 文件），然后您把它发送到一个小盒子：ESP32 模块、Raspberry Pi 或 Windows…
- 平板追光 — 用一台或多台平板（或手机）充当“追光”：屏幕上是场地的平面图；您把手指放上去，所选的摇头灯就会实时跟随您的手指。每台平板可以控制自己的摇头灯，并拥有自己的亮度和变焦。无需传统追光灯，就能跟随演员、歌手或主持人，非常理想。
- 后台显示屏 — 后台显示屏是放置在侧台、化妆间或接待处的信息屏幕：“距开幕还有 5 分钟”、“中场休息 — 21 点 15 分继续”、“当前场景：第二幕”、时间、演出时长… DreamShow 自己提供要显示的页面；任何带浏览器的屏幕（平板、接 HDMI…
- 提词器 — 提词器把剧本台词逐句显示在后台显示屏上：侧台的屏幕、平板电脑，或面向演员的 LED 屏。它独立于场景控制运行：负责的人用手机翻页，不会影响灯光和声音；舞台监督也可以用控制窗口的按键翻页。
- 人形机器人 — DreamShow 可以通过时间线控制 Booster K1 人形机器人：站起、说话（配合一个声音文件）、跳舞、挥手致意、行走、转头… 每个动作都是一个 机器人… 块，放在场景中恰当的时刻，与灯光、声音同步，如果您愿意，还可以与 LED…
- LED 面具 — DreamShow 可以控制 Shining Mask 系列的蓝牙 LED 面具，面具由演员佩戴，或放在机器人的脸上。在时间线上，一个 面具… 块可以更换显示的面孔、展示图像或动画、滚动显示文字，或者让面具 说话：它的嘴巴随着声音文件的节奏动起来。
- 联网插座 — DreamShow 可以在演出过程中开关电源插座：夜间切断建筑照明灯具的电源、开门前恢复供电、在合适的时刻启动烟雾机或招牌。支持四类插座：
文件
- 演出、文件与项目 — 本页介绍 文件 菜单（新建、打开、保存演出，导出或导入完整项目），并说明 DreamShow 把您的场地、演出、媒体和设置存放在哪里。