このドキュメントでは、RTMPS を使用してエンコーダから YouTube のライブデータをストリーミングする方法について説明します。RTMPS は、SSL 接続でトンネリングされた通常の RTMP(RealTime Messaging Protocol)動画ストリームです。このドキュメントは、RTMPS をすでにサポートしているエンコーダに RTMPS のサポートを追加するエンコーダ ベンダーを対象としています。
RTMPS は、特に低レイテンシを必要とする場合に、ほとんどの一般的なユーザー コンテンツに適しています。YouTube ライブ ストリーミングでサポートされている取り込みプロトコルの概要については、取り込みプロトコルの比較をご覧ください。
要件
YouTube ライブに RTMPS を送信するには、いくつかの前提条件があります。
- 接続 URL(
<protocol>://<server>/<path>
)の各部分は正しい必要があります。- プロトコルは
rtmps
にする必要があります。 - このサーバーには有効な YouTube RTMPS 取り込みエンドポイントを指定してください。
- パスには有効な YouTube ライブ RTMP アプリケーション名を指定してください。
- プロトコルは
- 接続は、取り込みサーバーのポート 443 に接続する必要があります。
- マルチメディア ストリームは RTMPS で送信する必要があります(つまり SSL 接続を介して RTMP を使用します)。
接続 URL を取得する
エンコーダですでに YouTube Live API を使用している場合、RTMPS の取り込み URL を取得するプロセスは RTMP の場合と同様です。LiveStreams 挿入(POST)リクエストを送信して、新しい取り込みストリームを作成します。レスポンスの cdn.ingestionInfo.rtmpsIngestionAddress
フィールドには、RTMPS URL を指定します。デュアル取り込みをサポートする場合、バックアップ アドレスは cdn.ingestionInfo.rtmpsBackupIngestionAddress
です。
接続の作成
任意のソケット ライブラリを使用して、取り込み URL で指定されたサーバーでポート 443 への SSL/TLS 接続を作成します。TLS はトランスポート層でのみ機能するため、サーバーのホスト名は厳密には接続の開始に必須ではありませんが、サーバーでの認証には必要です。そのため、SNI 拡張機能(Server Name Indication)を SSL handshake に追加し、サーバー名を接続するサーバーのホスト名に設定してください。
SSL 接続が確立されたら、RTMP クライアント ライブラリの接続として使用します。初期化された SSL 接続の API は標準の TCP の接続と同じであるため、RTMP ライブラリは両方の API を同じように動作させることができます。
トラブルシューティング
SSL エラー
SSL 接続を作成しようとして無効な証明書を取得する場合は、RTMP を必要とする YouTube サーバーに接続している可能性があります。使用するサーバー名に「rtmps」が含まれていることを確認します(「s」に注意してください)。
URL は正しいのに SSL エラーが発生する場合は、間違ったポートに接続している可能性があります。ポート 443 に接続していることを確認します。
URL とポートが正しい場合、SSL ライブラリで証明書が正しく処理されていない可能性があります。SSL の失敗に関する低レベルの診断メッセージを探し、handshake で SNI を使用していることを再度確認します。
接続がタイムアウトになった
サーバーに接続できるが、有効なレスポンスがない状態で RTMP ライブラリがタイムアウトした場合は、RTMPS を想定している YouTube サーバーにクリアテキストの RTMP 接続が設定されている可能性があります。プレーン TCP 接続ではなく、SSL 接続を作成していることを確認してください。