トラブルシューティング

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

このページでは、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 動画コーデックと JPEG 音声コーデックのみを送信するようにします。

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)フィールドで構成されているすべての音声トラックを送信していることを確認します。