Jitsi MeetのライブストリーミングをRTMP経由でYouTubeに配信する方法

Jitsi Meetは会議をYouTubeに自動的に送信しません。セルフホスト型のJitsiの場合、通常はJibriが組み込みの送信先として使用され、会議をキャプチャしてストリームキーを使用してYouTubeにストリーミング配信します。簡単なイベント配信のみが必要な場合は、OBSなどのデスクトップエンコーダーを使用してJitsi参加者のウィンドウをキャプチャし、YouTubeに送信することもできます。最適な選択肢は、エンコーダーを誰が実行するか、オーバーレイや詳細な制御が必要かどうか、Jibriサービスを操作できるかどうかによって異なります。

このガイドでは、セルフホスト型のJibriセットアップから始め、両方の方法を説明します。このガイドは、セルフホスト型のJitsi Meet環境の管理者向けです。ホスト型のJitsiサービスではライブストリーミングを公開できない場合があります。Jibriの利用可否は、サービス提供者によって制御されます。YouTubeでは現在、過去90日間にライブストリーミングの制限がない認証済みチャンネルが必要です。初回アクティベーションには時間がかかる場合があるため、イベント当日までにチャンネルの適格性を確認してください。

あなたのイベントに最適な配信方法はどれですか？

モデレーターが会議ストリームを開始する必要がある、管理されたセルフホスト型のデプロイメントには、Jibri を使用してください。ワンクリックのワークフローよりも制作管理や明示的な RTMPS 設定が重要な場合は、OBS を選択してください。YouTube は暗号化された取り込みに RTMPS を推奨しています。Jibri の組み込みワークフローと利用可能な出力オプションはリリースによって異なる場合があるため、インストールされているバージョンでサポートされているトランスポートを確認してください。Jibri の設定で RTMPS のサポートを確認できない場合は、YouTube の取り込み URL とプロトコルを公開するエンコーダーを使用してください。

Jibriは何をするものですか？また、どれくらいのリソースを消費しますか？

JibriはJitsiのブロードキャストおよび録画コンポーネントです。会議用のブラウザセッションを開き、レンダリングされた音声とビデオをキャプチャし、ストリーミングサービス用に結果をエンコードします。Jitsi Videobridgeのメディアルーティング機能内では動作しません。Jibriプロジェクトによると、ディスプレイやオーディオデバイスを使用する他のアプリケーションがない、別のマシンまたは仮想マシン上で動作することを想定しており、1つのJibriインスタンスは一度に1つの録画のみをサポートします。そのため、既に負荷がかかっている小規模サーバー上で時折ストリーミングを行うよりも、計画的で管理されたイベントに適しています。

OBSはJitsiサーバースタックにJibriを追加することを避け、キャプチャとエンコードの作業をプレゼンターのコンピューターに移します。既にイベントワークステーションをお持ちの場合はコスト削減につながりますが、ローカルでの運用上の依存関係が生じます。つまり、オペレーターは会議ウィンドウ、音声ルーティング、エンコーダー、ネットワーク接続を常に正常な状態に保つ必要があります。Jibriホストを使用すれば、これらの責任を一元化できますが、サーバーのセットアップとメンテナンスの手間がかかります。

Jibriをセルフホスト型のDockerデプロイメント用にセットアップする

JitsiのDockerハンドブックは随時更新されます。インストールされているリリースに合ったコンポーズファイルと環境例を使用してください。関連性のないブランチや古いチュートリアルから設定をコピーして本番環境にデプロイしないでください。以下の手順は、Docker ComposeによるJitsi Meetのインストールが既に完了しており、ホストへの管理者権限を持っていることを前提としています。

1. YouTubeとデプロイメントの前提条件を確認する

YouTube Studioで、チャンネルがライブ配信できることを確認し、エンコーダーストリームを作成またはスケジュールします。YouTubeの現在のヘルプページによると、過去90日間にライブ配信の制限を受けていない認証済みチャンネルは配信できます。ストリームの設定で、サーバーURLとストリームキーを見つけます。ストリームキーはパスワードのように扱ってください。ストリームキーを知っている人は誰でもそのストリームに配信できる可能性があります。

Jitsi Meet の URL が HTTPS 経由で公開アクセス可能であること、およびホストと Jibri が必要なサービスにアクセスできることを確認してください。公開イベントの前にテストミーティングを実施してください。マネージド Jitsi プロバイダーを使用している場合は、Jibri のライブストリーミングが有効になっているかどうかを管理者に確認してください。ブラウザの設定を変更しても有効にすることはできません。

