SimplePlay Pro X

SimplePlay Pro X 是一款原生 macOS 演出播出、合成与路由系统。它用于戏剧演出、主题发布会、宗教场所、广播导控间、巡演系统和企业 AV——凡是视频 Cue 必须每晚都按点、逐帧精确地触发的地方，都能用它。

它的不同之处在于：它从设计上就是确定性的。你在准备阶段搭建的一切，到了演出时都会完全一样地重现。没有现场即兴带来的意外，也没有"彩排时看起来不一样"。有了 Live Deck，由你决定预先准备的内容*何时*触发；它*做什么*在准备阶段就已确定，而且每次触发都会被记录，所以现场操作的演出也能被完全重现。

---

版本说明1.4 新功能

SimplePlay Pro X 现在会说你的语言了：整个 App 和这本手册都有九种语言。

---

版本说明1.3 新功能

Stage Compositor 变成了可以用来执行整场演出的地方：在运行中的时间线上触发预先准备片段的 Live Deck、能路由到各自屏幕的图层，以及你需要多少就有多少的 NDI 输出。

---

版本说明1.2 新功能

---

版本说明1.1 新功能

如果你是从 1.0 版升级过来，新增了以下内容：

---

运行一场演出，你不必先读完这本手册。你只需要三步。

搭建演出的三种方式

不知道从哪里开始？文件 ▸ 从示例新建演出…（⌘⇧N）会把搭建演出的三种方式并排展示。第一次运行应用时，它也会在欢迎屏幕之后打开。每一种都会打开一个立即就能播放的小示例，由测试图和标题组成，使用你现有的输出。相关提示会显示在窗口顶部，直到你关闭它们。

它们可以组合。Cue 列表中的一个 Cue 可以是一整条时间线（合成 Cue），任何时间线都可以带一个 Live Deck。示例以未命名状态打开，因此第一次存储时会询问存放位置。用你自己的媒体替换其中的测试图和标题，或者选择空白项目从零开始。

凌晨三点你需要的五个按钮

---

第 02 节认识工作区

窗口有意按广播切换台的方式布局——预览在左，节目在右，播出按钮在两者之间。

标题栏

两个工作区相同：

• 项目名称，旁边是 播放列表 | Stage Compositor 切换器——当前所在的工作区会高亮。⌘⇧E 也能切换。
• 项目输出用于打开或关闭输出窗口；高级…用于打开 Output Patch Bay。
• 主题选择（7 种主题）、界面亮度、错误标记、MIDI 映射开关、演示模式指示和设置齿轮。
• FPS 标记（显示 ▸ 显示 FPS，输出窗口打开时）：主输出的帧率和引擎的帧率。每当渲染循环跳过一个节拍（每个输出都重复了一帧），它的圆点会变红十秒；当帧用掉了大部分时间时会变黄。从第一次跳过节拍起，会出现红色的跳过计数，即使关闭了"显示 FPS"，标记也会一直显示，直到你重置它。点按它可以查看渲染健康：自上次重置以来的整个运行过程（节拍、跳过的节拍、与演出帧率下一帧时长相比的帧时间、输出窗口的忙碌和错过的节拍）、为帧计时的来源（某个输出屏幕的刷新，或舞台自己的时钟）、重置和拷贝报告。

在 13 英寸 MacBook 上，或窗口缩到最小时，标签会缩短（播放列表 | Compositor、输出、高级），而不会消失。把指针悬停在任意按钮上即可看到它的全称。

预览监视器 — 黄色边框

你的安全试看区。试看 Cue、拖动播放头、设置入点和出点（SET IN、SET OUT，界面上为"设置入点""设置出点"），检查文件能否顺畅播放。这里的一切都不会到达观众那里。播放控制按钮（GOTO IN、SET IN、SET OUT、GOTO OUT）就在正下方。

中间的播放与过渡栏

• 就绪状态标签
• 过渡样式 — DISSOLVE、DIP BLACK、DIP WHITE、WIPE
• 过渡时间 — CUT、0.5s、1.0s、2.0s 交叉淡变
• 发着绿光的大 GO 按钮

实时节目监视器 — 红色边框

正是观众看到的画面，右侧边缘还有立体声音频电平表。只要出现在这个监视器上，就已经上墙了。

当前 Cue 条

在监视器下方：正在播放的 Cue，带拖动条、已播放/剩余时间显示、GOTO 10s / 20s / 30s to End 跳转按钮（界面上为"转到："和"结束前 10 秒"等），以及一个停止按钮。

播放列表 Cue

你的演出，从上到下。序号、缩略图、时长、进度条、颜色标签、循环和跟随指示。每一行右侧的控件：循环开关、跟随开关、音频静音、删除，以及拖动排序手柄。

Cue 属性检查器

所选 Cue 的一切——播放、修剪、画面、音频、均衡器和通道矩阵（参见 §6）。

---

第 03 节媒体与 Cue 类型

九种 Cue 类型

HAP — 完全原生

整个 HAP 编码系列都以原生方式解码，由 GPU 辅助，支持 Alpha：

HAP 是媒体服务器类工作流程的正确选择：超大画幅、解码开销低、Alpha 干净。请把它封装在 .mov 中。

图像序列

选择文件 → 导入图像序列 (DPX/PNG/EXR)…（⌘⇧I）。SimplePlay Pro X 会自动识别编号规则、补零位数和帧范围。

每个序列的选项：

• 帧率 — 播放这组画面的速度
• 缺帧处理 — 保持上一帧、黑帧*或*透明帧
• Alpha 模式 — 预乘、直通*或*忽略 Alpha（不透明）
• 色彩空间

---

导入

• 从访达直接把文件拖到播放列表上
• 点按导入文件按钮，或选择文件 → 导入文件…
• 让监视文件夹替你完成

整理与关联式 Cue 编号

• Cue ID 与小数层级： Cue 既支持整数，也支持戏剧和企业活动常用的小数编号（例如 1、1.1、1.2、1.10、2、2.0.1）。临时加的 Cue 可以插在现有 Cue 之间，不会破坏外部控制的绑定，也不必重新编号脚本。
• 分段排序： 关联式排序会按层级处理编号（1.2 < 1.10 < 2.0），避开按字母排序的常见陷阱。
• 重新编号 Cue： 需要时，把当前整个播放列表从 1 开始按顺序重新编号。
• 添加组： 建立幕和场的文件夹，并把它们折叠起来，方便浏览。
• 等待 Cue： 在自动前进的序列中插入一个定时延迟 Cue。
• 控制 Cue： 添加组 ▾ → 添加控制 Cue 会插入一个向其他设备发送 OSC 和 MIDI 的 Cue——参见控制 Cue 与发送标记。
• 拖放： 拖动行即可重新排序；放进组里即可嵌套。
• 颜色标签： 七种鲜明的颜色标签，让演出一目了然。

控制 Cue 与发送标记

控制 Cue 从演出中触发其他设备：灯光控台、音响系统、摄像机、另一台媒体服务器。用添加组 ▾ → 添加控制 Cue 添加一个，然后在检查器的控制部分列出它要发送的内容：

• OSC — 一个主机、一个 UDP 端口、一个地址（例如 /eos/cue/1/12/fire）以及任意参数，用空格分隔：1 是整数，0.5 是小数，其他内容（或 "in quotes"）是文本。
• MIDI — 一个目标（MIDI 接口的端口，或用于连接这台 Mac 上另一个 App 的 IAC 总线），以及一条 Note On、Note Off、Control Change、Program Change 或 MIDI Show Control 命令（GO、STOP、RESUME、LOAD、ALL OFF 或 RESET，附带 Cue 编号和设备 ID）。
• DMX — 通过 Art-Net 发送的灯光电平：节点的 IP 地址（或像 255.255.255.255 这样的广播地址）、一个 Universe、起始通道，以及它和其后各通道的电平（255 128 0，或像 50% 这样的百分比），还可以设置以秒为单位的淡变。参见 DMX 输出。

Cue 触发时，消息会按顺序发出。节目上的内容继续播放——控制 Cue 永远不会替换画面。和任何 GO 一样，随后会选中下一个 Cue；打开自动继续即可立即触发它，这样控制 Cue 就能和紧随其后的视频 Cue 一起触发。立即发送会手动发送这份列表，用来在演出前确认其他设备会响应。和任何 Cue 一样，控制 Cue 也可以由时间码、OSC、MIDI 和 Stream Deck 触发。

在时间线上，设为发送…的标记（右键点按它的旗标）会在播放头每次到达时发送它自己的列表——参见动作标记。

在 Stage Sync 主备对中，只有主机发送：备份机运行同样的演出，但会扣住自己的消息，所以不会重复触发。发送的一切都会写入应用的日志。

批量编辑

按住 ⌘ 或 ⇧ 选择多个 Cue。检查器会切换到批量模式，让你一次性为几十个 Cue 设置音量、适配方式、速度、淡变时长和颜色标签。

自动跟随与自动继续链

---

