简体中文 繁體中文 English 日本語 Deutsch 한국 사람 بالعربية TÜRKÇE português คนไทย Français

Ulanzi Studio

 找回密码
 立即注册
查看: 109|回复: 6

【插件教程】如何在Ulanzi Studio里使用Companion插件

[复制链接]

45

主题

47

回帖

396

积分

管理员

积分
396
发表于 2025-8-27 14:57:21 | 显示全部楼层 |阅读模式
如何在Ulanzi Studio里使用Companion插件


介绍
       Companion 插件是一款功能强大的效率工具,专为直播、音视频制作和现场活动控制而设计。它能让您通过 Ulanzi Studio 宏键盘,无缝控制由 Companion 软件管理的各种直播、音视频软件和硬件。Companion 本身是一款开源软件,支持大量设备和程序,例如视频切换台、媒体播放器(如 VLC)、演示软件等。通过此插件,您可以将复杂的多设备协作指令固化为实体按键,无论是专业的直播导播,还是复杂的演示控制,都能实现一键触发,极大提升您的工作效率和专业度。

该插件的核心功能是:
1. 触发 Companion 按钮 (Button): 将 Ulanzi Studio 的实体按键映射到 Companion 网页界面中配置的任何一个虚拟按钮,从而执行该按钮预设的一系列复杂操作。
  
适用人群:
- 主播与内容创作者:在直播时,一键切换机位、播放媒体文件、控制音量,无需离开直播软件。
- 现场活动导播:通过实体按键精准控制视频切换台、灯光系统和音频混合器。
- 远程会议与教育工作者:在演示或教学时,轻松控制演示文稿、播放视频案例,并管理音频设备。
- 系统集成商与技术爱好者:打造高度定制化的控制面板,联动多个软件与硬件,实现自动化工作流。
  
使用价值:
- 极致效率:将控制多个不同软件、硬件的复杂流程简化为一键操作。
- 强大兼容性:借助 Companion 强大的生态,可控制市面上数百种专业的音视频及直播设备。
- 高度定制:在 Companion 中自由设计按钮布局和功能,并在 Ulanzi Studio 中进行映射,打造个性化控制台。
- 稳定可靠:开源社区驱动,经过广泛验证,确保指令传输的稳定与精确。
  
学习目标
- 掌握 Companion 软件的下载、安装与启动流程。
- 学会如何在 Companion 中添加并连接一个第三方应用(以 VLC 为例)。
- 能够独立在 Companion 的网页界面中创建控制按钮,并配置相应动作。
- 熟练在 Ulanzi Studio 中安装 Companion 插件,并将实体按键成功链接到 Companion 中设置的按钮。
  
操作步骤
第一步:下载并运行 Companion
这是让您的控制中心运转起来的基础。
1. 访问官网:前往
Companion 官网 (bitfocus.io/companion),根据您的操作系统(Windows, macOS, Linux)下载对应的版本。
2. 安装与启动:下载并安装软件。启动后,会出现一个小程序窗口。
3. 打开控制界面:点击该窗口上的 “Launch GUI” 按钮。您的默认浏览器将自动打开 Companion 的网页控制界面,所有配置都将在这里完成。
  
第二步:在 Companion 中连接您的设备/软件 (以 VLC 为例)
这是让 Companion 能“指挥”其他应用的关键。
1. 配置目标应用 (VLC):
  - 打开 VLC 播放器,进入“设置”。
  - 找到并勾选“启用 HTTP web 界面”选项。
  - 为它设置一个密码,以便安全连接。
  - 保存设置并重启 VLC,使其生效。
2. 在 Companion 中添加连接:
  - 返回 Companion 的网页界面,点击顶部的 “Connections” 选项卡。
  - 在 “Add connection” 搜索框中输入 “VLC”,找到 “Videolan VLC” 模块并点击 “Add”。
  - 在右侧弹出的配置页面中,填入您刚才在 VLC 中设置的密码。
  - 点击 “Save”。当 Status 显示为绿色的“OK”时,代表 Companion 已成功连接到 VLC。
   
