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.1kHz 和 48kHz。
audioSampleRateMismatch
原因：次要串流設定有誤
說明：在目前設定中，影片的主要串流和備份串流的取樣率不同。您必須將串流設定為相同的音訊取樣率。
audioStereoMismatch
原因：次要串流設定有誤
說明：在目前設定中，影片的主要串流和備份串流使用不同的聲道。你必須修改設定，使兩者的聲道一致。
audioTooManyChannels
原因：檢查音訊設定
說明：音訊提供超過兩個聲道，但僅支援單聲道 (單聲道) 或兩個立體聲頻道。請更正音訊的聲道數。
badContainer
原因：視訊設定有誤
說明：請變更影片的容器格式。目前的容器格式不正確。
bitrateHigh
原因：檢查視訊設定
說明：串流目前的位元率 (%(actual)s) 高於建議的位元率。我們建議您使用 %(expected)s 的串流位元率。
bitrateLow
原因：視訊輸出速度過低
說明：串流目前的位元率 (%(actual)s) 低於建議的位元率。我們建議您使用 %(expected)s 的串流位元率。
framerateMismatch
原因：檢查次要串流
說明：在目前設定中，影片的主要串流和備份串流的影格速率不同。您必須將串流設定為相同的影格速率。
frameRateHigh
原因：畫面播放速率過高
說明：目前的影格速率過高。請將畫面更新率設為每秒畫格數 %(framerate)s 以下。
gopMismatch
原因：次要串流設定有誤
說明：在目前設定中，影片的主要串流和備份串流的主影格頻率不同。您必須設定串流的主影格頻率相同。
gopSizeLong
原因：視訊設定有誤
說明：請將主影格頻率設為四秒以下。目前的主畫面頻率 (X 秒) 過低，目前的主影格頻率為 %(actual_gop).1f 秒。請注意，如果發生內容擷取錯誤，可能會導致 GOP (圖片組) 大小錯誤。
gopSizeOver
原因：檢查視訊設定
說明：請將主影格頻率設為四秒以下。目前的主影格傳送頻率過低，因此可能造成緩衝處理的情況。目前的主影格頻率為 %(actual_gop).1f 秒。請注意，如果發生內容擷取錯誤，可能會導致 GOP (圖片組) 大小錯誤。
gopSizeShort
原因：檢查視訊設定
說明：GOP (畫面群) 大小過小時，可能會降低影像品質。建議的主影格頻率為四秒，目前的主影格頻率為 %(actual_gop).1f 秒。請注意，如果發生內容擷取錯誤，可能會導致 GOP 大小錯誤。
multipleAudioStreams
原因：檢查音訊設定
說明：內容攝入串流中只能有一個音訊串流，但這個內容攝入串流含有多個音訊串流。
multipleVideoStreams
原因：視訊設定有誤
說明：內容攝入串流中只能有一個視訊串流，但這個內容攝入串流含有多個視訊串流。
noAudioStream
原因：影片沒有音訊
說明：內容攝入串流中必須含有一個音訊串流，但這個內容攝入串流中沒有任何音訊串流。
noVideoStream
原因：沒有視訊
說明：內容攝入串流中必須含有一個視訊串流，但這個內容攝入串流中沒有任何視訊串流。
openGop
原因：視訊設定有誤
說明：請將影片編碼器的設定變更為「封閉式圖片組 (GOP)」。YouTube 似乎不支援「開放式 GOP」，
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)。