触发器与动作

把数据中的变化变成按钮按下、切换界面、触发 Cue，或应用能做的任何事情。

触发器#

触发器监视一个 Property Path（一个数据键），并产生一个激活状态，供下游的动作和发生器跟随。

Source：Data Field（经典方式，监视一个数据键）或 Timer（按固定间隔触发）。
Event（Data Field）：On Change · On Receive · State On · State Off · On Increase · On Decrease · Equals（配合一个 Value）。On Receive 对每一条消息都触发，即使值重复（发送两次 OSC /go 就触发两次），适用于会统计到达次数的数据源（<key>.rxCount：OSC Input / Surface）；对其他数据键，它的效果和 On Change 一样。
Interval（Timer）：Manual（毫秒数）或 From Data Field（例如 beat.msToNextBeat 每拍重新触发）。触发保持稳定的节奏；错过的间隔会被跳过，不会一下子补发。
Release Delay：条件结束后触发器保持*激活*的时间（对于边沿事件 / 定时触发，则是每次触发后的时间），也就是按键时长。可以是 Manual（毫秒），或 From Data Field，例如用 beat.msToNextBeat 得到正好一拍长的按键。

右键菜单中的 Add Timer 会添加一个预设为 Timer 模式的触发器。它不需要输入连线；如果接了线，输入的数据帧会作为触发时的内容一起传出，也可以用来提供间隔值。下游的一切都和普通触发器一样：动作跟随开始 / 释放，MIDI 门控读取 trigger.active，每次触发节点会闪一下琥珀色。

触发器会把自己的状态发布到数据中，下游可以看到并映射：trigger.active（0/1）、trigger.value、trigger.fireCount。

动作#

动作在为它提供输入的触发器触发时运行。类别如下：

CDJ Transport / Hot Cues / Loops / Beat Jump：按下 CDJ 上的按钮。
- Deck：Auto (from data) 使用输入数据中的 device.number，或选择 1–6。
- On Release：Same as action 会松开按钮（真实的松开），或选 None，或另一个动作。这样就能实现推子启动：推子上的 State-On 触发器按住 Cue；推子拉下 → Cue 松开。
CDJ Settings：Write Player Setting：通过网络设置播放器约 40 项设置中的任意一项（quantize、master tempo、速度范围、jog 模式、beat jump 长度、亮度……）。当前值在 setting.* 数据键中。
Routing：Set Router Input（选择目标路由器和输入）或 Recall Matrix Preset（选择目标矩阵和预设）。
Mixer：Write Utility Setting：设置一项 DJM 设置（util.*）。
Application：整个应用都可以作为动作使用，所以你能点击的任何东西都可以由触发器触发，从而映射到 OSC、MIDI、Stream Deck、GPI 触点或时间线上的 Cue。动作弹出菜单把这些分组显示为子菜单（这一行会显示为例如 Screens › Live）：
- Feedback：Beep · Flash Screen（颜色、渐变、亮度）· Notify · Log Message。（用旧的平铺名称保存的演出在载入时会自动转换；旧的 Open Settings Window 变成了 Screens › Utility，即 Utility 界面，而不是单独的窗口。）
- Screens：Menu · Patch · Viewer · Live · Master · Program (Schedule)（和顶部栏一样：回到上次的 Program 面板）· Catalog (Track List) · Set List · Cue List · Cue Editor（上次编辑的曲目）· Cue Editor (Deck's Track)（Player：那台播放器上载入的 Catalog 曲目）· Data Play Log · Data Insights · Data Mixer · Utility（Page：打开某个设置页面，例如 Audio 或 Web Server）· Back（后退一步，和 BACK 按钮一样）· System Check · Kiosk (Hide Menu Bar + Dock) Toggle。电脑锁定时，界面动作会被拒绝。
- Players（内部播放器，即设为 Internal 的 Device 节点；Player 1–6 或 Auto (from data)）：Play · Pause · Play / Pause · Stop (Back to Start) · Jump to Start（继续播放）· Tempo Reset · Load Track（Track：一个 Catalog 曲名；会像 "Load on Player" 一样把播放器切换为 Internal）· Eject (Back to Link)。
- Set List：Select Set（Set）· Listen (Play the Set) · Rehearse (Fire Cues)（两者都从当前 Set 的 From Track # 开始，使用播放器 7 / 8，和 Set List 的 LISTEN / REHEARSE 完全一样）· Skip to Transition · Stop Listen or Rehearse。
- Automation：Bypass Deck Toggle / On / Off 和 Solo Deck Toggle（Master 轨道上的 B / S 按钮；Deck 1–8 或 Smart Cues）· Clear All Solos · Cue Caller On / Off / Toggle（Audio 设置）· Cue Caller Mute Deck Toggle · Marker In N Seconds · Marker At Clock Time（HH:MM 或 HH:MM:SS）· Marker Clear（Master 上的蓝色标记）。
- System：E-STOP Engage / Release / Toggle（只作用于本机，永远不会通过 SK Network 发送；在被接管的电脑上，动作可以启动 E-STOP 但不能解除，只有那台电脑自己的按钮可以）· Lock Machine · Unlock Machine · Lock Toggle（Ctrl+Esc 锁定）· Save Show（只保存已经有文件的演出，从不弹出对话框）· Set App Setting（Key + Value，例如 viewer.zoom = 8）· Open Web Viewer。
- Nodes + Outputs（Node：按名字选择任意节点）：Enable Output · Disable Output · Enable Output Toggle（输出节点的 Enabled 开关，例如 OSD、Art-Net、MIDI 节点）· Bypass On / Off / Toggle · Stop · Resume (Unstop) · Fire (Test Button)（节点的 ▶）· Set Parameter（Key + Value，例如 gen.osd_text = DOORS IN 5）。
Set App Setting 和 Set Parameter 经过与 REST API 相同的检查（PUT /settings/{key}、PUT /nodes/{id}/params/{key}）：数字会被限制在范围内，选项必须与某个选项一致，开 / 关 = true / false，web.* 不能用这种方式修改。Value 会用输入数据填入 $VARIABLES。被拒绝的动作会在节点上用红色显示原因。

把动作映射到 OSC（MIDI Controller、Stream Deck、Hotkeys、Serial GPI 也是同样的思路）：添加一个 OSC Input（Add Source → OSC），打开它的 KEYS 抽屉，+ Add Key → 选择地址（或 Learn / Type Address…）。你会进入节点内部，并且已经有一个 Trigger 在监视这个地址。添加一个 Action 节点，把触发器接上去，把 Category 设为 Application，然后从子菜单中选择动作（例如 Screens › Live）。已保存的演出可以继续使用：最初的四个 Application 动作保留了原来的名字。

▶ 按钮像真实的瞬时按键一样测试动作（按住 = 保持按下）。

动作会向下游发布 action.active / action.name。