第 05 节播出——过渡、缓冲与紧急按钮

A/B 双缓冲引擎

始终有两个播放引擎在运行：

• 缓冲 A — 节目。 正在播出的 Cue。由硬件直接解码为 Metal GPU 纹理。
• 缓冲 B — 待命。 预览中的 Cue，已经解码并停在它的第一帧。

按下 GO 时，B 淡入，同时 A 淡出。因为 B 早已启动、处于就绪状态，所以没有解码卡顿、没有闪黑、没有第一帧顿挫——这正是视频 Cue 最常让你在观众面前出丑的几种情形。

播出过渡

紧急按钮行

BLACKOUT · FTB · FREEZE · MUTE · AUTO PLAY · END ALL

它们始终可见、始终有效，从不藏在菜单里。这是有意为之。

---

第 06 节Cue 检查器

选择一个 Cue，右侧的 Cue 属性面板就会填满。它的布局和 Stage Compositor 的片段检查器一样：带标题的区块，标签在左，控件在右。

标题区 — Cue 的缩略图、可编辑的标题，以及一行基本信息（类型、格式、时长、大小）。缺失的文件会在这里显示，并附有重新链接和查找演出文件夹。

Cue

• Cue ID — 你自己定的字母数字 ID（Q101、2.5、ACT1）。OSC、MIDI 和时间码就是通过它来指定 Cue。
• 颜色 — 七种标签
• 备注 — 留给你不在时执行演出的人的说明

播放

• 开始 — 暂停在第一帧：载入并停在第一帧
• 延迟 — Cue 播放前的预等待
• 结束 — 保持最后一帧，而不是切到黑场
• 跳转到 — 串联到指定的 Cue
• 速度 — 0.25× 到 2.0×，音频经过变调校正

时间触发 — 从区块的标题处打开；打开后会出现时间码、采集和跟随。

修剪

• 入点 / 出点 — 非破坏性修剪。⌘[ 和 ⌘] 在播放头位置设置它们；⌘\ 重置。
• 淡变 — 淡入和淡出的时长

画面（音频 Cue 不显示）

• 适应 / 填充 / 拉伸 / 自定，自定时可设置宽度、高度和缩放
• 亮度 / 对比度 / 饱和度，有任何改动后会出现重置

音频 — 音量、输出设备、路由（一个预设弹出菜单，加上用于完整矩阵的矩阵…），以及均衡器。

图片、等待、图像序列和合成 Cue 有各自的区块，文件类 Cue 的最后是在访达中显示。

选中了多个 Cue？ 标题区会显示有多少个、分别是哪些类型，每一项改动都会应用到全部（批量模式）。

---

在标题栏的 播放列表 | Stage Compositor 切换器中点按 Stage Compositor，或选择控制 → 切换到 Stage Compositor（⌘⇧E）进入。用同一个切换器即可返回。

这是一条存放在演出文件里的多轨合成时间线。在准备阶段搭建分层的画面；演出当晚把整体作为播放列表中的一个 Cue 播出——再借助 Live Deck，在你选择的时刻把预先准备的片段叠加在它之上触发。

要制作合成 Cue，请在播放列表中选择添加组 ▾ → 添加合成：这会添加 Cue 并在它上面打开 Stage Compositor。像其他 Cue 一样播出它即可。

结构

媒体浏览器（左） — 有 3 个标签页：

1. 文件 — 浏览本地磁盘。按全部 / 视频 / 音频 / 图片 / 序列筛选，或搜索。带缩略图、时长和编码标记。
2. 实时采集 — 已连接的硬件网络摄像头和 USB 采集设备（Elgato Cam Link、USB3 Video、MacBook Pro 摄像头），锁定在 1080p60 运行。
3. 生成器 — 内建的广播测试图、SMPTE/EBU/ARIB 彩条、纯色和对齐网格。

舞台画布（中） — 按舞台尺寸显示的实时合成画面：无论在播放还是停止，都与输出上的画面完全一致，包括在时间线之上触发的 Live Deck 槽位，以及每个片段的效果和混合。选中但未播出的 Deck 槽位会以变暗的方式显示，方便你在触发前摆放它。旁边的电平表测量的是真正送出去的音频——时间线片段、循环和已触发的 Deck 槽位，经过每个音量和音频矩阵之后。点按图层即可选中；拖动即可用屏幕上的实时变换手柄移动和缩放。当多个输出处于跨输出拼接模式时，每个输出所占的舞台区域都会用它在 Patch Bay 中的颜色勾勒出来（即舞台图，参见 §14）。弹出会把画布分离到独立窗口（或按 ⌘⇧F 全屏）。

底部面板 — 顶部边缘有一排标签页：

Live Deck │ Main · Opening Loop × · Award Sting × · +

• Live Deck — 你实时触发的预先准备片段网格（§16）。
• 主线 — 合成自己的多轨时间线，带片段首尾缩略图、音频波形（显示在每个片段的绿色音量通道中）和磁性吸附。
• 循环时间线 — 每个循环一个标签页，点按 + 新建一个（§15）。

检查器（右） — 三个标签页：

• 片段 — 所选片段：在哪里播放、它的变换、播放、效果和音频（§8）。
• 图层 — 所选片段所在的轨道或 Deck 行，或你通过行头点按的那一个：它的输出、主控、旁通、独奏和组（§14）。
• 画布 — 舞台本身：舞台图、舞台大小（预设或精确的宽 × 高，用匹配输出布局把尺寸交还给输出）、带打开 Output Patch Bay…的屏幕列表、视频墙网格，以及作用于所有片段的全部适应 / 全部填充。

---

第 08 节图层、变换与混合

在时间线上选择任意片段（或 Live Deck 中的一个槽位），片段标签页就会按你的工作顺序显示它：在哪里播放、看起来如何、如何播放、它的效果、它的声音。每个控件只出现一次。

位置

一张显示你的屏幕和片段落点的小舞台图，下面是片段的屏幕：

• 跟随图层 （默认） — 片段跟着它的轨道或 Deck 行走。继承来的输出带有图层标记。
• 整个舞台 — 无论图层怎么设置，这个片段都保持在整个舞台上。
• 某个输出 — 只为这个片段选择一个或多个输出。第一个是它定位所在的输出（编辑）；其余的显示相同的画面（镜像）。

大多数时候，你会让片段保持跟随图层，转而给图层设置路由——参见 §14。

基本

• 位置与大小 — 以片段自己的屏幕（或整个舞台）为单位的像素 X、Y、宽度、高度，以及旋转。
• 不透明度 — 0–100%，可设关键帧。
• 混合 — 18 种模式（见下文）。保持*正常*的片段会按它所在图层的方式混合；菜单下方的说明会告诉你具体方式。
• 快速放置 — 一个 3×3 网格可把片段吸附到角落、边缘或中心；适应、填充、全画幅和 1:1 原生可一键设置大小。*填充*会铺满屏幕并裁剪。
• 画中画、分屏与形状预设 — 左上、右上、左下、右下、左分屏、右分屏等，集中在一个菜单中。
• 媒体适配 — 媒体在片段框中的摆放方式：加黑边、裁剪或拉伸。

播放

• 时间线上的入点 / 出点和淡变，以及循环。
• Live Deck 槽位改为显示开始方式和结束时（§16）。

混合模式

片段的混合菜单和"图层"标签页中的菜单都有同样的 18 种模式，并分组列出：

有自己模式的片段会保留它，并以全强度生效。保持正常的片段会采用它所在图层的模式和强度（§14）。

音频

音量与静音、路由预设弹出菜单（编辑后会显示*自定*），以及弹出窗口中的完整矩阵（§13）。

---

文字与计时器

标题、演讲者姓名、幻灯片文字和屏幕时钟都是文字片段。在媒体浏览器的生成器标签页中，文字与计时器部分有四种：文字、倒计时、正计时和当前时间。连按其中一个即可添加到播放头位置，也可以把它拖到轨道或 Live Deck 单元格上。文字片段可以像其他片段一样摆放、淡变、设关键帧并送到输出。

选中它后，检查器中的文字区块用于设置它显示什么以及外观如何：

• 显示 — 文字、倒计时、正计时或当前时间。在下方的框中输入文字；可以有多行。
• 计时器 — 在倒计时、正计时或时钟中，文字里的 {time} 会被替换为时间（"{time} 后开门"）；没有它时，时间显示在文字之后。格式可选自动（MM:SS，一小时以上为 H:MM:SS）、MM:SS 或 H:MM:SS。倒计时会在片段的时长内走到零并停在那里，或者按它自己以秒计的时长走。
• 字体、字重、斜体、大小、颜色、阴影 — 大小以 1080 高舞台上的磅值计，因此在任何分辨率下，文字在屏幕中所占比例都不变。
• 对齐 — 在片段框内左、中、右对齐，以及顶、中、底对齐（片段的位置和大小在基本中设置）。
• 行距、底框（文字后面的背景，可设颜色和圆角）和内边距。

