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)