トラブルシューティング

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

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

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

入力エンドポイントの URI が無効です

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

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

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

エンコーダがチャネルにアタッチされていない入力エンドポイント 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)フィールドで設定されているすべての音声トラックをエンコーダが送信していることを確認します。