倒计时和正计时根据片段自身的时间计算，因此每次运行演出，它们都会以同样的方式播放。当前时间是例外：它显示 Mac 的时钟。文字几乎不占用 GPU——只绘制一次，只有文字改变时才会重绘（计时器为每秒一次）。

第 09 节图层效果——抠像、调色、模糊与暗角

按片段设置。确定性。存储在项目文件中。

效果堆栈

在片段检查器的效果区块中，片段尚未使用的效果以 + 按钮的形式排列——+ 色度键、+ 颜色、+ 模糊、+ 暗角、+ 遮罩、+ 变形网格。点按一个即可把它作为卡片添加。卡片按应用顺序排列，每张卡片都有：

• 开关按钮——旁通该效果，但不丢失其设置；
• 折叠箭头——不需要调整时收起卡片；
• ×——移除它。移除卡片会把该效果恢复为中性，所以无论有没有人打开检查器，演出看起来都一样。

运动模糊从一开始就是一张卡片（默认开启）。

色度键

带真正溢色抑制的差值抠像：

调色

颜色卡片：

• 亮度（−0.5 到 +0.5）
• 对比度（0.2× 到 2.0×）
• 饱和度（0.0× 到 2.0×）
• 色相（−180° 到 +180°）
• 色温（冷到暖）

模糊、暗角与遮罩

• 模糊 — 半径 0 到 30 px。非常适合给抠像主持人身后的背景做虚化。
• 暗角 — 压暗片段的边缘；强度 0.0 – 2.0。
• 遮罩 — 只显示片段的一部分：矩形、圆角矩形或椭圆，可设宽度、高度、圆角（圆角矩形时）、柔和的羽化边缘，以及用于改为挖洞的反转。

运动模糊

• 默认开启。 关键帧驱动的快速运动（滑入画面的图层、快速摇移）会用根据图层自身动画速度算出的方向性模糊来平滑，而不是显得一卡一卡的。
• 如果你想要逐帧清晰的运动，可以在片段属性中关闭它——静止或没有动画的图层无论如何都不消耗资源，因为模糊只在测得实际运动时才会运行。

---

第 10 节关键帧动画与展开的贝塞尔曲线轨道

以下任何属性都可以随时间做动画：

Opacity · Position X · Position Y · Scale X · Scale Y · Rotation · Volume

关键帧与曲线抽屉

• 点按属性旁的 ◇ 菱形，即可在播放头位置设置关键帧。
• 仅限时间线片段。 Live Deck 槽位从被触发的那一刻起按自己的时钟播放，因此不接受关键帧——请在时间线上制作动画（用循环时间线效果很好），再触发它。旧演出中已带有关键帧的槽位仍会播放它们；检查器会提供移除关键帧。
• 展开曲线轨道： 打开时间线片段下方的内嵌曲线抽屉，即可在每个属性的自动化曲线上查看和放置关键帧。
• 画布关键帧同步： 动画开启时，直接在舞台画布上移动图层会自动写入位置关键帧。

缓动曲线

每个关键帧都有一个曲线设置，在片段属性检查器中它旁边的菜单里选择（或右键点按关键帧本身）：

线性、缓入、缓出、缓入缓出和保持是形状固定的预设——选中哪个，曲线就总是那样。贝塞尔是六种中唯一带可拖动手柄的。

在哪里拖动手柄取决于属性：

• 位置（图层在画布上的路径）：就在舞台画布的运动路径上。连按路径点的菱形，可立即切换为贝塞尔（再连按一次切回缓入缓出）——如果你想用另外五种预设之一，也可以右键点按它，从缓动曲线中选择。无论哪种方式，路径点两侧都会出现两个橙色手柄，弯曲图层在屏幕上实际经过的路径。拖动一次会同时改变 X 和 Y，因为路径上的一个点就是一个二维路径点。
• 不透明度、音量、缩放、旋转（没有空间位置可在画布上显示的属性）：在曲线抽屉中——在时间线片段下方展开它。连按关键帧即可切换为贝塞尔（再连按一次恢复），或右键点按以打开完整的缓动曲线菜单，然后在这张数值随时间变化的图上拖动它的两个手柄。

第一次把关键帧切换为贝塞尔时，它的手柄会根据相邻关键帧算出一条平滑曲线，因此一串贝塞尔关键帧会顺畅地穿过每个点，而不是在每一点都出现折角。如果之后某个手柄（或相邻的关键帧）被拖得不再对齐，右键点按该关键帧/路径点并选择平滑切线，即可恢复连续的形状，同时保持贝塞尔模式。

---

第 11 节投影变形网格与时间线修剪

投影变形网格

• 硬件加速的自由变形： 按图层的几何映射，通过自定义 Metal 顶点着色器直接在 Apple 芯片的 GPU 上执行。
• 可调密度（最高 16×16 / 256 个控制点）： 为建筑投影、穹顶映射、弧形 LED 背景和复杂的舞台表面而设计。
• 网格密度预设： 在检查器中无缝切换 3×3、4×4、5×5、8×8 和 16×16 控制网格。
• 非破坏性样条插值： 切换网格密度时，现有的变形轮廓会通过双三次曲面计算得以保留。
• 交互式迷你变形网格编辑器： 直接在检查器或屏幕画布上拖动控制点。在密集网格（8×8、16×16）上，控制点会自动变小，既保持精度，又避免画面拥挤。
• 一键重置网格： 单个按钮即可把网格恢复为平整的原始矩形，不影响图层的其他变换属性。

高级时间线修剪与吸附

• 首尾缩略图： 每个片段都显示开始帧和结束帧的缩略图。
• 音频波形： 点按片段的绿色圆点即可打开它的音量通道，波形会显示在那里——从文件中测得（每百分之一秒中的最大采样），只显示片段实际播放的那段媒体，并按其音量缩放，降低和淡变都看得出来。再点按一次圆点即可隐藏。没有声音的文件没有波形：它的绿色圆点会变灰（此文件没有音频）。
• 磁性吸附（S）： 让片段边缘吸附到播放头、其他片段、Cue 标记和轨道起点。
• 循环修剪： 拉长已开启循环的片段的右边缘会重复媒体，每一遍都有一个刻痕和吸附点。
• 任意缩放下的片段： 短片段——或者缩得很小的长片段——会显示放得下的内容：先是曲线圆点，然后是缩略图，然后是名称。它的不透明度、音量和动画通道始终与片段等宽，通道标题会缩短为数值，再缩成只有一个彩色圆点。每个时间线标签页都保留自己的缩放，第一次打开的标签页会自动适配视图。
• 拆分片段（⌘B）： 在播放头位置像刀片一样切开。

---

第 12 节实时视频采集、Syphon 与 NDI 输入

硬件实时采集

• 在合成器浏览器的实时采集标签页中，SimplePlay Pro X 会列出所有已连接的 USB 网络摄像头、UVC 设备和采集卡（Elgato Cam Link、USB3 Video 采集卡、FaceTime HD 摄像头）。
• 视频锁定在 1080p60，直接送入 CompositionRenderer，使用零内存分配的纯画面缓冲，把 CPU 占用和延迟降到最低。

Syphon 与 NDI 输入

• 把本地 Syphon 信号或网络 NDI 流作为原生合成器图层接入。
• 对实时摄像机画面实时应用变换、色度键和画中画定位。

---

第 13 节按片段设置的音频矩阵

每个片段都有自己的输入 → 输出通道增益矩阵，最大 64×64。

预设

• 立体声（1–2） · 单声道混合（1–2） · 四声道（1–4）
• 5.1 环绕声（1–6） · 7.1 环绕声（1–8）
• 1:1 直通（1–16、1–32、1–64 Dante AoIP）

每个输出通道都可以自定标签（HOUSE L、DELAY R、SUB、PRESS FEED）。

---

第 14 节屏幕与图层

一个合成只有一个舞台——一块画布——当跨输出拼接打开时，Output Patch Bay 会把它按输出切成若干部分。把画面放到某块屏幕上，就是把它放到那块屏幕所占的舞台区域里。有两种做法：

• 给图层设置路由 （常用做法） — 把整条时间线轨道或 Live Deck 行送到一个输出。上面的每个片段都会去那里。
• 给片段指定自己的屏幕 — 用于个别需要去往与图层不同位置的片段。

舞台图

当两个或更多输出拼接舞台时，画布会用 Patch Bay 中的颜色勾勒出每个输出的区域，片段检查器的位置区块和"画布"标签页也会以缩略图显示同一张图。放在某块屏幕上的片段会在那块屏幕内绘制和拖动；额外的镜像屏幕会显示虚线的镜像轮廓。

图层输出

点按时间线轨道头或 Live Deck 行头，然后在检查器的图层标签页（见下文）中选择它的输出——每个输出一个标签，用它在 Patch Bay 中的颜色显示：

现在把片段放到图层上，它们就会去往图层输出指定的地方——无需逐个片段设置。尺寸铺满整个舞台的片段，会铺满它被送去的整块屏幕。把片段拖到另一条轨道上，它就会改到那条轨道的输出。

