本頁說明如何解決 Live Stream API 的問題。本頁面顯示的錯誤是 Live Stream API 專屬錯誤。如要瞭解 Google API 中的一般錯誤,請參閱 Cloud API 的「錯誤」頁面。
輸入串流遭拒
如果編碼器將輸入串流傳送至輸入端點,但連線一直遭到拒絕,請檢查以下可能的問題:
輸入端點 URI 無效
如果編碼器將輸入串流傳送至無效的輸入端點 URI,就會發生錯誤。
如要解決這個問題,請檢查編碼器是否已設定為將輸入串流傳送至輸入端點 URI,並使用正確的 IP 位址和 STREAM-ID
。
輸入內容未連結至管道
如果編碼器將輸入串流傳送至未附加至頻道的輸入端點 URI,就會發生錯誤。
如要解決這個問題,請使用輸入端點建立新管道。如要確認輸入端點是否已成功連結至管道,請取得管道詳細資料,然後在 inputAttachments
欄位中尋找輸入端點的名稱。
閒置頻道
如果編碼器將輸入串流傳送至未執行的頻道,就會發生錯誤。
如要解決這個問題,請檢查管道狀態,確認其 streamingState
為 AWAITING_INPUT
。如果管道的 streamingState
為 STOPPED
,請啟動管道。
另一個編碼器已連結至相同的輸入端點
如果多個編碼器嘗試將輸入串流傳送至相同的輸入端點,就會發生錯誤。每個輸入端點 URI 一次只能接受一個連線。
如要解決這個問題,請檢查管道是否已處於 STREAMING
狀態。如有,您可以選擇下列做法:
為第二個輸入串流建立個別的輸入端點和管道。
請先停止第一個輸入串流,再將另一個輸入串流傳送至相同的輸入端點。
編碼器 IP 位址不在允許的 IP 範圍內
如果編碼器從為輸入端點設定的指定 IP 範圍以外的 IP 位址傳送輸入串流,就會發生錯誤。
如要解決這個問題,請取得輸入端點的詳細資料,並檢查 securityRules
欄位。如果有指定的 ipRanges
,請確認編碼器在這些 IP 範圍內有有效的 IP 位址。
Cloud Storage 值區中缺少輸出檔案
如果編碼器成功將輸入串流傳送至輸入端點,但 Cloud Storage 值區中沒有任何輸出檔案,請檢查以下可能的問題:
Cloud Storage 值區不正確
如果檢查的 Cloud Storage 值區不正確,可能會遺漏輸出檔案。
如要解決這個問題,請取得直播的管道詳細資料。檢查 output.uri
欄位是否有正確的 Cloud Storage 值區 URI。
無效的輸入影片/音訊編解碼
如果編碼器傳送的視訊或音訊編解碼器無效,可能會缺少輸出檔案。
如要解決這個問題,請確認編碼器只傳送 H264 視訊和 AAC 音訊編碼器。
Cloud Storage 權限遭拒
根據預設,Live Stream API 會建立服務帳戶,讓該帳戶可存取代管 Live Stream API 資源的同一個 Google Cloud 專案中的 Cloud Storage 值區。如果這個服務帳戶失去存取 Cloud Storage 值區的權限,可能會缺少輸出檔案。
如要解決這個問題,請確認服務帳戶具備足夠的權限。建立輸出檔案可能會失敗,原因如下:
輸出 Cloud Storage 值區位於不同的 Google Cloud專案中,與頻道和輸入端點等 Live Stream API 資源不同。
系統會從服務帳戶撤銷預設權限。
詳情請參閱「Cloud Storage 存取權」。
找不到音軌
如果編碼器傳送的輸入串流缺少音訊音軌,輸出檔案可能會遺失。影片管道會等到所有音訊軌道都到達後,才開始處理。
如要解決這個問題,請取得直播的管道詳細資料。請確認編碼器會傳送 ElementaryStream.audioStream.mapping
(AudioMapping
) 欄位中設定的所有音軌。