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 FPS 以下。
gopMismatch
原因：次要串流設定有誤
說明：在目前設定中，影片主要串流和備份串流的主影格頻率不同。您必須修改設定，使兩者的主影格頻率一致。
gopSizeLong
原因：視訊設定有誤
說明：請將主影格頻率設為四秒以下。目前的主畫面頻率 (X 秒) 過低，目前的主影格頻率為 %(actual_gop).1f 秒。請注意，如果發生內容擷取錯誤，可能會導致 GOP (圖片組) 大小錯誤。
gopSizeOver
原因：檢查視訊設定
說明：請將主影格頻率設為四秒以下。目前的主影格傳送頻率過低，因此可能造成緩衝處理的情況。目前的主影格頻率為 %(actual_gop).1f 秒。請注意，如果發生內容擷取錯誤，可能會導致 GOP (圖片組) 大小錯誤。
gopSizeShort
原因：檢查視訊設定
說明：GOP (畫面群) 大小過小時，可能會降低影像品質。建議的主畫面頻率為 4 秒，目前的主影格頻率為 %(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)。