Troubleshooting

CDNetworks Media Acceleration Live Broadcastで一般的な配信および再生の問題を診断するには、このガイドをご利用ください。発生している問題に最も一致する症状から確認を開始し、順番にチェックを完了して、CDNetworksサポートへご連絡いただく前に必要な情報を収集してください。

Table of Contents

• 配信の問題
• 配信できない
• 1. DNSおよびCNAME設定を確認する
• 2. エンコーダー設定の確認
• 3. オーディオおよびビデオフォーマットの確認
• 4. 重複するアクティブストリームの確認
• 5. URL認証の確認
• 6. 配信ブロックを確認する
• 7. 配信者のネットワークを確認する
• 再生に関する問題
• ストリームが再生できない、または404エラーが返される場合
• 1. 再生URLの確認
• 2. DNSとCNAMEの設定を確認する
• 3. インジェストがアクティブであることを確認する
• 4. 別のプレーヤーでテストする
• 5. ビューアのネットワークを確認する
• 再生が途切れる、または頻繁にバッファリングされる場合
• 映像がぼやけている
• 再生が予期せず停止する
• RTMPおよびHTTP-FLVが動作しているが、HLSが失敗する場合
• HLSは映像あり、音声なし
• 収集する情報

配信の問題

配信できない

1. DNSおよびCNAME設定を確認する

取り込み用Domainを追加すると、CDNetworksがCNAMEターゲットを割り当てます。DNSプロバイダで対応するCNAMEレコードを作成してください。

• DNSルックアップツールを使用し、取り込み用DomainがCDNetworksより割り当てられたCNAMEターゲットに解決されていることを確認してください。
• Domainが解決されない場合や他の場所を指している場合は、DNSレコードを修正し、DNS変更の伝播をお待ちください。

2. エンコーダー設定の確認

エンコーダーに正しいサーバーURLおよびストリームキーが入力されていることを確認してください。OBS Studioや類似のエンコーダーの場合：

• Server に取り込み用DomainおよびAppNameを入力してください。
• Stream Keyには、StreamNameおよびクエリストリングパラメーターが含まれています。
• URL認証が有効な場合は、すべての必要な認証パラメーターを含めてください。例えば、タイムスタンプ認証には「wsTime」と「wsSecret」が必要となる場合があります。

可能であれば、別のエンコーダーでテストし、問題が元のエンコーダーやその設定に固有かどうかを確認してください。

3. オーディオおよびビデオフォーマットの確認

ライブ配信では、H.264ビデオとAACオーディオが一般的に使用されています。FFmpegを使用してストリームを確認してください：

ffmpeg -i "rtmp://<ingest-domain>/<app-name>/<stream-name>"

プレースホルダを取り込みDomain、AppName、StreamNameに置き換えてください。出力内容から検出されたコーデックや、接続、認証、デコードに関するエラーを確認してください。

4. 重複するアクティブストリームの確認

1つのAppNameの下で、同じStreamNameを使って2つのパブリッシャーが同時に配信することはできません。エンコーダーが「Server error: Failed to publish」と報告した場合は、他のエンコーダーやプロセスによって同じストリームがすでに配信されていないかを確認し、再試行してください。

5. URL認証の確認

URL認証が有効な場合、取り込みURLには有効かつ有効期限内のパラメータが含まれている必要があります。不足、綴り間違い、無効、または期限切れのパラメータがあると、I/Oエラーで配信が失敗する可能性があります。wsTime や wsSecret などの値を確認し、必要に応じて新しい認証付きURLを生成してください。

6. 配信ブロックを確認する

コンソールの配信ブロックタスクリストを使用して、配信または配信元IPアドレスがブロックされているかどうかを確認してください。配信を復旧する必要がある場合は、組織の変更手順に従うか、認可された管理者にご連絡ください。

7. 配信者のネットワークを確認する

• DNS ルックアップツールを使用して、取り込みDomainが正しく解決されるかを確認してください。
• 配信者とIngest Domain間でパケットロスや遅延の不安定さがないかを確認してください。
• RTMPを利用している場合は、TCPポート1935でIngest Domainへの接続をテストしてください。
• 設定されたビットレートに対して、配信者が十分かつ安定した上り帯域幅を確保していることを確認してください。

接続テストに失敗した場合は、ローカルファイアウォール、プロキシ、ルーティング、ISPによる制限を確認してください。

再生に関する問題

ストリームが再生できない、または404エラーが返される場合

1. 再生URLの確認

再生URLは通常、配信Domain、AppName、およびStreamNameを含みます。パスと拡張子はプロトコルによって異なります。例：

rtmp://play.example.com/app/stream
https://play.example.com/app/stream.flv
https://play.example.com/app/stream/playlist.m3u8

Domain、AppName、StreamName、プロトコル、パス、拡張子、大文字小文字を確認してください。認証が有効な場合は、すべての必須パラメータが存在し、有効期限が切れていないことも確認してください。

