脚本
Macro Deck 自带将一组动作一次性构建为脚本,并在任意按键、自动化或其他脚本中运行它。
“脚本”页面上的一个脚本,包含“等待”和“按下按键 / 组合键”动作
- 在多个按键上复用同样的动作
- 为每个调用方提供各自的输入值
- 只需修改一次脚本,所有按键随之更新
- 内置且始终启用,无需任何设置
脚本内置于 Macro Deck 中,并且始终处于启用状态。它添加了 运行脚本 动作,该动作会运行你的某个脚本并等待其完成。脚本是在 脚本 页面上一次性构建的一组动作,之后可以在任意多个按键、自动化和其他脚本中运行。修改脚本后,所有运行它的地方都会使用新版本。
输入
脚本可以声明输入:调用方在运行脚本时填写的值。输入包含名称、类型(文本、数字、布尔 或 颜色)以及可选的默认值。在脚本内部可以像读取变量一样读取它,例如 {{ vars.scene }}。在 运行脚本 中选择该脚本后,其输入会以字段的形式出现在动作中,因此每个按键都可以传入自己的值。
脚本还可以标记为 在组件上运行。这样脚本中的“此组件”就会指向运行它的那个组件,因此一个脚本就能更改按下它的那个按键。
示例设置
- 一个 开始直播 脚本切换 OBS 场景、开始推流,并将面板切换到直播配置文件。不同配置文件上的三个按键通过 运行脚本 运行它。
- 一个带文本输入
scene的 切换场景 脚本,每个场景对应一个按键来运行它,各自带有自己的场景名称。 - 一个由 计划 事件触发的自动化运行与按键相同的脚本,这样既可以手动启动,也可以在设定的时间启动。
脚本也可以从其他地方运行。任何登录到 Macro Deck 的设备都可以列出并运行所有不在组件上运行的脚本,并传入自己的输入值。在 iPhone 和 iPad 上,Macro Deck Companion 可以通过快捷指令或 Siri 做到这一点。如需在另一台运行 Macro Deck 的电脑上运行脚本,请使用 Macro Deck 委托的 在另一台电脑上运行脚本。
脚本不会出现在 集成 页面上,也没有设置对话框。其 脚本 分类始终位于 添加动作 对话框中。
准备工作
- Macro Deck 3
- “脚本”页面上至少有一个脚本
设置步骤
第 1 步: 创建脚本
在侧边栏中点击 脚本,然后点击 +。在 新建脚本 对话框中输入 名称,例如 开始推流,也可以填写 描述,然后点击 创建脚本。
第 2 步: 添加动作
在 动作 选项卡中,点击 + 添加动作,按顺序添加脚本要运行的动作。完成后点击 保存更改。运行 可以立即试用已保存的脚本。
第 3 步: 如有需要,添加输入
在 输入 选项卡中,为调用方需要填写的每个值点击 添加输入。设置其 名称、类型,并可根据需要设置 默认值。在动作中以
{{ vars.<name> }}的形式使用它。点击 保存更改。第 4 步: 从按键运行脚本
在 面板 页面上,确认面板已解锁(右上角的按钮显示为 锁定),然后点击一个按键。编辑器打开时已选中 短按。点击 + 添加动作,在 添加动作 对话框左侧选择 脚本,然后选择 运行脚本。在 脚本 下选择你的脚本,并填写其输入。
第 5 步: 按下按键
点击 保存,然后按下该按键。脚本会运行,脚本完成时 运行脚本 也随之完成。
动作1
可以放在按键上,也可以在流程中运行。
- 运行脚本
- 使用输入值运行你的某个脚本,并等待其完成。
常见问题解答
需要启用脚本集成吗?
不需要。它内置于 Macro Deck 中,并且始终处于启用状态。它不会出现在 集成 页面上,运行脚本 也始终位于 添加动作 对话框中。
删除脚本后,按键会怎样?
之后它们不会执行任何操作。在删除脚本之前,Macro Deck 会告诉你哪些组件和其他脚本运行了它。
“运行脚本”为什么提示未选择脚本?
该动作在 脚本 下没有选择脚本。打开动作并选择一个即可。
可以在另一台电脑上运行脚本吗?
可以,使用 Macro Deck 委托。其 在另一台电脑上运行脚本 动作可以在另一台运行 Macro Deck 的电脑上运行脚本。
运行时会使用未保存的更改吗?
不会。运行始终使用已保存的脚本。请先点击 保存更改。
“Macro Deck”分类中的更多集成
Macro Deck Companion
Macro Deck 自带控制运行 Companion 应用的手机和平板:亮度、屏幕方向、屏幕开关和截图。
Macro Deck Delegate
Macro Deck 自带在另一台运行 Macro Deck 的电脑上运行脚本,并使用它共享的变量。
变量
Macro Deck 自带通过按键和自动化更改变量,并将任意变量写入文件。