疑難排解

本頁說明如何解決 Live Stream API 的問題。本頁面顯示的錯誤是 Live Stream API 專屬錯誤。如要瞭解 Google API 中的一般錯誤,請參閱 Cloud API 的「錯誤」頁面。

輸入串流遭拒

如果編碼器將輸入串流傳送至輸入端點,但連線一直遭到拒絕,請檢查以下可能的問題:

輸入端點 URI 無效

如果編碼器將輸入串流傳送至無效的輸入端點 URI,就會發生錯誤。

如要解決這個問題,請檢查編碼器是否已設定為將輸入串流傳送至輸入端點 URI,並使用正確的 IP 位址和 STREAM-ID

輸入內容未連結至管道

如果編碼器將輸入串流傳送至未附加至頻道的輸入端點 URI,就會發生錯誤。

如要解決這個問題,請使用輸入端點建立新管道。如要確認輸入端點是否已成功連結至管道,請取得管道詳細資料,然後在 inputAttachments 欄位中尋找輸入端點的名稱。

閒置頻道

如果編碼器將輸入串流傳送至未執行的頻道,就會發生錯誤。

如要解決這個問題,請檢查管道狀態,確認其 streamingStateAWAITING_INPUT。如果管道的 streamingStateSTOPPED,請啟動管道

另一個編碼器已連結至相同的輸入端點

如果多個編碼器嘗試將輸入串流傳送至相同的輸入端點,就會發生錯誤。每個輸入端點 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) 欄位中設定的所有音軌。