手册目录
独立播放器
独立播放器可以 无需电脑 重放 DreamShow 的演出:用于外立面、橱窗、大厅、灯光花园、旋转木马… DreamShow 预先逐场景地计算演出,生成一个 DMX 流(一个 .DmxStreaming 文件),然后您把它发送到一个小盒子:ESP32 模块、Raspberry Pi 或 Windows 迷你电脑。播放器按照自己的时间表独立重放它,包括在日落时开始。
打开方式: 菜单 文件 > 导出到独立播放器…(提示气泡:“由 ESP32、树莓派或迷你电脑在无需电脑的情况下回放的 DMX 流(.DmxStreaming)”)。
前提条件:已加载场地,且演出中至少有一个场景(否则提示“该演出不包含任何场景。”)。

演出如何被计算
正如窗口顶部所说明的:“演出将预先逐场景计算为一个 DMX 流(.DmxStreaming),由播放器在无需电脑的情况下独立回放:ESP32、树莓派或迷你电脑。等待 GO 的场景会在其时间线结束后自动衔接。”
更准确地说,DreamShow 用自己的引擎在处理器允许的范围内尽可能快地重放演出:
- 处于 自动 或 已衔接 的场景,会像演出时一样进入下一个场景;
- 处于 手动 GO 的场景,在其时间线结束后会自动获得 Go(再加上设定的保持时间,见下文);
- 时间线为空的场景至少持续 2 秒;
- 场景之间的渐变、效果、轨迹、动态效果、像素映射和 DMX 流,都与在 DreamShow 中一样计算;
- 只导出 灯光:声音、视频、机器人、面具、显示屏和其他设备都不在流中;
- 按时刻、日期或太阳的等待会被跳过(播放器有自己的时间表,见下文);
- 设有 最大时长 的 循环 场景会导出到该时长为止;没有最大时长时,只导出一圈,由播放器让片段循环重放;
- 跳转到已播放过的场景的 跳转到场景 会结束导出:只计算一个循环,由播放器从片段开头循环重放;
- 出于安全考虑,计算会在演出进行一小时后停止。
设置
- 场景从 … 到 …:导出的第一个和最后一个场景(默认:整个演出)。场景以“3. 场景名称”的形式列出。
- 帧率:流每秒的帧数:25 Hz、30 Hz 或 40 Hz(默认 40 Hz,即 DreamShow 引擎的速率)。较低的帧率会得到较小的文件,在 ESP32 上很有用。
- 结尾保持(秒):在手动 GO 场景的时间线末尾、自动 Go 之前额外增加的秒数(默认 0)。它应用于 每一个 被导出的手动 GO 场景,包括最后一个:这样就可以让某个场景的最终状态多停留一会儿。
导出的灯具
列表显示场地中所有的灯具,格式为 标识 名称 (域 U,地址),起初全部勾选。
- 全部 / 无:全部勾选或全部取消勾选。
流中包含已勾选灯具的所有通道,且只包含它们。请取消勾选播放器不应控制的那些。如果一个都没有勾选:“未选择任何灯具。”。
保存文件
- 保存文件…:给出一个文件名(
<片段名称>.DmxStreaming),计算数据流(“正在计算数据流…”)并保存。随后显示摘要:“已保存:…”,然后是“… 秒,… 个场景,… 台灯具,… 个域共 … 个通道,… KB。”。
之后您可以把该文件复制到 Raspberry Pi 的 SD 卡、迷你电脑的磁盘上,或者从播放器的网页上传。
如果文件超过大约 2.4 MB,摘要会用橙色追加:“超出 4 MB ESP32 的存储容量:请使用 SD 卡、16 MB 模块或树莓派。”
直接发送到播放器
直接发送到播放器 框通过网络发送数据流,无需经过文件。
- 地址:播放器的地址。正如窗口所示:“dsplayer.local、192.168.4.1(ESP32 热点)或其 IP 地址。”默认值:
dsplayer.local。DreamShow 会记住上次使用的地址。 - 密码:播放器的密码(如果它有的话;播放器的
pin设置)。否则留空。 - 片段名称:播放器识别这个演出所用的名称。根据演出名称生成建议值(小写,无重音符,用连字符,最多 40 个字符);发送的文件名为
<片段名称>.DmxStreaming。 - 若 player.ini 中没有该片段则自动添加(默认勾选):如果播放器配置的
[clips]部分中没有该名称的片段,则在其中添加一行<片段名称> = <文件>。播放器随后会重新加载其配置。 - 发送后开始播放(默认勾选;DreamShow 会记住您的选择):让播放器立即播放读取该文件的片段。此选项要求该片段已在
player.ini中声明;否则会提示:“player.ini 中没有播放 … 的片段:请勾选添加片段。”。 - 发送到播放器:计算数据流并发送(“正在向 … 发送 … KB…”),然后显示“已发送到播放器 …:… 。”,可能还有“片段“…”已添加到 player.ini。”和“已开始播放“…”。”,最后是摘要。
失败时:“发送失败:…”,并给出原因,例如“播放器无响应”、“播放器拒绝了该文件(…)。”(括号中的数字 403 表示缺少密码或密码错误)、“播放器拒绝了 player.ini(…)。”或“播放器拒绝播放(…)。”。
正在播放的片段被重新发送时,会继续以新版本播放。
- 关闭:关闭窗口。
播放器本身
播放器是随 DreamShow 提供的程序,适用于三类盒子:
| 盒子 | DMX 输出 | 按钮 / 继电器 | 片段存储 |
|---|---|---|---|
| ESP32(ESP32、ESP32-S3、ESP32-C3) | 串口 + RS-485 模块,Wi-Fi 上的 Art-Net | GPIO 引脚 | 内部存储(4 MB 模块约 2.4 MB,16 MB 模块 14 MB)或 SD 卡 |
| Raspberry Pi | 串口 + RS-485、“Open DMX”FTDI 线缆、Enttec USB PRO 类接口、Art-Net | GPIO 引脚 | Pi 的 SD 卡 |
| Windows 电脑(迷你电脑) | Enttec USB PRO 类接口、Art-Net | 键盘按键 | 磁盘 |
它能做到:
- 多个 片段(一个片段 = 一个
.DmxStreaming文件); - 每周时间表:按星期几设置时段,可以是固定时间,或者带分钟偏移量的 日出/日落,包括跨过午夜的时段;
- 循环 播放或只播放一次,片段之间 交叉渐变,并且在时段之外为 黑场 或保持最后一帧;
- 按钮(GO、下一个、上一个、黑场、回到时间表)和按状态(正在播放、已停止、指定片段)控制的 继电器;
- 多个域:流中的每个域输出到一个 DMX 端口或一个 Art-Net 域;
- 一个控制用的 网页。
播放器的网页
在浏览器中打开播放器的地址(例如 http://dsplayer.local/)。如果浏览器是法语的,页面就是法语,否则是英语。因此下面括号中给出的是页面上实际显示的英文名称。页面显示:
- 播放器的名称、时间、日出和日落时间以及版本;
- 模式(Schedule(时间表)或 Manual(手动))、当前时段、正在播放的片段、进度条和位置;
- 按钮 GO、◀ Previous(上一步)、Next ▶(下一步)、BLACKOUT(黑场)、Stop(停止)和 Schedule(时间表;回到时间表);
- Clips(片段)列表,带有一个用于播放的 ▶ 按钮,如果文件缺失则标注“missing”(缺失);还有一个文件字段和用于发送片段的 Upload(上传)按钮;
- 可编辑的 Configuration (player.ini)(配置),带有 Save and reload(保存并重新加载),以及一个用于输入播放器密码的 code:(密码)字段。
没有互联网时,播放器在打开页面时从浏览器获取时间;有互联网时,则从网络获取。
player.ini 文件
播放器的配置保存在一个文本文件中,可以通过网页修改。示例:
[player]
name = Facade Paradise
latitude = 44.126
longitude = 4.082
idle = black ; hors planning : black (noir) ou hold (maintien)
fade = 2.0 ; fondu entre clips, en secondes
; pin = 1234 ; code demandé pour modifier (page web, envoi)
[clips]
soir = soir.DmxStreaming
nuit = nuit.DmxStreaming
[schedule]
; nom = jours(lundi..dimanche) début fin clip [loop|once]
soiree = 1111111 sunset-15 23:30 soir loop
nuit = 0000011 23:30 01:00 nuit loop
- 日期 用七位数字表示,从星期一到星期日(1 = 启用)。
- 开始 和 结束 写作
HH:MM、sunrise或sunset,可选地带分钟偏移量(sunset-15= 日落前一刻钟)。 - 第一个生效的时段优先。
- 纬度和经度用于计算太阳的位置。
[wifi](ESP32)、[output](DMX 端口和 Art-Net)、[buttons] 和 [relays] 部分用于设置硬件;详情见播放器的文档。
ESP32 的首次启动
如果没有配置 Wi-Fi 网络,ESP32 会开启自己的热点 DreamShow-Player(密码 dreamshow);此时它的页面位于 http://192.168.4.1/。在其中填写 [wifi] 部分并保存:播放器会加入您的网络,之后在 http://dsplayer.local/ 上响应。
分步操作
每晚无需电脑点亮外立面
- 在 DreamShow 中准备好演出:一个或多个设为 循环 或相互衔接的场景,并已在模拟中检查过。
- 打开 文件 > 导出到独立播放器…。
- 选择场景,并把帧率保持为 40 Hz(如果文件对 ESP32 来说太大,则选 25 Hz)。
- 取消勾选播放器不控制的设备。
- 在 直接发送到播放器 中,填写播放器的地址、它的密码(如果有)和一个片段名称,例如
soir。 - 保持两个复选框勾选,然后单击 发送到播放器。播放器会立即播放该片段。
- 打开播放器的网页,在 Configuration (player.ini) 中,在
[schedule]里添加所需的时段,例如soiree = 1111111 sunset-15 23:30 soir loop,然后点击 Save and reload。 - 点击 Schedule:播放器此后就会按它的时间表运行。
为 SD 卡准备片段
- 打开该窗口,设置场景和灯具。
- 单击 保存文件…,并选择 SD 卡或 U 盘。
- 在盒子的
player.ini的[clips]部分中声明该文件。
须知
- 时间线中 按时刻、日期或太阳的等待 不会进入流中:在播放器上,由它的 时间表 决定何时播放每个片段。请为一天中的每个时段各做一个片段。
- 播放器不播放声音和视频。
- 计算和发送在后台进行;窗口仍可使用,但工作期间按钮会变灰。
- 导出的流与 由 AI 生成 DMX 流 的格式相同。