第三步:在 Companion 中创建控制按键
现在,您可以设计虚拟控制面板了。
1. 进入按钮编辑页:点击顶部导航栏的 “Buttons” 选项卡。
2. 使用预设模板(可选):
  - 在右侧的 “Presets” 中,您可以找到许多常用连接(如 VLC)的预设按钮。
  - 直接将如“暂停/播放”、“全屏”等预设按钮拖拽到左侧的虚拟按钮网格中即可使用。
3. 手动创建按钮:
  - 点击网格中任意一个空白格子。
  - 在下方的 “Press actions” 区域,点击 “+ Add press action”。
  - 在弹出的列表中选择您要控制的连接(例如 “VLC”),然后选择具体动作(例如 “Set Volume”)。
  - 根据提示配置该动作的参数,例如输入您想要的音量值。
   
第四步:在 Ulanzi Studio 中关联 Companion 按键
这是连接软件和硬件的最后一步。
1. 安装插件:启动 Ulanzi Studio 软件,进入顶部的“应用商店 (Marketplace)”,搜索并安装 “Companion” 插件。
2. 添加动作:安装完成后,返回主编辑界面。从右侧的“动作列表”中,将 Companion 的 “Button” 动作拖拽到您想设置的 Ulanzi 实体按键上。
3. 配置映射关系:
  - 在右侧弹出的属性检查器中,您需要填入想要触发的 Companion 按钮的位置。
  - Page:按钮所在的页面编号。
  - Row:按钮所在的行号。
  - Column:按钮所在的列号。
  - 重要提示:请注意,编号是从 0 开始计数的。例如,要触发第 1 页、第 1 行、第 2 列的按钮,您需要填入 Page: 1, Row: 0, Column: 1。
4. 完成并测试:依次为您想要控制的其他 Companion 按钮配置好映射关系。

现在,按下 Ulanzi 设备上的实体按键,Companion 中对应的按钮就会被触发,并立即指挥 VLC 执行相应操作。您已成功打通整个控制链路!


完整视频教程请看《https://v.douyin.com/1dIpmLpdZA4/


参考资料:

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

×

0

主题

3

回帖

24

积分

新手上路

积分
24
发表于 2025-9-22 22:27:12 | 显示全部楼层
I can't get my deck to connect to the local host 127.0.0.1:8000.
What am I doing wrong? Is there anything else I need to configure? Or is there a firewall interfering with this?

0

主题

3

回帖

24

积分

新手上路

积分
24
发表于 2025-9-23 19:52:35 | 显示全部楼层
I've since found that version 4.0.3 of Companion works.
The version above doesn't connect. Perhaps you could take a look at this.

45

主题

47

回帖

396

积分

管理员

积分
396
 楼主| 发表于 2025-9-23 20:20:51 | 显示全部楼层
cyberpater 发表于 2025-9-23 19:52
I've since found that version 4.0.3 of Companion works.
The version above doesn't connect. Perhaps  ...

Got it. The developers will verify this issue. If confirmed, we'll ensure compatibility in the new version.

0

主题

3

回帖

24

积分

新手上路

积分
24
发表于 2025-9-23 21:19:31 | 显示全部楼层
Ulanzi 发表于 2025-9-23 20:20
Got it. The developers will verify this issue. If confirmed, we'll ensure compatibility in the new ...

Please provide an update on this forum if there is another version of the plugin.

0

主题

1

回帖

4

积分

新手上路

积分
4
发表于 2025-9-25 08:28:20 | 显示全部楼层
Hi Guys, its not working with the last update from bitfocus companion 4.1.1

45

主题

47

回帖

396

积分

管理员

积分
396
 楼主| 发表于 2025-9-27 21:43:18 | 显示全部楼层
Yes, the developers have already investigated. The new version of the Bitfocus Companion has changed the API interface. The plugin will take some time to maintain and update. Please wait patiently for a while.
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

手机版|Ulanzi Studio论坛 ( 粤ICP备2024258515号-1 )

GMT+8, 2025-10-8 06:43 , Processed in 0.165901 second(s), 20 queries .

Powered by Discuz! X3.5

© 2001-2025 Discuz! Team.

快速回复 返回顶部 返回列表