【插件使用】如何在Ulanzi Studio中使用vMix插件

chxdon

vMix插件用于在Ulanzi Studio中控制vMix直播制作软件。通过实体按键和旋钮，可以完成切换场景、开始/停止推流、录制、External、截图、静音控制，以及快捷执行。

一、安装UlanziStudio及vMix插件
1. 安装Ulanzi Studio
访问官网下载并安装UlanziStudio软件。

Image

2. 安装vMix插件
启动Ulanzi Studio，点击右上角的“应用商店”，搜索 vMix 并下载安装。该插件主要面向Windows环境。

Image

二、vMix准备工作
1. 访问 https://www.vmix.com/ 下载并安装vMix，免费版可试用60天。打开vMix后，建议先添加多个输入源，这样切换场景和输入源状态变化会更容易观察。

2. 拖入vMix插件动作后，插件会自动连接vMix。如果你在vMix中修改了网络控制器端口，需要同步修改插件“连接”里的端口信息，然后重新连接。

3. vMix官方功能列表可参考 https://www.vmix.com/help29/ShortcutFunctionReference.html ，参数说明可参考 https://www.vmix.com/help29/DeveloperAPI.html 。

Image

图1：vMix网络控制器端口信息。

Image

图2：vMix输入源与连接状态示例。

三、基础功能展示
1. 切换场景
将“切换场景”拖到按键上，选择某一个输入源，并选择转场效果。如果输入源列表不完整，可以点击刷新图标。按下按钮后，当前输入源会切换到输出栏，按键图标会变为选中状态。选择“预览”作为输入源时也可以实现切换，但不会显示选中图标。

2. 推流、录制、External和全屏
“开始/停止推流”“开始/停止录制”“开始/停止External”都是状态切换类动作，按下按钮即可在开始和停止之间切换。“切换全屏”会切换vMix中的全屏状态，状态会高亮或取消。

Image

图3：切换全屏状态高亮示例。

3. 截图
将“截图”拖到按键上，选择截图目标，可以选择输出或输入。文件名留空时会弹出保存窗口；填写文件名时会直接保存到对应位置。建议使用完整路径，例如 e:\\capture {0:yyyyMMdd-HHmmss}.jpg。

4. 静音/取消静音
将“静音/取消静音”拖到按键上，选择要控制的目标。该功能支持主输出、输入和总线。按下按钮后，会切换所选目标的静音状态。

5.快捷执行
快捷执行用于直接调用vMix官方快捷功能。它适合处理插件内没有单独做成按钮、但vMix API已经支持的操作。

使用时先在官方功能列表中找到想要控制的功能名称，填入“功能”字段，例如 Solo；再选择要控制的输入项；如果该功能需要参数，再按官方参数说明填写。按下按钮后，选中的输入源或vMix状态会执行对应变化。

快捷执行的核心思路是：Ulanzi按键负责触发，vMix功能名决定执行什么，输入项和参数决定作用对象与执行细节。只要功能名和参数填写正确，就可以把更多vMix快捷操作扩展到Ulanzi设备上。

6.快捷执行-旋钮
“快捷执行-旋钮”适合控制连续数值，例如音量。配置时可在“功能”中填写 SetVolume，选择要控制的输入项，在“值”中填写初始值，例如50；“步长”用于普通旋转时增减数值，例如1；“按压步长”用于按住旋转时更大幅度调整，例如10；“按下功能”可再次填写 SetVolume，用于按下旋钮时重置为设定值。

使用时，旋转旋钮会按照“值 + 步长”改变功能参数；按压旋转会按照“值 + 按压步长”调整；按下旋钮则会执行“按下功能”，把目标重置到设定值。该“值”会作为旋钮起始值，转动时会受最小值和最大值限制。

四、结语
至此，你已经学会在Ulanzi Studio中使用vMix插件。基础功能可以覆盖直播常用控制，“快捷执行”则让插件能够调用更多vMix官方快捷功能。