Configuration Issues for LiveStream Resources
liveStream リソースの status.healthStatus.configurationIssues[] オブジェクトには、ストリームに影響する構成の問題のリストが含まれます。この情報は、ライブ配信の動画の品質に影響する問題を特定、診断、解決するうえで役立ちます。
このドキュメントでは、API レスポンスで参照される可能性がある構成の問題の種類を示します。それぞれの問題で、問題の種類、エラーの簡単な説明、さらにはエラーの修正方法を説明する情報を含む長い説明を指定します。
構成に関する問題
下の表に、ライブ動画ストリームに影響を与える可能性のある設定の問題を示します。左の列には問題の種類、右の列には問題の解決方法の詳細が表示されます。
説明には変数が含まれているものがあり、変数には実際のライブ配信に関するデータが入力されます。以下の説明では、<code> スタイルのテキスト（%(actual_gop).1f など）が、各ライブ配信用にカスタマイズされたエラー メッセージの一部を表しています。コードには、左側の列にある問題の種類を簡潔に入力する必要があります。
| 設定に関する問題 |
audioBitrateHigh |
| 理由: | 音声の設定を確認してください |
| 説明: | 音声ストリームの現在のビットレート（%(actual)）が推奨ビットレートよりも高くなっています。オーディオ ストリーム ビットレートは %(expected)s を使用することをおすすめします。 |
|
audioBitrateLow |
| 理由: | 音声の設定を確認してください |
| 説明: | 音声ストリームの現在のビットレート (%(actual)s) が推奨ビットレートよりも低くなっています。オーディオ ストリーム ビットレートは %(expected)s を使用することをおすすめします。 |
|
audioBitrateMismatch |
| 理由: | セカンダリ ストリームを確認してください |
| 説明: | 現在の設定では、動画のメイン ストリームとバックアップ ストリームの音声ビットレートが異なります。同じ音声ビットレートを使用するようにストリームを構成する必要があります。 |
|
audioCodec |
| 理由: | 音声の設定を確認してください |
| 説明: | 音声ストリームはサポートされていないコーデックによってエンコードされています。ストリームの音声コーデックを、サポートされているコーデック（AAC、MP3）に設定してください。 |
|
audioCodecMismatch |
| 理由: | セカンダリ ストリームの状態が不良です |
| 説明: | 現在の設定では、動画のメイン ストリームとバックアップ ストリームが異なるオーディオ コーデックを使用しています。同じオーディオ コーデックを使用するようにストリームを構成する必要があります。 |
|
audioSampleRate |
| 理由: | 音声の設定を確認してください |
| 説明: | 現在のサンプルレートは %(actual) です。推奨サンプルレートは 44.1 kHz と 48 kHz です。 |
|
audioSampleRateMismatch |
| 理由: | セカンダリ ストリームの状態が不良です |
| 説明: | 現在の設定では、動画のメイン ストリームとバックアップ ストリームの音声サンプルレートが異なります。同じ音声サンプルレートになるようにストリームを構成する必要があります。 |
|
audioStereoMismatch |
| 理由: | セカンダリ ストリームの状態が不良です |
| 説明: | 現在の設定では、動画のメイン ストリームと代替ストリームの音声チャンネルが異なっています。これらのストリームに同じ音声チャンネルを設定する必要があります。 |
|
audioTooManyChannels |
| 理由: | 音声の設定を確認してください |
| 説明: | 音声に 3 つ以上のチャンネルがありますが、1 つ（モノラル）または 2 つ（ステレオ）のチャンネルのみがサポートされます。音声チャンネルの数を修正してください。 |
|
badContainer |
| 理由: | 動画の設定が不良です |
| 説明: | 動画のコンテナ形式を変更してください。この構成では、現在のコンテナの形式が正しくありません。 |
|
bitrateHigh |
| 理由: | 動画の設定を確認してください |
| 説明: | ストリームの現在のビットレート (%(actual)s) が推奨ビットレートよりも高くなっています。ストリームのビットレートは %(expected)s を使用することをおすすめします。 |
|
bitrateLow |
| 理由: | 動画の出力が低すぎます |
| 説明: | ストリームの現在のビットレート (%(actual)s) が推奨値より低くなっています。ストリームのビットレートは %(expected)s を使用することをおすすめします。 |
|
framerateMismatch |
| 理由: | セカンダリ ストリームを確認してください |
| 説明: | 現在の設定では、動画のメイン ストリームとバックアップ ストリームのフレームレートが異なります。同じフレームレートになるようにストリームを構成する必要があります。 |
|
frameRateHigh |
| 理由: | フレームレートが高すぎます |
| 説明: | 現在のフレームレートが高すぎます。フレームレートを %(framerate)s fps 以下に設定してください。 |
|
gopMismatch |
| 理由: | セカンダリ ストリームの状態が不良です |
| 説明: | 現在の設定では、動画のメイン ストリームとバックアップ ストリームのキーフレーム間隔が異なります。ストリームのキーフレーム間隔が同じになるように構成する必要があります。 |
|
gopSizeLong |
| 理由: | 動画の設定が不良です |
| 説明: | 4 秒以下のキーフレーム間隔を使用してください。現在、キーフレーム間隔が長すぎるためバッファリングが発生します。現在のキーフレーム間隔は %(actual_gop).1f 秒です。取り込みエラーが発生すると、誤った GOP（Group of Pictures）サイズになってしまう可能性があります。 |
|
gopSizeOver |
| 理由: | 動画の設定を確認してください |
| 説明: | 4 秒以下のキーフレーム間隔を使用してください。現在、キーフレーム間隔が長すぎるためバッファリングが発生する可能性があります。現在のキーフレーム間隔は %(actual_gop).1f 秒です。取り込みエラーが発生すると、誤った GOP（Group of Pictures）サイズになってしまう可能性があります。 |
|
gopSizeShort |
| 理由: | 動画の設定を確認してください |
| 説明: | GOP（Group of Pictures）サイズが非常に小さいため、画像の品質が低下する可能性があります。推奨されるキーフレーム間隔は 4 秒です。現在のキーフレーム間隔は %(actual_gop).1f 秒です。取り込みエラーが発生すると、誤った GOP サイズになってしまう可能性があります。 |
|
multipleAudioStreams |
| 理由: | 音声の設定を確認してください |
| 説明: | 取り込みストリームに複数の音声ストリームが含まれています。含めることができる音声ストリームは 1 つのみです。 |
|
multipleVideoStreams |
| 理由: | 動画の設定が不良です |
| 説明: | 取り込みストリームに複数の動画ストリームが含まれています。含めることができる音声ストリームは 1 つのみです。 |
|
noAudioStream |
| 理由: | 音声がない |
| 説明: | 取り込みストリームに音声ストリームが含まれていません。1 つの音声ストリームを含める必要があります。 |
|
noVideoStream |
| 理由: | 動画がありません |
| 説明: | 取り込みストリームに動画ストリームが含まれていません。1 つの音声ストリームを含める必要があります。 |
|
openGop |
| 理由: | 動画の設定が不良です |
| 説明: | 動画エンコーダの設定を「クローズされた写真グループ（GOP）」に変更してください。「オープン GOP」に設定されているようですが、YouTube ではサポートされていません。 |
|
resolutionMismatch |
| 理由: | セカンダリ ストリームの状態が不良です |
| 説明: | 現在の設定では、動画のメイン ストリームとバックアップ ストリームの解像度が異なります。ストリームの解像度が同じになるように構成する必要があります。 |
|
videoBitrateMismatch |
| 理由: | セカンダリ ストリームを確認してください |
| 説明: | 現在の設定では、動画のメイン ストリームとバックアップ ストリームのビットレートが異なります。ストリームの動画ビットレートが同じになるように設定する必要があります。 |
|
videoCodec |
| 理由: | 動画の設定が不良です |
| 説明: | 動画はサポートされていないコーデックによってエンコードされています。ストリームの動画コーデックを、サポートされているコーデック（H.264）に設定してください。 |
|
videoCodecMismatch |
| 理由: | セカンダリ ストリームの状態が不良です |
| 説明: | 現在の設定では、動画のメイン ストリームとバックアップ ストリームが異なる動画コーデックを使用しています。同じ動画コーデックが含まれるようにストリームを設定する必要があります。 |
|
videoIngestionStarved |
| 理由: | 動画の出力が低すぎます |
| 説明: | スムーズなストリーミングを維持するのに十分な動画が YouTube に届いていません。そのため、視聴者はバッファリングを経験します。 |
|
videoInterlaceMismatch |
| 理由: | セカンダリ ストリームの状態が不良です |
| 説明: | 現在の設定では、動画のメイン ストリームとバックアップ ストリームのインターレースが異なります。ストリームが同じインターレースを持つように構成する必要があります。 |
|
videoProfileMismatch |
| 理由: | セカンダリ ストリームの状態が不良です |
| 説明: | 現在の設定では、動画のメイン ストリームとバックアップ ストリームのプロフィールが異なります。ストリームが同じプロファイルを持つように構成する必要があります。 |
|
videoResolutionSuboptimal |
| 理由: | 解像度を確認してください |
| 説明: | 動画の解像度を確認してください。現在の解像度は (%(actual_w)dx%(actual_h)d) で、最適ではありません。 |
|
videoResolutionUnsupported |
| 理由: | サポートされていない解像度です |
| 説明: | 動画の解像度を変更する必要があります。現在の解像度は (%(actual_w)dx%(actual_h)d) ですが、この構成ではサポートされていません。予想される動画の解像度は (%(expected_w)dx%(expected_h)d) です。 |
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2023-02-22 UTC。
[null,null,["最終更新日 2023-02-22 UTC。"],[[["The `status.healthStatus.configurationIssues[]` object in a liveStream resource identifies configuration problems affecting the quality of live video streams, and is used for troubleshooting."],["The document lists various configuration issues that can affect live video streams, detailing the issue type, a brief error description, and an explanation of how to rectify it."],["Configuration issues are categorized into different types, including problems with audio, video, bitrate, framerate, codecs, keyframe frequencies, and inconsistencies between primary and backup streams."],["Many descriptions of the configuration issues include variables, like `%(actual)` or `%(expected)s`, which are customized to reflect the specific details of each live stream's errors."],["Resolutions are based on the \"issue type\", for example: `audioBitrateLow`, `bitrateHigh`, `gopSizeLong`, allowing developers to build solutions based on these type of errors."]]],["Live streams may have configuration issues that impact quality. The `configurationIssues` object lists these problems, detailing the issue type, a short description, and a longer explanation for resolution. Issues include bitrate, codec, sample rate, and channel problems for audio; and bitrate, framerate, GOP, resolution, and codec issues for video. Mismatches between primary and backup streams are also noted. Actions to take involve checking settings, ensuring correct formats, and matching properties between streams.\n"]]
