Bitfocus Companion と Stream Deck でスクリーンを操作する

Bitfocus Companion は、Elgato Stream Deck やブラウザ上のボタンを、制作全体のコントロールパネルに変える無料のソフトウェアです。Companion の Screenbird 接続を使うと、ボタンを押すだけでシーンが全スクリーンでライブになり、ライブのあいだはボタンがシーンの色で点灯します。それ以外のときは、スクリーンが自動で動き続けます。

必要なもの:

  • Companion 4.3 以降。
  • Screenbird の API トークン。
  • シーンのボタンを使う場合: シーン機能がオンで、シーンが 1つ以上あること。手順は シーンで複数のスクリーンを一度に切り替えるを参照してください。シーン機能がオフでも、Companion からスクリーンにコンテンツを送信したり、停止したりできます。

API トークンを作成する

  1. 設定 > 接続 を開きます。
  2. APIトークン の下で 新しいAPIトークン をクリックします。
  3. トークンに名前を付けます。たとえば会場名や Stream Deck の名前です。
  4. アクセス権 で スクリーンとシーンを操作 を選びます。
  5. トークンを作成 をクリックして、トークンをコピーします。トークンが表示されるのは 1回だけです。

トークンは、作成時にアクティブだったチームで有効です。別のチームのスクリーンを操作する場合は、先にそのチームに切り替えて、別のトークンを作成してください。トークンは、Companion の接続ごとに 1つ使います。

トークンの詳細は API トークンを参照してください。

Companion に Screenbird を追加する

  1. Companion で Connections を開き、Screenbird を検索して追加します。
  2. API token にトークンを貼り付けて保存します。
  3. 接続のプリセットを開き、ボタンを Stream Deck にドラッグします。

API address は、Screenbird サポートから別のアドレスを案内された場合を除き、そのままにしてください。

Companion を実行するパソコンには、api.screenbird.app へのポート 443 での HTTPS と、セキュアな WebSocket（WSS）の外向き通信が必要です。インターネットに正常につながっていないと、ボタンは動きません。

ボタン

プリセットは3つのグループに分かれています。

Scenes

  • Go: シーンごとに 1つ。シーンの色のボタンです。
  • Stop: シーンごとに 1つ。そのシーンを通常に戻します。暗い色で、シーン名がシーンの色を明るくした色で表示されます。

Control

  • STOP ALL は、すべてを通常に戻します。暗い赤です。
  • NEXT は、最後に開始したシーンの次のシーンを開始します。順序はダッシュボードの シーン の並びのとおりです。ボタンには、そのシーンの名前が表示されます。

Screens

  • スクリーンまたはサブ画面ごとに stop ボタンが 1つあります。そのスクリーンでシーンまたは送信したコンテンツが表示されているあいだ、暗い赤になります。

シーンのボタンは、色で状態がわかります。

  • 暗い色: シーンはオフです。
  • フルカラー: シーンは、含まれるすべてのスクリーンでライブです。
  • 半分の明るさ: シーンは一部でライブです。一部のスクリーンが別の内容を表示しているか、そのシーンが以前から一部のスクリーンに残っています。
  • アンバー、テキストに「(changed)」付き: シーンはライブになったあとで編集されています。もう一度押すと、変更がライブになります。

ボタンは変更にすぐ追従します。ダッシュボード、スマートフォン、設定した時刻のどれでシーンが開始されても同じです。新しいシーンや新しいスクリーンは、自動でプリセットに現れます。

アクション

自分で作るボタンには、次のアクションを使えます。

  • Scene: go: シーンを、含まれるすべてのスクリーンに表示します。ライブになったあとでシーンが変更されている場合は、もう一度押すと変更がライブになります。
  • Scene: stop: このシーンを停止します。スクリーンは自分のコンテンツに戻ります。
  • Scene: next: 最後にアクティブにしたシーンの次のシーンに進みます。
  • Stop all: すべてのシーンと、送信したコンテンツを停止します。画面共有は続行されます。
  • Screen: push content: 1つのスクリーンまたはサブ画面にコンテンツを表示します。表示する時間は分単位で指定でき、停止するまで表示し続けることもできます。コンテンツは、チームのファイル、デザイン、アプリ、分割画面、プレイリストの一覧から選びます。
  • Screen: stop: 1つのスクリーンまたはサブ画面で、送信したコンテンツまたはシーンを停止します。

フィードバック

ボタンの見た目を変えるには、次のフィードバックを使います。

  • 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: トークンにスクリーンへのアクセス権がないか、トークンを作成した人がアクセス権を失っています。アクセス権が スクリーンとシーンを操作 のトークンを作成してください。
  • Connection failure のメッセージに API address が含まれる場合: 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