"图层"标签页

检查器的图层标签页用于整体编辑一个图层。它显示所选片段所在的轨道或行——也可以点按轨道头或行头来显示那一个。（之后再点按片段会回到"片段"标签页。）你也可以右键点按行头并选择图层属性。

• 输出 — 整个舞台加上每个输出一个标签，并附有说明，告诉你图层上的片段去往何处。如果有片段设了自己的屏幕，会显示数量，并附有跟随图层按钮，可在一个可撤销的步骤中把它们全部交还给图层——对于在图层还没有输出功能时逐个片段设置过路由的演出很有用。
• 主控 — 作用于图层上的一切（连按标签可重置）：
  • 不透明度 — 画面的主控。
  • 音量 — 音频的主控，叠加在每个片段自身音量之上。
  • 混合和程度 — 图层上保持"正常"的片段所用的混合模式，以及生效程度：0% 看起来是正常，100% 是完整模式。图层为"正常"时，"程度"呈灰色。
  • 旁通（从输出上移除），轨道还有独奏。

"不透明度""音量"和"程度"旁的红、绿、紫圆点，与 Deck 行推子上的圆点相同。

• 组 — 把图层放进一个组（或新建组…），并设置该组自己的主控和旁通，可重命名…或删除。

片段自己的屏幕

在片段检查器的位置区块中：

• 跟随图层 （默认） — 图层去哪里，它就去哪里。
• 整个舞台 — 即使图层被路由到别处，也保持在整个舞台上。
• 一个或多个输出 — 只有这个片段去那里。关闭它的最后一个输出，就会把它交还给图层。

主控、旁通与组

你看到的是片段自身的不透明度 × 所在图层的主控 × 所在组的主控；你听到的是片段的音量 × 所在图层的音量。主控为零，或图层、组被旁通时，会把图层从输出上撤下，而不会停止任何东西——推上去，画面立刻就回来了。

行推子。 点按 Deck 行头上三个圆点中的一个，选择它的推子控制什么；推子和圆点旁的读数会变成该圆点的颜色。🔴 是不透明度，🟢 是音量——与时间线片段上不透明度和音量圆点的颜色相同。🟣 是混合：行的混合模式显示出多少。行处于"正常"时，紫色圆点是暗的，读数显示 正常 ▾——点按即可选择一种模式。选好后，行的副标题会显示它的名称（第 2 行 · 相加）。

组（"所有 IMAG""赞助商墙"）是由多条轨道和行共享的一个主控和一个旁通：一个推子或一次点按就能让它们一起降下来。

---

第 15 节时间线标签页、循环时间线与动作标记

循环时间线

除了主线，一个合成还可以包含任意数量的循环时间线——入场循环、颁奖音效、赞助商轮播——每条都在底部面板顶部的独立标签页中编辑。

• 标签栏中的 + → 新时间线，或重新打开你关闭的标签页。
• 右键点按标签页可选择重命名…、复制、载入 Live Deck、在播放头位置添加到主线、关闭标签页和删除…（它会告诉你有多少片段在播放这条时间线，这些片段也会一并删除；撤销可全部恢复）。
• 放不下的标签页会进入 » 菜单，因此标签栏永远不会滚动。

播放循环。 循环通过时间线片段播放——位于主线轨道或 Live Deck 槽位中、在其中显示循环的一个框：

• 在播放头位置添加到主线会在主线上放一个。
• 载入 Live Deck（循环打开时在工具栏中，或在标签页菜单中）会把它放到某行的第一个空 Look、一个新行，或 Deck 的时间线行中（§16）。
• 选中时间线片段即可看到它的循环和时长，并有打开时间线。它的外观取决于循环自己的片段，因此时间线片段本身不提供旋转、媒体适配、效果和音频路由；它的混合作用于循环中保持"正常"的片段。
• 设为循环的时间线片段会在结尾重新开始它的循环；否则会保持最后一帧。
• 同一个循环可以同时在多个地方播放——每一处都独立播放。

循环中不能包含时间线片段，也不能有自己的 Live Deck。

动作标记

按 M 在播放头位置添加标记。在标尺上右键点按标记旗标，选择播放头到达时它做什么：

要重命名标记或更改其颜色， 连按它的旗标，或右键点按并选择重命名…。未重命名的标记会使用其动作的名称，所以新标记设为保持后会显示"保持"；你输入过的名称则无论标记做什么都会保留。

GO 会先释放正在等待的保持或循环等待，然后才会播出下一个 Cue。等待期间，合成器工具栏会显示带有自己 GO 按钮的保持或循环等待标记，/compositor/release 也能通过 OSC 做到同样的事。手动移动播放头会结束保持，并重新启用其后的标记。

---

第 16 节Live Deck

在运行中的合成之上，一个由你实时触发的预先准备片段组成的网格。每个槽位*做什么*（来源、屏幕、淡变、效果、音频）在准备阶段确定；*何时*触发由你决定。每次触发都会被记录，彩排可以烘焙到时间线上，让它完全重现。

Deck 位于一个合成 Cue 中（在播放列表中选择添加组 ▾ → 添加合成）：当该 Cue 在节目上时，Deck 处于实时状态（否则标题区会显示不在节目中）。播出一个非合成 Cue 时，Deck 会和合成器一起停止。

网格

在底部面板中打开 Live Deck 标签页。可以从创建 3 × 4 的 Deck 开始，也可以自己添加 + 行和 + Look。

• 行是图层，叠在时间线之上——最上面的行在最前。每一行一次播放一个槽位。
• Look 是列。 点按某个 Look 的列头，即可一次触发该列中每一行的槽位。
• 底部的时间线行用于切换下方的时间线（见下文）。

填充单元格。 从媒体浏览器把任何内容拖到单元格上——文件、摄像机、NDI、Syphon、生成器。点按槽位可在"片段"标签页中编辑它；连按（或点按 ▶）可触发它；拖动可移动它，按住 ⌥ 拖动可拷贝它。右键点按可使用触发、循环、剪切、拷贝、粘贴、复制和删除；拷贝和粘贴在 Deck 与时间线之间双向可用。正在播出的槽位不能删除、不能被粘贴覆盖，也不能移到另一行。

读懂网格。 摄像机、NDI、Syphon 和字幕条的单元格会显示实时画面，文件则显示一张海报帧，播出后会切换为播放画面。

行头上有行的名称和编号、×（将其撤下）、一个可控制不透明度、音量或混合的推子——用红、绿、紫圆点选择——以及 B（旁通）；参见 §14。V 形箭头可把一行折叠成一条显示槽位名称的细条；⋯ → 折叠所有行 / 展开所有行作用于全部行。右键点按行头可重命名、在堆叠中上移或下移、旁通、清空或删除该行。右键点按 Look 列头可重命名、删除它，或设置清空此处没有槽位的行（之后触发该 Look 时，会清空在这一列中没有内容的行）。

触发与清除

• 触发槽位会以叠化替换该行正在播放的内容：旧槽位保持全强度，直到新槽位淡入完成（即新槽位的淡入时长）。
• 清除——点按行的 ×，或标题区的全部清除——会撤下槽位，每个都使用自己的淡出。
• 每个已触发的槽位从被触发的那一刻起都按自己的时钟运行，所以它的淡变从你按下按钮时开始。暂停或停止时间线不会停止已触发的槽位。
• Deck 中的每个来源都会在合成开始时打开，因此触发时绝不会等待文件或摄像机。

槽位行为

选择一个槽位；"片段"标签页的播放区块中有：

结束按钮。 每个会播放到结尾的槽位——文件、图像序列或循环时间线——都会在画面上以圆形按钮显示其结束方式，颜色与播放列表一致：🔵 ↻ 循环、🟠 ⏸ 保持、🟢 → 下一个、🔴 ← 上一个、⚪ ✕ 清除。点按它可切换到下一种结束方式（保持 → 循环 → 下一个 → 上一个 → 清除）；右键点按可直接选择。折叠的行会在槽位名称旁显示一个小一些的按钮。摄像机、NDI、Syphon、静态图片、生成器和标题会一直播放到该行被清除，因此没有结束方式。

时间线行

底部这一行决定在 Deck 下方播放哪条时间线。每个 Look 下方的单元格中放着主线或你的某条循环时间线。触发该 Look——或单元格本身——会把播放头切换到那条时间线的开头。一次只播放一条；没有时间线单元格的 Look 会让当前时间线继续运行。每次播出都从主线开始。

右键点按时间线单元格可设置：

• 时间线 ▸ — 主线或某个循环
• 过渡 ▸ — 切换，或淡变 0.5 s / 1.0 s / 2.0 s（旧时间线在新时间线下方保持全强度——是叠化，而不是经黑场）
• 开始 ▸ — 触发时或在下一个标记处
• 结束时 ▸（循环）— 循环、保持最后一帧、返回上一条时间线或下一个 Look 的时间线。主线的结束方式与它的 Cue 相同；这一行上的循环永远不会结束 Cue。