2. Docker ComposeでJibriサービスを有効にする

既存の Jitsi Compose ファイルを含むディレクトリから、.envファイルを確認し、Jibri の録画/ストリーミング オプションが有効になっていることを確認してください。現在の Docker ハンドブックでは、録画とライブ ストリーミングを有効にするオプションとして記載されています。ENABLE_RECORDING=1標準的なデプロイメントの場合、Jibri Compose ファイルを同じコマンドに追加し、インストールで既に必要な追加の Compose オーバーライドを含めてください。

docker compose -f docker-compose.yml -f jibri.yml up -d

デプロイメントが他のオーバーライドファイルに依存している場合は、短縮されたコマンドを実行しないでください。jibri.yml代わりに、通常の Compose コマンドに追加してください。公式の Jitsi Docker ガイドでは、Jibri ストレージ ディレクトリと書き込み権限についても言及しています。権限を変更する前に、リリースに合わせたハンドブックで現在のディレクトリ レイアウトを確認してください。既存のデプロイメントでは、異なるレイアウトが使用されている場合があります。

Jibriの内部XMPPユーザー、パスワード、およびbrewery設定が、Web、Prosody、Jicofo、およびJibri構成全体で一致していることを確認してください。Composeプロジェクトは、これらの値のための変数を提供します。サービスの設定時に、デプロイメントのドキュメントに記載されている手順に従って強力な内部パスワードを生成し、環境ファイルを保護してください。対応するコンポーネント構成を調整せずに、実行中のデプロイメントでパスワードを繰り返し再生成しないでください。

3. Jibriが利用可能であることを確認します。

コンテナが起動したら、そのステータスとログを確認します。標準のDocker Composeサービス名を使用する場合、例えば次のようになります。

docker compose ps
docker compose logs --tail=100 jibri

サービス名とログ出力はリリースによって異なる場合があります。Jitsi Meet、Jicofo、Prosody、およびJibriのログで、XMPP認証エラーまたはbrewery/MUC検出エラーを確認してください。有効なJibriがJicofoに登録されている場合、会議インターフェースでライブストリーム制御が可能になります。UIにストリーミングサービスが利用できないと表示される場合、YouTubeキーを入力しても、根本的なJibri接続の問題は解決しません。

Jitsi MeetのストリームをYouTubeで開始する

4. YouTubeストリームを作成し、そのキーを保護する

YouTube Studioで、[作成] → [ライブ配信]を選択し、エンコーダーストリームを作成またはスケジュールします。ライブコントロールルームからストリームキーをコピーします。YouTubeのストリームキーはエンコーダーの送信先認証情報です。公開ミーティングのチャット、コマンド履歴、スクリーンショット、または共有構成ファイルに貼り付けないでください。キーが漏洩した場合は、YouTube Studioでキーをローテーションし、エンコーダーを更新してください。

Jibriの通常のJitsiワークフローでは、動作中のJibriが検出されると、モデレーターにストリームキーの入力を求めます。Jibri APIには、ストリーミング操作用のYouTubeストリームキーパラメータも記載されています。カスタムJibri統合を使用する場合は、エンドポイント呼び出しを独自に作成するのではなく、デプロイされている正確なバージョンのAPIとアクセス制御に従ってください。

5. 配信を開始し、ライブ配信前にプレビューを確認します。

会議にモデレーターとして参加し、会議コントロールを開いて、ライブストリーム機能があればそれを選択します。プロンプトにYouTubeストリームキーを入力し、ストリームを開始します。YouTube Liveコントロールルームで、受信プレビューが表示されるまで待ち、音声と映像の両方が揃っていることを確認してから「ライブ配信開始」を選択します。ボタンのラベルは、Jitsiのリリースやカスタマイズされたインターフェースによって異なる場合があります。

最初のテストでは、非公開の配信を作成し、動きと会話のある短いミーティングを使用してください。スピーカーのバランス、共有画面の見やすさ、参加者のタイルが想定どおりに切り取られているかどうかを確認します。YouTubeは互換性のあるエンコーダー入力を視聴者デバイス向けに自動的にトランスコードしますが、クリーンな入力と信頼できるアップロードパスは依然として重要です。テスト中およびイベント中は、YouTubeの配信状態インジケーターを監視してください。