2. DNSとCNAMEの設定を確認する

DNSルックアップツールを使用して、再生用DomainがCDNetworksによって割り当てられたCNAMEターゲットに正しく解決されることを確認してください。正しく解決されない場合は、DNSレコードを修正するか、DNS管理者へご連絡ください。

3. インジェストがアクティブであることを確認する

ソースストリームが配信されていない場合、再生は失敗します。エンコーダーが接続されてデータを送信していることを確認し、その後で ストリームが配信できない場合 の確認項目をすべて実施してください。

4. 別のプレーヤーでテストする

再生プロトコルに対応したプレーヤーをお試しください。他のプレーヤーでストリームが正常に再生できる場合は、元のプレーヤーのプロトコル対応状況、メディアコーデック対応状況、構成を見直してください。

ブラウザベースの再生の場合、ブラウザのコンソールでクロスオリジンエラーを確認してください。プレーヤーページとストリームが異なるオリジンを使用する場合、再生レスポンスには必要なCORSヘッダーが含まれている必要があります。

5. ビューアのネットワークを確認する

別のデバイスまたはネットワークで再生を比較してください。特定の1人のビューアのみが影響を受けている場合は、そのビューアの接続状況、ファイアウォール、プロキシ、ブラウザ、プレーヤー環境を調査してください。

再生が途切れる、または頻繁にバッファリングされる場合

インジェストから再生までのストリームを確認してください：

1. パブリッシャのアップストリーム接続が安定しており、設定したビットレートを維持できているか確認してください。
2. エンコーダのCPUおよびハードウェア使用率を確認してください。エンコーダに過負荷がかかっている場合は、より低いビットレート、解像度、またはフレームレートでテストしてください。
3. 設定したフレームレートがコンテンツに適していることを確認してください。非常に低いフレームレートでは、目に見えてカクつく場合があります。
4. 別のデバイス、プレーヤー、およびネットワークでの再生を比較してください。
5. プレーヤーのバッファ設定を確認してください。大きなバッファは復元力を向上させる場合がありますが、再生遅延が増加する可能性もあります。

映像がぼやけている

1. 配信前にソース映像が鮮明であることを確認してください。
2. 配信解析にて、想定外のビットレート、フレームレート、解像度、またはストリームエラーがないか確認してください。
3. ハードウェアやネットワークの制約により、エンコーダがビットレートや解像度を予期せず下げていないことを確認してください。
4. 配信中にストリームのメタデータが変更されていないか確認してください。想定外の変更は、下流の処理に影響を与える可能性があります。
5. 別のプレーヤーでテストしてください。可能であれば、ソフトウェアデコードとハードウェアデコードを比較してください。

再生が予期せず停止する

1. インジェストが同時に停止したかどうかを確認してください。同時に停止していた場合は、まずパブリッシャーおよびそのネットワークをトラブルシュートしてください。
2. 中断が一人の視聴者、単一のネットワーク、または異なる場所にいる複数の視聴者に影響を与えたかを判断してください。
3. 他のプレイヤー、デバイス、ネットワークでもテストしてください。
4. 収集する情報に記載されているインシデントの詳細を記録してください。

RTMPおよびHTTP-FLVが動作しているが、HLSが失敗する場合

1. FFmpegまたはFFplayでストリームを検査し、コーデック、タイムスタンプ、またはパッケージングエラーの有無を確認してください。
2. オーディオおよびビデオのコーデックがターゲットのHLSプレイヤーと互換性があるかを確認してください。
3. 管理者に、オリジンのHostヘッダーまたはオリジンへのHost設定が正しいかを確認してもらってください。
4. HLS URL、認証パラメータ、プレイヤーのサポートを再度ご確認ください。

HLSは映像あり、音声なし

ソースオーディオコーデックを確認し、ターゲットのHLSプレイヤーが対応しているかご確認ください。同じストリームをRTMPまたはHTTP-FLVで比較してください。もしこれらのプロトコルでは音声が再生できるがHLSではできない場合、AACオーディオでストリームをテストしてください。

収集する情報

問題が継続する場合は、以下の詳細情報をCDNetworksサポートチームへご提供ください。

• インジェストや再生のURL（シークレットや認証署名はマスキング済みで）
• ドメイン、AppName、StreamName
• プロトコルおよびプレイヤーまたはエンコーダー名・バージョン
• インシデントのおおよその発生時刻（タイムゾーンを含む）
• トラブルがインジェスト、再生、またはその両方に影響しているか
• 影響を受けている視聴者が1人なのか複数なのか
• 必要かつ許可されている場合は、影響を受けた視聴者のグローバルIPアドレス
• エンコーダーまたはプレイヤーのエラーメッセージおよび関連ログ
• 別のプレイヤー・デバイス・エンコーダー・ネットワークでの結果
• 利用可能であればFFmpegまたはFFplayの出力

クレデンシャル、ストリームキー、トークン、または認証に関する機密情報をマスキングせずに共有しないでください。