循环播放期间，主线的时间线标签页会显示提示——此时播放头度量的是循环，而不是主线。

播放控制

Deck 的标题区有自己的播放控制：回到开头、上一个 / 下一个标记、播放 / 暂停、停止、循环、时间码，以及用于保持和循环等待的 GO 标记。合成被播出后，它控制节目 Cue；否则控制编辑器的预览。

显示 Live Deck 标签页时：Space 播放 / 暂停，↑ / ↓ 跳到上一个 / 下一个标记，⌘C ⌘V ⌘D ⌫ 拷贝、粘贴、复制和删除所选槽位。

触发日志与烘焙到时间线

每一次触发、清除和时间线切换都会按时间线时间码记录下来，并按播出分组（从播出合成开始，到它停止或再次被播出为止）。

• 窗口 → Live Deck 触发日志（或 ⋯ → 显示触发日志）会列出各次播出。可以烘焙任意一次播出、把日志导出为 CSV，或清空日志。
• ⋯ → 将最近一次播出烘焙到时间线会把最近一次播出变成放在现有轨道前面的时间线轨道——每个用过的行一条轨道，并带上该行的主控、旁通、组和输出。每次触发都会变成一个片段，持续到该行中下一次触发或清除为止，因此演出会完全按当时的操作重现。一步撤销即可移除。

外部控制

• OSC — /deck/look/{n}/go、/deck/row/{r}/slot/{n}/go、/deck/row/{r}/clear、/deck/clear 和 /deck/timeline/{n}/go（§22）。
• Companion — ⋯ → 导出 Companion 页面… 会为当前 Deck 生成一个 Bitfocus Companion 页面：顶部是各个 Look 和"全部清除"，每个 Deck 行一排槽位按钮和一个清除按钮，最下面一排是时间线行（§26）。这些按钮会根据 Deck 亮灯：槽位、Look 或时间线单元格播出时为绿色，待命等待下一个标记时为琥珀色——这样你就能在 Stream Deck 上操作 Deck，而不必回头看 Mac（需开启 OSC 状态反馈）。
• 备份机会跟随 Deck——参见 §29。

---

通过标题栏中的高级…、控制 → Output Patch Bay…（⌘⇧M），或合成器"画布"标签页中的打开 Output Patch Bay… 打开。

一个窗口，管理像素去向的一切。

布局与控件

• 标题区 — 画布分辨率、帧率、输出数量，以及打开输出窗口 / 关闭输出窗口按钮。
• 快捷操作 — 显示测试卡 · 跨输出拼接（在多屏墙上自动平铺） · 边缘融合 · 帧率 · 范围。
• 帧率 — 舞台渲染以及向每个输出供给画面的速率，随项目存储。请与输出匹配：以其他速率驱动 59.94 的 SDI 信号或 50 Hz 投影机，会丢帧或重复帧。自动（默认）在有输出送到 DeckLink 时跟随 DeckLink，否则跟随第一个输出所在屏幕的刷新率（120 Hz 屏幕会让演出以 60 运行）。选择 23.976 到 60 可自行设定。DeckLink 始终按它自己的 SDI 模式帧率供给。当某个输出的屏幕以演出帧率或其整数倍刷新时（60 fps 演出配 60 Hz 投影机），帧会对齐到该屏幕的刷新，因此每一帧都只显示一次，不会偶尔把某一帧显示两次；使用 DeckLink 时，或没有这样的屏幕时，舞台使用自己的时钟。
• 范围 — 演出的动态范围，SDR（默认）或 HDR，随项目存储。无论哪种，HDR 视频（HDR10 / PQ 和 HLG 文件）都会以完整范围读取。
  • SDR： HDR 视频会转换为标准范围——参考白接近白色，更亮的高光被平滑压下——因此能自然地与其他素材放在一起。
  • HDR： HDR 视频保留高光，能显示 HDR 的屏幕（MacBook Pro 的 XDR 显示屏，或在"系统设置 ▸ 显示器"中开启 HDR 的 HDR 显示器）上的输出窗口会把它们显示得比白色更亮。在其他屏幕上，高光止于白色。没有任何输出屏幕能显示 HDR 时，会出现警告标志。
  • 其他一切——摄像机、NDI 和 Syphon 输入、标准视频、HAP、图像序列、文字、抠像、调色和淡变——在两种范围下看起来都一样。
  • Syphon、NDI 和 DeckLink 输出保持标准范围：在 HDR 演出中，它们上面的高光会在白色处被削掉。
• 实时画布 — 交互式主画布，可拖动定位和拖动做梯形校正。带有标签、融合重叠区、网格和吸附开关。
• 输出检查器（右）：
  • 名称与输出 — 这个输出驱动什么：物理显示器、虚拟显示器、NDI、Syphon 或 BMD SDI / DeckLink。任意数量的输出都可以是 NDI，每个都是独立的流（§20）；Syphon 和 DeckLink 各占一个输出。
  • 格式、信号与方向 — 输出自己的分辨率、Full Composite / Fill / Key 信号，以及 0°–270° 旋转。
  • 屏幕适配与缩放 — 适应、填充、拉伸、自定，外加实时分辨率 HUD。
  • 四角梯形校正与对齐 — 带 X/Y 滑块的角点变形。
  • 网格变形 — 一组点构成的网格，用来把这个输出弯曲贴合到弧形、不平或异形屏幕上。
  • 遮罩 — 柔边形状，用来遮住布景，或把非矩形屏幕裁成它的形状。
  • 边缘融合 — 重叠区的柔边融合遮罩。
  • 测试图与测试音发生器 — 24 种测试卡和音频测试音发生器。
• 输出条（底部） — 每个输出都显示为一个交互式标签，带有分辨率和目标，外加添加输出（最多八个；更多时请使用"画布"标签页中的视频墙网格，它会把输出按行排列）。

---

第 18 节四角梯形校正、边缘融合与视频墙

四角梯形校正

可在任意输出上开启四角梯形校正：

• 交互式角点： 直接在画布网格上拖动角点手柄。
• 数值精调： 用左上（X, Y）、右上（X, Y）、左下（X, Y）和右下（X, Y）滑块微调。
• 重置所有角： 一键让输出恢复为完美的矩形。
• 在透视和贝塞尔两种变形算法之间选择。

网格变形

当四个角无法贴合屏幕时——弧形墙、圆柱、非矩形的 LED 造型——就用网格来变形输出。在 Output Patch Bay 中选择该输出，并在网格变形卡片中打开用网格对此输出进行变形：

• 在画布预览上拖动这些点，把画面弯曲贴合到屏幕上。吸附会像对梯形校正角点那样，把它们对齐到对齐网格。
• 列和行用于设置网格，从 2 × 2 到 8 × 8。增加点数会保留你已经做好的形状。
• 重置会把每个点恢复到平整的网格上。

每个输出都有自己的网格，随项目存储。梯形校正的角点仍然叠加在它之上起作用，边缘融合、裁切和屏幕适配也照常工作——无论是在屏幕上，还是在 NDI、Syphon 和 DeckLink 上。

遮罩

遮罩会把输出的一部分遮黑——屏幕前的布景、一扇门、异形 LED 墙的边缘。在 Output Patch Bay 中选择该输出，并在遮罩卡片中点按添加遮罩。它一开始是位于中间的矩形；在画布预览上拖动它的角来塑形，点按 ＋ 可在最长边的中点添加一个点，用于做曲线和异形。

• 羽化会柔化边缘，最多为输出宽度的 15%。
• 遮黑外部的一切只保留内部——用来把屏幕裁成它的形状。这类遮罩以虚线轮廓显示。
• 每个遮罩都可以重命名、关闭或删除，一个输出可以有任意多个遮罩。

遮罩位于输出本身上，在网格变形和梯形校正之后，因此无论画面如何变化，它们都固定在屏幕上。遮罩随项目存储，在屏幕、NDI、Syphon 和 DeckLink 上都同样生效。

柔边融合

边缘融合默认关闭，除非项目将它打开——新项目或没有它而存储的项目，绝不会继承上一场演出的融合设置。对于互相重叠的投影机，打开边缘融合，并设置左、右、上、下的重叠遮罩。SimplePlay Pro X 会生成经过伽马校正的融合渐变，让投影机重叠处的接缝消失。在画布视图中打开融合重叠区，即可看到高亮显示的重叠区域。

视频墙配方

1. 把主画布设为整面墙的完整分辨率（例如三台 1080p 投影机为 5760 × 1080）。
2. 每台投影机添加一个输出。
3. 点按跨输出拼接自动切分画布。
4. 逐个调整每个输出的梯形校正，直到测试网格与实际投影面完全对齐。
5. 调好边缘融合遮罩。
6. 存储项目（⌘S）——所有几何设置都保存在 .sppx 文件中。

---

第 19 节即时测试图与广播测试音发生器

24 种广播测试图

