この記事では、bitfocus CompanionとPLAYDECKを連携させる方法について説明します。Companionには、PLAYDECK用のすぐに使えるモジュールが用意されています。これは、PLAYDECKをATEMミキサーやSTREAMDECKに接続する最も手軽な方法です。.
コンパニオン・モジュールは、以下の組織によって開発・保守されています。 ニック・セモノフ. 彼はコミュニティ・デベロッパーであり、一緒に仕事をするのに最高の相棒です。.
この記事の内容：
→ インストール
→ プリセット付きボタンページ
→ アクションの代わりにカスタムコマンド
→ カスタムボタンのフィードバック
インストール
1. PLAYDECKを起動し、Companionがそれを検出できるようにします
2. をダウンロードしてインストールする Companionの最新安定版
3. Companion を起動し、PLAYDECK モジュールを追加します
4. Companionにこの接続の横に緑色のチェックマークが表示されていれば、設定は完了です。接続できない場合は、ファイアウォールを無効にするか、TCPポート11411を通すように設定してください。.
プリセット付きボタンページ
「コンパニオンプリセット」を使用して、カジュアルなプレイアウトの場面向けに、ボタンが配置された新しいページを素早く作成します。.
1. 新しいページを作成し、「プリセット」に移動して「PLAYDECK」を選択します
2. このサンプルでは、特にチャンネル1を対象とします。また、動的にPLAYDECKに表示されているチャンネル（左および右）を使用する「LISTS」を利用することも可能です。さらに、アセット（ストリーム、録画）を制御することもできます。続行するには「CHANNEL 1」を選択してください
3. ドラッグ＆ドロップ機能を使って、オーバーレイ付きのシンプルな再生制御ソリューションを作成します。ボタンにはフィードバック機能が組み込まれており、再生状態（キュー、再生中、一時停止、停止）に応じてボタンが赤く表示されます。.
4. 「再生」ボタンには、再生中のクリップの残り時間も表示されます：
5. 「START OVERLAY」ボタンのように、追加の情報が必要なボタンもあります。このボタンは、どのオーバーレイを開始すべきかを特定する必要があります：
アクションの代わりにカスタムコマンド
PLAYDECKのコマンドであれば、どのようなものでもCompanionのボタンに割り当てることができます。これは、プログラミングが得意な方や、PLAYDECKに追加されたものの、Companionでは（まだ）利用できない新しいコマンドがある場合に便利です。また、複数のコマンドを同時に割り当てることも可能です。.
1. 新しいボタンを作成し、新しいアクションを追加します。次に「カスタムコマンド」を選択し、「完了」をクリックします
2. PLAYDECKで「コマンド一覧」を開き、どのコマンドを使用するか確認します
3. 複数のチャンネルで複数のオーバーレイを開始し、その後2つのストリームを開始することにします：
<startoverlay|1|1+3>
<startoverlay|2|1+5>
<startstream|1>
<startstream|2>
4. すべてのコマンドを1行にまとめ、それを「COMMANDS」フィールドに貼り付けます。その後、ボタンを押すと、オーバーレイとストリームが開始されます。これは、すべてのコマンドが記述された順序で実行されるためです。.
5. もう1つの良い例は、2チャンネルを同期させて開始することです：
<cue|1><cue|2><wait|1000><play|1><play|2>
これにより、両方のチャンネルがCUE状態になり、CUEの準備が整うまで1秒間待機（クリップのキャッシュ）した後、両方のチャンネルを再生します。.
カスタムボタンのフィードバック
あらかじめ定義されたフィードバック（例：PLAY STATE）の代わりに、コンパニオン変数を使用することで、さらに多くのフィードバックを利用できます。この例では、特定のブロックを開始し、その残り時間をボタンに表示します。.
1. PLAYDECKのチャンネル#1に新しいブロックを追加し、その名前を「MAIN PROGRAM」に変更します“
2. 次に、Companionに新しいボタンを追加し、そのボタンに「CONTROL PLAY FLEX」アクションを割り当てます。.
3. PLAY FLEXアクションを使用すると、IDではなく名前でブロックを再生することができます。コマンドリスト（PLAYDECK > メインメニュー > ドキュメント）に記載されているように、ブロックを開始するために「b:main c#1」というパターンを使用します：
4. これで「再生」ボタンが完成しましたが、再生が始まったら、残りの再生時間も表示させたいと考えています。そのためには、ボタンにカスタムフィードバックを追加し、そこで「ある」変数をチェックして「何か」を行うようにする必要があります：
5. 「VARIABLE」フィールドで「ブロック名」を検索し、現在実行中のブロックと照合した上で、ブロック「Main Program」を「VALUE」として追加します：
6. 残りのブロック時間を表示したいので、新しいスタイルプロパティとして「TEXT」を追加します：
7. 「$(Playdeck:channel_1_block_remain)」をボタンテキストとして追加すれば、ボタンの作成は完了です：
8. では、この「ボタンテキスト文字列」はどのように取得したのでしょうか？Companionでは、PLAYDECKで使用可能なすべての変数が表示されます。その後、小さなコピーアイコンをクリックして、その変数をボタンに転送することができます：
