トラブルシューティング

このページでは、Live Stream API に関する問題を解決する方法について説明します。このページに表示されるエラーは、Live Stream API に固有のものです。Google APIs の一般的なエラーについては、Cloud APIs のエラーのページをご覧ください。

入力ストリームが拒否されました

エンコーダが入力エンドポイントに入力ストリームを送信しても、接続が拒否される場合は、次の問題があるかどうかを確認してください。

無効な入力エンドポイント URI

エンコーダが、無効な入力エンドポイント URI に入力ストリームを送信すると、エラーが発生します。

この問題を解決するには、正しい IP アドレスと STREAM-ID を使用して入力ストリームを入力エンドポイント URI に送信するようにエンコーダが構成されていることを確認します。

入力がチャネルに接続されていません

エンコーダが、チャンネルに接続されていない入力エンドポイント URI に入力ストリームを送信すると、エラーが発生します。

この問題を解決するには、入力エンドポイントを使用して新しいチャネルを作成します。入力エンドポイントがチャネルに正常に接続されているかどうかを確認するには、チャネルの詳細を取得し、inputAttachments フィールドで入力エンドポイントの名前を探します。

チャネルがアクティブでありません

エンコーダが、実行されていないチャネルに入力ストリームを送信すると、エラーが発生します。

この問題を解決するには、チャネルのステータスを確認して、streamingStateAWAITING_INPUT であることを確認します。チャネルの streamingStateSTOPPED の場合は、チャネルを開始します。

別のエンコーダが同じ入力エンドポイントにすでに接続されている

複数のエンコーダが同じ入力エンドポイントに入力ストリームを送信しようとすると、エラーが発生します。入力エンドポイント URI ごとに一度に受け入れられる接続は 1 つのみです。

この問題を解決するには、チャネルがすでに STREAMING 状態かどうかを確認します。その場合は、次の方法があります。

  • 2 番目の入力ストリーム用に個別の入力エンドポイントとチャネルを作成します。

  • 同じ入力エンドポイントに別の入力ストリームを送信する前に、最初の入力ストリームを停止します。

エンコーダの IP アドレスが許可された IP 範囲にない

エンコーダが、入力エンドポイント用に構成された指定された IP 範囲外の IP アドレスから入力ストリームを送信すると、エラーが発生します。

この問題を解決するには、入力エンドポイントの詳細を取得し、securityRules フィールドを確認します。ipRanges が指定されている場合は、エンコーダにそれらの IP 範囲内の有効な IP アドレスがあることを確認します。

Cloud Storage バケットに出力ファイルがない

エンコーダが入力エンドポイントに入力ストリームを正常に送信しても、Cloud Storage バケットに出力ファイルが表示されない場合は、次の問題があるかどうかを確認してください。

正しくない Cloud Storage バケット

間違った Cloud Storage バケットを確認している場合、出力ファイルが欠落している可能性があります。

この問題を解決するには、ライブ ストリームのチャネルの詳細を取得します。output.uri フィールドで、正しい Cloud Storage バケット URI を確認します。

無効な入力動画/音声コーデック

エンコーダから送信されている動画または音声コーデックが無効な場合、出力ファイルが見つからないことがあります。

この問題を解決するには、エンコーダが H264 動画コーデックと AAC 音声コーデックのみを送信していることを確認します。

Cloud Storage 権限が拒否されました

デフォルトでは、Live Stream API は、Live Stream API リソースをホストする同じGoogle Cloud プロジェクト内に Cloud Storage バケットにアクセスできるサービス アカウントを作成します。このサービス アカウントが Cloud Storage バケットへのアクセス権を失うと、出力ファイルが欠落する可能性があります。

この問題を解決するには、サービス アカウントに十分な権限があることを確認してください。出力ファイルの作成が失敗する理由は次のとおりです。

  • 出力 Cloud Storage バケットは、Live Stream API リソース(チャネルや入力エンドポイントなど)とは異なる Google Cloud プロジェクトにあります。

  • デフォルトの権限がサービス アカウントから取り消されます。

詳細については、Cloud Storage へのアクセスをご覧ください。

音声トラックがない

音声トラックが欠落している入力ストリームをエンコーダが送信すると、出力ファイルが見つからないことがあります。動画パイプラインは、すべての音声トラックが到着するまで待ってから処理を開始します。

この問題を解決するには、ライブ ストリームのチャネルの詳細を取得します。ElementaryStream.audioStream.mappingAudioMapping)フィールドで設定されているすべての音声トラックをエンコーダが送信していることを確認します。