vMix統合

放送制作向けにライブキャプションをvMixに送信します。

概要

放送制作向けにリアルタイムのキャプションをvMixに送信します。MaestraはvMixと同じコンピューターで動作し、ライブキャプションをvMixのタイトル入力に送信します。

始める前に

  • Google Chrome を使用し、最新バージョンに保ってください。
  • vMix が実行されていて、vMix Web Controller が有効になっていることを確認します。
  • vMix と同じマシンの同じブラウザで Maestra を開きます。

設定方法

  1. vMixは、Maestra Liveが動作しているのと同じコンピューターで実行している必要があります。
  2. vMixにキャプションを表示するこのタイトルテンプレートをダウンロードします。Add Input > Title/XAMLに移動して、このタイトルテンプレートをvMixにインポートします。Input Selectウィンドウの右上で「Browse...」をクリックし、ダウンロードしたタイトルテンプレートファイルを選択します。OKをクリックします。
  3. vMixで、Settings > Web Controllerに移動し、Webコントローラーを有効にするボックスにチェックを入れます。
  4. ポートを設定するか、デフォルトのままにします。
  5. 「vMix Web Site Address」をコピーして、Maestraに貼り付けます。
  6. 任意で、よりスムーズな操作のためにMaestra Companion Appをダウンロードします。インストールして実行したら、vMixチャンネル設定で有効にし、ページを更新して、vMixでキャプションをお楽しみください。

トラブルシューティング

Maestra のリアルタイムセッションから vMix に字幕が届かない場合は、このチェックリストを順番に進めてください。各手順では、Web Controller の設定や Chrome のネットワーク権限から、ファイアウォール、ポート、vMix の字幕テンプレートまで、よくある原因を一つずつ排除します。画面上で字幕が更新され始めたらすぐに作業を止めてください。

チェックリスト

  1. 基本を確認する
    • vMix Web Controller を、Maestra を使用しているブラウザと同じマシンで実行します。
    • チャンネルが正しい vMix の URL(デフォルト http://localhost:8088)を指していて、字幕タイトルまたはテンプレートの GUID が一致していることを確認します。
  2. Web Controller のセキュリティオプションを確認する
    • Allow software on this computer access without login をチェックしたままにします。
    • Enable enhanced security on Web and TCP API はチェックを外したままにします。
    • Restrict access to LAN only はチェックを外したままにします。
  3. Chrome でローカルネットワークアクセスを有効にする
    • chrome://settings/content/all を開き、live.maestra.ai を検索して選択します(または鍵アイコン →「サイトの設定」を使用します)。
    • ローカルネットワークアクセスを許可に設定し、Maestra を再読み込みして再試行します。
  4. ネットワークの到達性を確認する
    • そのマシンで、Web Controller の URL(例: http://localhost:8088)を任意のブラウザで開きます。
    • 読み込みに失敗する、または動作が重い場合は、まずそれを修正します: vMix を起動し、ポートを修正し、ファイアウォールのブロックを解除します。
  5. 別のポートを試す
    • 8088 で失敗し続ける場合は、vMix Web Controller を未使用の高位ポート(例: 2025)に変更し、Maestra の URL を更新して再テストします。
    • これにより、企業のセキュリティフィルターや、よく使われるポートに紐づいた古いリスナーを回避できることがよくあります。
  6. 企業または VPN のブロックを排除する
    • HTTPS ページから http://localhost への到達を禁止している可能性のある VPN、エンドポイントファイアウォール、ウイルス対策ソフトを一時的に切断します。
    • 字幕が動作し始めたら、vMix とブラウザをホワイトリストに追加してから、セキュリティツールを再度有効にします。
  7. vMix テンプレートを検証する
    • Title Designer で、WebCaptionerCaptions フィールドが存在し、GUID が Maestra の設定と一致していることを確認します。
    • vMix でそのフィールドを手動で編集し、画面上で更新されることを確認します。
  8. ブラウザを調べる
    • DevTools を開き、Network タブを表示してチャンネルを有効にし、SetText リクエストを監視します。
    • ブラウザが Mixed Content、Private Network Access、CORS のフラグを立てていないか、またはリクエストがそもそも送信されていないかを確認します。
  9. 混在コンテンツまたはプライベートネットワークの警告に対処する
    • Chrome、Edge、Brave: chrome://flags/#block-insecure-private-network-requests を無効にし、再起動します。
    • Safari: テスト中は「開発」メニューで Disable Cross-Origin Restrictions を切り替えます。
    • Firefox: network.websocket.allowInsecureFromHTTPS を true に設定し、HTTPS のみモードがオフであることを確認します。
  10. 結果を監視する
    • 字幕の実行中は DevTools を開いたままにします。リクエストが成功しているように見えるのにテキストが更新されない場合は、Network エントリと vMix のプレビューのスクリーンショットを取得します。
    • サポートにエスカレーションする前に、タイムスタンプ、ブラウザのバージョン、オペレーティングシステム、コンソールエラーを収集します。

解決しない場合

このチェックリストを行っても字幕が更新されない場合は、アプリ内のサポートウィジェットを開き、「チケットを作成」をクリックしてください。タイムスタンプ、ブラウザのバージョン、オペレーティングシステム、vMix のバージョン、コンソールエラーを記載してください。