使用 Bitfocus Companion 和 Stream Deck 控制屏幕

Bitfocus Companion 是一款免费软件，能把 Elgato Stream Deck 或浏览器中的按钮变成整场制作的控制面板。借助 Companion 里的 Screenbird 连接，按一下就能让场景在其所有屏幕上生效，生效期间按钮会以场景的颜色亮起。在这些时刻之间，您的屏幕会自行运行。

您需要：

  • Companion 4.3 或更新版本。
  • 一个 Screenbird 的 API 令牌。
  • 使用场景按钮的前提：已开启场景功能，并且至少有一个场景。具体方法见 用场景一次切换多块屏幕。没有场景时，Companion 仍然可以向屏幕推送内容并停止推送。

创建 API 令牌

  1. 前往 设置 > 连接。
  2. 在 API 令牌 下，点击 新建 API 令牌 按钮。
  3. 为令牌起一个名称，例如场地名称或 Stream Deck 的名称。
  4. 在 访问权限 下，选择 控制屏幕和场景。
  5. 点击 创建令牌 按钮并复制令牌。令牌只会显示一次。

令牌在您创建它时处于活动状态的团队中有效。要控制另一个团队的屏幕，请先切换到该团队，再另外创建一个令牌。每个 Companion 连接使用一个令牌。

有关令牌的更多信息：API 令牌。

在 Companion 中添加 Screenbird

  1. 在 Companion 中前往 Connections，搜索 Screenbird 并添加。
  2. 把令牌粘贴到 API token 中并保存。
  3. 打开该连接的预设，把按钮拖到您的 Stream Deck 上。

请保持 API address 不变，除非 Screenbird 支持团队给了您另一个地址。

运行 Companion 的电脑需要能通过 443 端口向 api.screenbird.app 发起 HTTPS 和安全 WebSocket（WSS）出站访问。没有可用的网络连接时，按钮无法工作。

按钮

预设分为三组。

Scenes

  • Go：每个场景一个按钮，颜色与场景相同。
  • Stop：每个场景一个按钮，让该场景恢复正常。按钮为暗色，场景名称以该场景颜色的浅色版本显示。

Control

  • STOP ALL 让一切恢复正常，为暗红色。
  • NEXT 启动最后启动的场景的下一个场景，顺序以仪表板中 场景 的顺序为准。按钮上显示那个场景的名称。

Screens

  • 每块屏幕或子屏幕一个 stop 按钮。当该屏幕上显示场景或推送的内容时，它会变成暗红色。

场景按钮的颜色表示它的状态：

  • 暗色：场景已关闭。
  • 全彩：场景在其所有屏幕上都在生效。
  • 半亮：场景部分生效。它的某些屏幕在显示别的内容，或者该场景之前的显示还留在部分屏幕上。
  • 琥珀色，文字中带有「(changed)」：场景在生效之后被编辑过。再按一次，更改就会生效。

按钮会立即跟随变化，即使是有人在仪表板上、在手机上或按设定的时间启动了场景。新的场景或新的屏幕会自动出现在预设中。

动作

在您自己的按钮上使用这些动作：

  • Scene: go：在场景的所有屏幕上显示该场景。如果场景在生效之后有过更改，再按一次会让更改生效。
  • Scene: stop：停止这个场景。它的屏幕恢复显示自己的内容。
  • Scene: next：切换到最后一个被启用的场景之后的场景。
  • Stop all：停止所有场景和推送的内容。屏幕共享继续运行。
  • Screen: push content：在一块屏幕或子屏幕上显示内容，持续指定的分钟数，或直到停止。内容从一份列表中选择，其中包含团队的文件、设计、应用、分屏和播放列表。
  • Screen: stop：停止一块屏幕或子屏幕上推送的内容或场景。

反馈

使用这些反馈来改变按钮的外观：

  • Scene is live、Scene is partly live 和 Scene changed since it went live。
  • Screen shows：场景、推送的内容、屏幕共享或正常内容。
  • Screen is online。

变量

可以在按钮文字中使用变量，例如 $(screenbird:last_scene)。如果您重命名了连接，请用它的名称代替「screenbird」。

  • last_scene：最后一个被启用的场景。
  • next_scene：Scene: next 将启动的场景。
  • live_scenes：正在生效的场景。
  • screens_online 和 screens_total：在线的屏幕数，以及屏幕总数。

故障排查

  • Authentication failure：令牌无效或已被撤销。请创建新令牌，并粘贴到连接设置中。
  • Insufficient permissions：令牌没有屏幕的访问权限，或者创建它的人已失去访问权限。请创建访问权限为 控制屏幕和场景 的令牌。
  • 提到 API address 的 Connection failure：应答的是不属于 Screenbird 的东西，例如 Wi-Fi 登录页面，或者地址有误。请检查网络和 API address。
  • 一直不消失的 Waiting for the live connection，或者 Live updates unavailable：防火墙或代理可能拦截了发往 api.screenbird.app 的 WebSocket 流量。按钮仍然可用，但颜色只有在按下之后才会更新。
  • No active subscription：Screenbird 账户未处于活动状态。连接每隔 5 分钟重新检查一次。
  • 没有场景按钮：场景功能处于关闭状态。所有者在 设置 > 高级 中开启它，之后按钮会自动出现，无需重启 Companion。

撤销令牌

在 设置 > 连接 中，点击令牌旁边的 撤销 按钮。所有使用该令牌的程序会立即停止工作。参见 API 令牌。

© screenbird.app