• 动画： 添加移动的扫描线和时钟，用于发现丢帧、画面撕裂和监视器延迟。
• Monoscope 横幅： 输入自定横幅文字（例如 PSP Ventures、场馆名或客户名），即可立即为你的监看屏打上标识。

广播音频测试音发生器

• 参考音： 400 Hz 正弦波、1 kHz 正弦波、5 kHz 正弦波
• 扫频： 20 Hz–20 kHz、1 kHz–10 kHz
• 噪声类型： 粉红噪声、白噪声、布朗噪声
• 校准电平： −18 EBU、−20 SMPTE、−12 dB、−6 dB
• 通道路由： L+R、仅左、仅右、左右交替

---

第 20 节NDI、Syphon 与 DeckLink SDI

NDI® 输出

Output Patch Bay 中的任何输出都可以是一个 NDI 流——要多少有多少，每个都是网络上独立的源。在 Patch Bay 中选择一个输出，把输出：设为 NDI。它的检查器随后会显示：

• 流 — 接收端看到的名称，形式为 COMPUTER (name)。每个 NDI 输出一开始都会得到一个唯一的名称（例如 SimplePlay Pro X - Output 3）；输入你自己的名称并按 Return。名称不能重复——重名时会加上数字。
• 帧率 — 23.976 到 60 fps，会通告给接收端（59.94 及其他 NTSC 帧率以精确分数表示）。
• 发送节目音频 — 只在第一个 NDI 输出上打开，这样同时接收多路信号的接收端只会听到一次演出声音。任何需要带音频的流都可以打开它。
• 一个状态点——在网络上，或不在网络上 — 正在重试（流断开时 App 会不断重试，并在错误抽屉中告诉你）。

每个流承载它的输出所对应的那部分舞台，经过与物理屏幕相同的梯形校正、融合和适配，以输出自己的格式分辨率发送。配合图层输出，就意味着每个流对应一条轨道或一个 Live Deck 行：把轨道 1 送到输出 1、轨道 2 送到输出 2，每个 NDI 流就只承载它的图层。

设置 → NDI 输出会列出每个流，以及它的输出、尺寸、帧率、音频和是否在网络上。设置在各个输出上进行，而不是在这里。

NDI 发现机制与网络设置：

• 本地网络（mDNS/Bonjour）： NDI 默认在 UDP 端口 5353 上使用 mDNS（组播 DNS）自动发现对端。macOS 要求 SimplePlay Pro X 具有本地网络访问权限（首次启动时会询问，也可在*系统设置 → 隐私与安全性 → 本地网络*中设置）。
• 子网与企业网络： 没有 mDNS 反射时，组播流量不会穿过路由器或 VLAN 边界。对于跨越多个子网、或使用关闭了 IGMP/组播过滤的网管交换机的制作环境，请配置 NDI Discovery Server（使用免费工具 NDI Access Manager）。在 SimplePlay Pro X 所在的机器和各接收机器上，都在 NDI Access Manager 中设置 Discovery Server 的 IP。
• 防火墙： 确保 macOS 应用程序防火墙和场馆网络防火墙放行 TCP 端口范围 5960-5969（NDI 发现/消息）以及动态的 UDP/TCP 帧传输端口。

Syphon

在 macOS App 之间本地零拷贝共享 GPU 纹理。在 Patch Bay 中把某个输出的输出：设为 Syphon，SimplePlay Pro X 就会把该输出的画面作为 Syphon 服务器发布。

Blackmagic DeckLink SDI 播出

硬件 SDI 播出，为广播切换台（Ross、Grass Valley、ATEM）支持 Key + Fill。播出特性：

1. 双缓冲的帧提交。
2. IOKit 电源断言，防止显示器和系统睡眠。
3. 帧心跳看门狗，1.2 秒自动重连。
4. 帧在专用线程上送往板卡，因此界面再忙也不会拖住 SDI。

SDI 输出模式（Output Patch Bay ▸ DeckLink SDI 输出模式）设定板卡发送的信号：

列表会标出板卡声明无法输出的模式，选择这样的模式会显示警告；在板卡拒绝的模式下输出不会启动，并会说明原因。演出的帧率为自动时，演出按 SDI 模式的帧率渲染（1080p50 和 1080i50 分别让演出以每秒 50 帧和 25 帧运行）。在 PAL 地区（英国、欧洲、澳大利亚和亚洲大部分地区）请使用 50 Hz 模式。

---

全程 32 位浮点音频处理。

输出设备与故障切换

设置 → 音频输出用于选择硬件接口。

• 自动 （默认） 选择内建输出——MacBook 或 iMac 的扬声器，Mac mini、Studio 或 Pro 的耳机接口。它绝不会选择蓝牙（AirPods）、AirPlay 或虚拟设备，因此手机配对耳机时不会把演出声音抢过去。选择器中显示为 自动 — 设备名称。
• 直连硬件把播出固定在所选接口上。这个选择按设备本身记住，因此重启和重新插拔后仍然有效；启动时未接入的接口会显示为 未连接，而不会报警。
• 自动故障切换在演出中途 Thunderbolt 线缆或 USB 接口断开时，自动切换到内建音频，并立即提醒操作员。

8 段参数均衡器

每个 Cue 的图示或参数均衡器（64 Hz 到 8 kHz，±12 dB）。

Dante 与多通道 AoIP

通过 CoreAudio 直接把多通道路由到 Dante Virtual Soundcard (DVS)、Dante PCIe 卡和 AES67 接口，无需专有的授权后台程序。

---

在设置 → OSC / UDP 控制中启用。默认 UDP 端口 53000（反馈在端口 53001）。

常用地址

• /simpleplay/take · /go · /take — 触发所选 Cue
• /simpleplay/go/{cueID} — 按 ID、编号或小数触发 Cue（例如 /simpleplay/go/1.5）
• /simpleplay/select/{cueID} — 在播放列表中选择 Cue，但不上节目
• /simpleplay/stop · /stop — 停止 Cue 或紧急停止
• /simpleplay/endall — 紧急：结束所有正在进行的播放
• /simpleplay/stop/selected — 只停止当前所选的 Cue
• /simpleplay/blackout · /ftb · /freeze · /mute（0 / 1 / 切换）
• /simpleplay/autoplay（0 / 1 / 切换）— Auto Play 自动推进 Cue
• /simpleplay/projectoutput（0 / 1 / 切换）— 打开 / 关闭项目输出窗口
• /simpleplay/preview/play — 播放 / 暂停预览播放器（与空格键相同）
• /simpleplay/volume（0.0–1.0）
• /compositor/play · /compositor/pause · /compositor/stop
• /compositor/release — 释放合成正在等待的 Hold 或 Vamp 标记（GO 的作用相同）
• Live Deck（Look 从 1 开始从左往右数；行从 1 开始从堆栈底部往上数）：
  • /deck/look/{n}/go — 触发 Look n 中的所有槽位
  • /deck/row/{r}/slot/{n}/go — 触发一个槽位
  • /deck/row/{r}/clear · /deck/clear — 让一行或所有行下节目
  • /deck/timeline/{n}/go — 切换到 Look n 下方时间线行中的单元格
• Cue 地址：/cue/{cueNumber}/go、/cue/selected/go、/cue/{cueNumber}/stop、/cue/{cueNumber}/pause、/cue/{cueNumber}/resume
• 自动继续与串联：
  • /cue/{cueNumber}/autoContinue（0 / 1 / 切换）— 切换或设置片段结束时的自动继续
  • /cue/{cueNumber}/continueMode（0 = 无，1 = 向下自动继续，2 = 向上自动跟随，3 = 循环回第一个）

---

第 23 节MIDI 与 MIDI 映射

设置 → MIDI 控制。

可视化 MIDI 学习模式

点按标题栏中的 MIDI 映射，点按一个高亮的控件，然后按一下 MIDI 控制器上的打击垫或按钮——要映射推子，就转动一个旋钮或推子。完成。在播放列表中：播出、停止、Blackout、FTB、Freeze、静音以及每个 Cue。在 Stage Compositor 中：Live Deck 的槽位、Look 和时间线行单元格、每一行的清除按钮和全部清除；每一行的推子（旋钮跟随该行圆点所选的主控：不透明度、音量或混合）；以及走带——播放/暂停、停止、上一个和下一个标记，以及在 Hold 或 Vamp 处的 GO。Deck 打击垫按位置（第 2 行、第 3 个 Look）记录，编号与 Deck 的 OSC 地址相同，因此控制器设置一次即可用于所有演出。

---

第 24 节LTC 与 MTC 时间码

• LTC： 从任意音频输入通道实时解码（24、25、29.97、30 fps）。在设置 ▸ 时间码输入中，选择设备、承载时间码的输入通道（对有多个通道的接口而言）以及帧率。输入电平表显示电平：时间码在大约 −20 到 −6 dBFS 之间读取效果最好，削波时电平表会变成橙色。如果时间码没有锁定，面板会说明是没有音频进来，还是进来的音频不是时间码——通常是通道或帧率选错了。
• MTC： 解码 MIDI 时间码的四分之一帧和 SysEx 全帧。
• 模式： 触发模式（在某个时间码地址触发 Cue）和追随模式（持续锁定时间线）。