より詳細な制御が必要な場合はOBSを使用してください

OBSを使用する場合は、専用のコンピューターでJitsiミーティングに参加し、ミーティングウィンドウまたは特定のシーンをキャプチャし、OBSのストリーミング設定でYouTubeのサーバーURLとストリームキーを設定します。ミーティングのコントロール、通知、または参加者の個人情報を非表示にする必要がある場合は、イベント前にクリーンなシーンを作成してテストしてください。配信許可を得ているコンテンツのみをキャプチャし、ミーティング参加者には音声またはビデオがストリーミングされる可能性があることを伝えてください。

OBS を使用すると、レイアウト、オーバーレイ、オーディオ ソース、および出力設定を制御できます。YouTube の現在のエンコーダー ガイドラインは RTMP/RTMPS 取り込みをサポートしており、暗号化された接続には RTMPS を推奨しています。1080p30 の H.264 の場合、YouTube は推奨ビデオ ビットレートを 14 Mbps としています。720p30 の場合は 8 Mbps としています。これらは目標のエンコーダー設定であり、品質レベルを保証するものではありません。他のトラフィックのためにアップロードの余裕を残しておき、接続が途切れることなくストリームを維持できない場合は、解像度またはビットレートを低くしてください。

Jibriは設定が完了すればモデレーターにとって操作が簡単で、キャプチャデータはサーバー上に保持されますが、基本的な会議フローでは制作上の制御機能が限られています。OBSは柔軟性が高く、特定の取り込みURLを選択したり、グラフィックを追加したりするのが簡単ですが、オペレーターによる監視が必要です。どちらの方法も万能ではありません。Jibriは集中管理型の定期イベントに、OBSはカスタム制作やRTMPS（リアルタイム・モーション・ピクチャー・システム）とシーン制御が必須の場合には適しています。

ストリームが開始されない場合、何をチェックすべきですか？

• ライブストリーム制御が欠落しています。デプロイメントでライブストリーミングが有効になっているか、Jibriが登録されていてアイドル状態になっているかを確認してください。Dockerの場合は、リリースが一致するENABLE_RECORDING設定になっていること、およびJibri composeサービスが実行されていることを確認してください。
• Jitsiがストリーミングが利用できないと報告した場合、 Jibriのログ、XMPP接続、内部認証情報、brewery MUC、およびストレージアクセスを確認してください。問題は通常、YouTubeが動画を受信する前に、Jitsiの制御コンポーネントとJibriの間で発生します。
• YouTubeが信号を受信しない場合：正しいストリームキーと宛先ストリームを確認し、エンコーダーを実行しているマシンからの送信接続を確認してください。露出している、または不確かなキーを回転させてください。
• YouTubeでプレビューが表示されるものの、映像が途切れる場合は、出力解像度またはビットレートを下げ、エンコーダーホストのCPU使用率を確認し、持続的なアップロード帯域幅をテストしてください。Jibriの場合はホストの負荷を、OBSの場合はエンコーダーのドロップフレームとネットワークの状態を確認してください。
• 動画に音声が表示されない： Jitsi参加者の音声、システム音声キャプチャ、および選択したエンコーダー音声デバイスを確認してください。イベント前に音声テストを実施してください。

イベント前のチェックリスト

• YouTubeチャンネルは対象であり、ライブコントロールルームで適切なライブイベントが開始されている必要があります。
• Jibriが利用可能であるか、OBSコンピューターとオペレーターが準備できています。
• ストリームキーは非公開であり、対象となるイベントにのみ適用されます。
• テストプレビューでは、明瞭な音声、安定した映像、読みやすいレイアウトが確認できた。
• 少なくとも1人の主催者がYouTubeストリームの状態を監視し、イベント終了時にエンコーダーを停止することができる。

公式資料

• Docker 用 Jitsi Meet セルフホスティングガイド: Jibri と Compose の設定
• Jitsi Jibriプロジェクト：アーキテクチャと構成
• Jibri HTTP API: ストリーミングリクエストパラメータ
• YouTubeヘルプ：ライブ配信の資格要件と配信方法
• YouTubeヘルプ：エンコーダーを使用してライブストリームを作成する
• YouTube ヘルプ: ストリームキーとストリーム設定の管理
• YouTubeヘルプ：エンコーダーのプロトコル、設定、推奨ビットレート