时间码输出

SimplePlay Pro X 也可以当时钟：设置 → 时间码 → 时间码输出会发送跟随节目内容的时间码，让灯光台、声音服务器或烟火控制器追随演出。

• 跟随什么： 视频 Cue 中的位置、合成 Cue 中的时间线，或合成器模式下的 Stage Compositor 演出。每个 Cue 开始时发送开始时间（例如 01:00:00:00），随后随 Cue 播放从这里往上计时。播放暂停或停止时时间码停止，播放头跳转（新的 Cue、定位、切换时间线）时时间码也跳转。
• 帧率： 24、25、29.97 丢帧或 30 fps，两种输出通用。
• LTC： 作为音频在任意输出设备的一个通道上发送（音频接口的空闲通道，或 Dante 通道），电平由你选择。该设备的其他通道保持静音。设备拔下再插回后，LTC 会自行重新开始。
• MTC： 发送到任意 MIDI 目标：播放时每帧四条四分之一帧消息；开始、跳转或在暂停时被移动时发送一条全帧消息。
• 输出时间码显示此刻正在发送的内容。

这些设置随项目存储。在 Stage Sync 配对中只有主机发送。

---

第 25 节Art-Net / DMX

设置 → DMX 控制。标准 UDP 端口 6454。把收到的 DMX512 通道（1–512）映射到播出操作，或直接从灯光台学习通道。

DMX 输出

控制 Cue 和 Send 标记也可以自己设定灯光电平——演出开始时观众席灯调到一半，某一场打开烟机，结尾全黑——只需一条 DMX 消息（见控制 Cue 与 Send 标记）。

• 电平会从通道当前的值开始，在消息的淡变时间内淡变（0 为直接跳变）。之后发往同一通道的消息会从淡变已到达的位置接手。
• 消息涉及的每个 universe 都会通过 Art-Net（UDP 6454）以完整的 512 个通道发送：变化时每秒 40 次，否则每秒一次，好让节点保持住。电平会保持，直到另一条消息改变它们。
• 设置 → DMX 控制 → DMX 输出显示正在发送的内容；全部释放停止发送。打开另一个项目或新建项目也会释放。之后灯具怎么表现取决于节点（多数保持最后的电平或淡出）。
• 没有消息设置过的通道以 0 发送。如果灯光台也在发送同一个 universe，请把节点设为取最高值（HTP）合并，或给演出单独一个 universe。
• universe 就是 Art-Net 的 Port-Address（0–32767），编号方式与 Art-Net 输入相同。SimplePlay Pro X 自己的 Art-Net 输入会忽略它自己发出的内容，因此 DMX Cue 不会触发自身的 DMX 映射。
• 在 Stage Sync 配对中只有主机发送。

---

第 26 节Bitfocus Companion 与 Stream Deck

适用于 Bitfocus Companion 的官方原生模块（companion-module-simpleplay-prox），通过 OSC 提供双向控制、实时状态反馈和 Stream Deck 按钮预设。

安装与设置

1. 安装模块：
   • 从 Companion 目录安装（即将推出）： SimplePlay Pro X 即将上架 Bitfocus 官方目录。在此之前，请使用下面的直接安装包。
   • 直接安装包： 下载 companion-module-simpleplay-prox.zip，解压到：

`` ~/Library/Application Support/companion/modules/ ``

里面应该会有一个 companion-module-simpleplay-prox 文件夹。退出并重新打开 Companion——它只在启动时扫描模块。之后添加连接时就会出现这个模块。（已在 Companion 5.0.4 上验证。）

1. 网络连接：
   • 在 SimplePlay Pro X 中启用 OSC 服务器（控制 → 外部控制输入，默认端口 53000）。
   • 启用 OSC 状态反馈，目标为 Companion 的监听端口（53001）。
   • 在 Companion 中，把模块的目标 IP 指向运行 SimplePlay Pro X 的 Mac。状态变为绿色（OK）。

动作、反馈与变量

• 动作： 触发当前 Cue（Take/GO）、按编号/小数触发 Cue（例如 1、1.5、2.0）、全部结束 / 紧急停止、停止所选 Cue、预览播放 / 暂停、Blackout、FTB、Freeze、静音、Auto Play、项目输出、演出锁定开关，以及 Stage Compositor 走带控制。
• 反馈： 实时彩色 Tally：播放中（绿）、已暂停（琥珀）、Blackout/FTB/Freeze（红）、静音、Auto Play、项目输出、预览播放中，以及演出模式已锁定（黄）。

• Live Deck 页面： 在合成器的 Live Deck 中，⋯ → 导出 Companion 页面… 会为当前 Deck 存储一个现成的 Companion 页面——顶部是各个 Look 的按钮和"全部清除"，每个 Deck 行一排槽位按钮（加上"清除"），底部是时间线行。一页可容纳七个 Look 和三行。按钮在其槽位、Look 或时间线单元格上节目时亮绿色，在等待下一个标记开始时亮琥珀色；请打开 OSC 状态反馈，让 Companion 收到 Deck 的状态。
• 变量：
  • $(companion-module-simpleplay-prox:current_cue_name)
  • $(companion-module-simpleplay-prox:time_remaining)
  • $(companion-module-simpleplay-prox:is_playing)
  • $(companion-module-simpleplay-prox:show_mode_locked)

---

原生 Stream Deck 插件

一个专用的 Elgato Stream Deck 插件，独立于上面的 Companion 模块。如果你想让 Stream Deck 不经过 Companion、直接与 SimplePlay Pro X 通信，就用它。

安装

1. 下载 com.simpleplaypro.streamdeck.streamDeckPlugin。
2. 双击它。Stream Deck 会完成安装，动作出现在 SimplePlay Pro X 类别下。
3. 在 SimplePlay Pro X 中启用 OSC 服务器（设置 → OSC / UDP 控制，端口 53000），并启用发往 127.0.0.1:53001 的 OSC 状态反馈，让按键显示实时状态。

需要 Stream Deck 6.9 或更高版本，以及 SimplePlay Pro X 1.2.0 或更高版本。

动作

让插件和 App 保持同步。 较新的按键（End All、Preview Play、Auto Play、Project Output 以及针对单个 Cue 的 Stop）调用的是 App 1.2.0 版新增的 OSC 地址。在较旧的 App 上，这些按键发出的命令没有任何响应，看起来什么也不做。

---

设置 → 监视文件夹。自动导入网络共享上新导出的媒体。

• 拷贝稳定等待： 等大视频文件写完后再导入。
• 导入动作： 追加到播放列表末尾、添加到组，或替换匹配的 Cue。

---

第 28 节会话恢复

崩溃保护会持续写入状态快照。非正常关闭后，重新启动时会提示自动恢复会话。

安全退出

关闭 App 时——Cmd+Q、窗口的关闭按钮或菜单中的退出——它会先检查你是否会丢失什么。

取消总会让你回到原来的状态——什么都不会关闭，什么都不会丢弃。

选择存储会在 App 退出*之前*把项目完整写入磁盘；如果存储失败或你取消了存储对话框，退出就会放弃，因此不会丢失任何东西。Stage Compositor 中未存储的图层也算作未存储的工作，即使播放列表本身已经存储。

---

第 29 节Stage Sync——主机/备份机冗余

通过局域网连接两套 SimplePlay Pro X。主机广播心跳；热备的备机跟随播放头，在主机信号丢失时自动接管。

备机上的 Live Deck

运行同一合成的备机会跟随主机的 Live Deck：播放相同的槽位，每个都从主机上相同的进度开始，跟随替换和清除，并一同切换时间线行。Hold 和 Vamp 也会跟随——在主机上按 GO 会释放备机的 Hold。触发和清除会立即到达备机，不必等下一次心跳。

图层的主推子属于演出文件，不在心跳中：你现场推动的主推子不会复制到备机。

世代纪元与确定性的脑裂隔离

在现场演出中，网络变化或链路中断可能导致两套设备同时以主用主机的身份广播：

• 世代纪元计数器（epoch）： 备机在故障切换中接管控制时（promoteToMaster()），会自动把世代纪元加一（epoch + 1），从而取代之前的任何主机。
• 确定性的自动隔离： 当网络分区恢复或检测到冲突时，StageSync 会比较世代纪元和选举时间戳：
  • 纪元高者胜： 新一代的设备继续担任主用主机。过时的主机会自动自我隔离（降为备机），以免演出网络上出现相互冲突的播出指令。
  • 纪元相同时： 如果两套设备纪元相同，现任主机的选举优先级（electedAt）会让已在播出的既有设备保持主机身份，而新加入的设备降为备机。
• 关于分区的说明： 在没有外部见证节点的双节点局域网拓扑中，网线被完全物理切断时，两套设备都会在本地检测到（备机开始接管；主机继续播放）。下游的硬件视频切换器（例如 Barco、Lightware 的 DVI/SDI 自动故障切换）决定实际送往显示设备的信号。网络连接恢复的那一刻，StageSync 的世代纪元机制会立即解决冲突，无需人工干预即可隔离过时的节点。
• 手动模式选项： 如果操作员更愿意手动确认，可以在设置中关闭冲突时自动隔离，保留可交互的降为备机警告横幅。

---

第 30 节重新链接媒体与项目文件

• .sppx 项目文件： 单个文件打包 Cue、裁剪、均衡器、合成器时间线、画布几何、梯形校正和接线设置。
• 4 遍重新链接引擎（⌘I）： 几秒内重新连接被移动或改名的媒体硬盘（精确 → 清理后 → 子路径 → 词干）。

---

• 通用： 主题（7 种模式）、亮度、始终置顶、预览静音、自动存储间隔，以及启用 10 位 / EDR 高动态范围渲染——演出的处理位深。关闭 （默认）：合成和输出窗口以 8 位运行，并加抖动以免渐变出现色带。打开：合成和输出使用 16 位浮点，即使来自 8 位媒体，淡变和混合也保持平滑。切换即时生效；设为自动（跟随 10 位设置）的图像序列在载入时采用它。范围为 HDR 的演出（Output Patch Bay）无论此项如何设置都以 16 位浮点合成。语言设置界面语言：与这台 Mac 相同（默认）或 App 的九种语言之一，从下次打开 App 时生效。它与 macOS 系统设置 ▸ 通用 ▸ 语言与地区 ▸ 应用程序 中该 App 的语言是同一个设置。
• Cue 默认值： 默认淡变、循环、自动播放行为、视频适配方式。
• 快捷键： 重新映射键盘快捷键。
• 监视文件夹： 监视的目录和导入规则。
• 音频输出： 设备选择（默认 自动——绝不选蓝牙）和自动故障切换。
• NDI 输出： 所有 NDI 流的状态列表。名称、帧率和音频在 Output Patch Bay 的各个输出上设置。
• OSC / MIDI / 时间码 / DMX： 协议监听与映射。

---

第 32 节键盘快捷键

以下是默认设置。任何播出、Cue 编辑或 Stage Compositor 快捷键都可以在设置 → 快捷键中更改：点按快捷键，然后按下新的组合键。如果这些按键已经属于另一个动作，它们会转给新的动作，原来的动作则不再有快捷键。每一行还有清除快捷键或恢复默认的按钮，全部恢复默认会把一切恢复原样。

存储、撤销等菜单命令在 App 中保留标准快捷键。要更改它们，请使用 macOS 的系统设置 → 键盘 → 键盘快捷键 → App 快捷键。

在文本栏中输入时、对话框或表单打开时，或设置窗口在最前面时，播出快捷键不会触发。按住某个键只触发一次动作；只有 Cue 导航（↑ / ↓）会重复。

播出与走带

Cue 编辑

导航与编辑器

Stage Compositor

以下快捷键在 Stage Compositor 模式中有效。

Live Deck

显示 Live Deck 标签页时，以下按键改为作用于 Deck：

---

第 33 节许可证

SimplePlay Pro X 通过 Lemon Squeezy 授权。

• 演示模式： 功能完整，每次会话限时 15 分钟（输出 100% 无水印）。
• 商用 Pro 授权： 解锁不限时的连续播放。
• 14 天离线宽限期： 可在与外网隔离的演出网络中运行。

更新

SimplePlay Pro X 每次打开时都会检查新版本，运行期间每天检查一次。有新版本时，标题栏下方会出现提示条：

• 新功能与安装… 会显示版本说明并安装更新。稍后 会隐藏提示条，直到下次打开 App。
• 有内容正在播出时提示条会等待，因此演出中屏幕上不会有东西移动；输出窗口打开时 App 也绝不会为了安装而重启——它会在你退出时安装。
• 所有 1.x 更新都免费。新的主版本（2.0）是付费升级：提示条会改为显示 了解更多…。
• 要自己检查：SimplePlay Pro X ▸ 检查更新…，或 设置 ▸ 关于 中的按钮。

---

第 34 节故障排除与常见问题

为什么我按了 GO，屏幕却是黑的？

检查顶部紧急控制条中的 BLACKOUT 或 FTB 是否已打开。在 Output Patch Bay 中确认你的输出已分配给一个工作中的显示器，而不是*未分配*。

为什么 DeckLink 卡已连接，却没有出现在 Output Patch Bay 中？

Blackmagic DeckLink 和 UltraStudio 设备需要在 Mac 上安装 Blackmagic Desktop Video 驱动。macOS 不包含 SDI 硬件的驱动。从 blackmagicdesign.com/support 安装 Desktop Video，在 *macOS 系统设置 → 隐私与安全性*中允许系统扩展，并在启动 SimplePlay Pro X 之前确认设备出现在 Blackmagic Desktop Video Setup 工具中。

为什么 NDI 流没有出现在接收软件或视频切换台上？

1. 检查 macOS 系统设置 → 隐私与安全性 → 本地网络，确保允许 SimplePlay Pro X 访问本地网络。
2. 确保发送和接收设备在同一 IP 子网中；如果要跨企业子网或 VLAN 工作，请通过 NDI Access Manager 配置 NDI Discovery Server。
3. 确认 UDP 端口 5353（mDNS）和 5960 起的 TCP 端口没有被 macOS 应用程序防火墙或场馆网络交换机阻止。

我把一条轨道送到了输出 2，为什么它的片段仍然覆盖整个舞台？

检查 Output Patch Bay 中的跨输出拼接是否已打开——在矩阵模式下，每个输出都显示整个画布。然后检查片段的位置区块：设为整个舞台或设了自己屏幕的片段不会跟随其轨道。"图层"标签页中的跟随图层按钮会让图层上的所有片段重新跟随它。

我建了几个 NDI 输出，为什么接收端只显示一个？

每个 NDI 输出都是独立的源——请在接收端的源列表中逐一查找各个流名称。如果某个流的状态显示不在网络上，可能这台电脑上的另一个 NDI 源已经用了这个名称；请在 Patch Bay 中给它改名。

为什么触发 Live Deck 槽位没有反应？

Deck 只在其合成 Cue 上节目时才生效——否则 Deck 标题会显示不在节目中。请先播出这个合成。设为开始方式：在下一个标记处的槽位会显示待命，等待播放头到达下一个标记。

为什么网络摄像头 / 采集卡没有出现在合成器中？

检查 macOS 系统设置 → 隐私与安全性 → 摄像头权限。在 Stage Compositor 的实时采集标签页中点按刷新，重新枚举 UVC/USB3 视频采集设备。

为什么在 8 GB 内存的 Mac 上，大型演出偶尔会卡顿？

约 7680 像素宽、带有大型 HAP 铺底和实时摄像机的舞台已接近 8 GB 的极限：当 macOS 内存不足时，演出可能短暂停顿或重复一帧。这种规模的舞台，我们建议使用 16 GB 或以上内存的 Mac。在 8 GB 的 Mac 上，演出期间请退出其他 App，并在排练后查看 Render Health。

如何校准投影机的梯形校正？

打开 Output Patch Bay（⌘⇧M），开启四角梯形校正，选择对齐网格或十字线测试图，然后直接在画布上拖动角点，直到网格在投影面上方正对齐。

获取帮助

• 帮助 ▸ 支持与反馈… 会打开一封发往 support@simpleplaypro.com 的邮件，其中已填好 App 和 macOS 的版本。我们会在一个工作日内回复。
• 演出当天，请在邮件主题开头写上 SHOW DAY：这类邮件会优先回复，周末也一样。在筹备大型演出？请提前一周来信，我们会确保届时有人可以联系。详情见帮助 ▸ 支持时间与演出当天帮助…。
• 帮助 ▸ 加入 Discord 社区…——向其他操作员提问、分享配置、了解更新。
• 帮助 ▸ 版本说明与已知问题… 会打开 simpleplaypro.com/changelog：每个版本改了什么，以及当前版本的已知问题和应对办法。刚更新过的话，演出前请看一看。

---

第 35 节附录——支持的格式

视频

.mp4 · .mov · .m4v · .mpg · .mpeg 编解码器：H.264、H.265/HEVC、ProRes（Proxy、LT、422、HQ、4444、4444 XQ）、HAP（Hap1、Hap5、HapY、HapM、HapA、Hap7）。

音频

.mp3 · .wav · .m4a · .aac · .flac · .aif · .aiff

图像与序列

.png · .jpg · .jpeg · .gif · .tiff · .bmp · .heic · .webp · .svg · .dpx · .exr · .tga

---

SimplePlay Pro X——为不容有失的演出播出而打造。

---

结语设计理念

SimplePlay Pro X 是一款面向演出的合成、播出与路由工具。它不是 VJ 乐器，这种区别是有意为之。