推流SDK異常自助排查 - ApsaraVideo Live

本文介紹推流 SDK 出現異常時的自助排查思路和操作步驟，協助使用者高效定位和解決常見問題。

控制台操作指引

您可以通過控制台自助問題排查功能發現並解決直播流相關的問題。

ApsaraVideo for Live控制台提供了直播管理、應用管理、資料中心和工具箱功能模組的配置與使用。有關詳細資料，請參考以下：

常見問題

若配置License時遇到問題，請參見License相關常見問題。
若推流產生問題，您可以使用自助問題排查功能對推流地址進行檢測，檢測推流地址是否有效。

支援人員

如果按照上述流程依然無法解決您的問題，您可以提交工單以擷取支援人員。有關詳細資料，請參考聯絡我們文檔。

在擷取支援人員時，請務必提供以下資訊，以便提升支援人員效率：

專案	詳細說明	備忘
問題簡述	請用一句話簡要描述你遇到的問題	-
問題描述	業務情境（如基礎直播、互動直播等）。 SDK類型及版本號碼。問題發生階段（如整合、上線等）。詳細現象與類型（如斷流、無畫面、無聲音等）。複現步驟（如必現/偶現，具體操作步驟）。問題分布情況（平台、系統版本、機型、地區等）。	License問題請備忘應用程式套件名和License Key。建議您使用最新的SDK版本，以獲得更好的支援。
問題上下文	發生問題時的具體環境說明。推/拉流地址（請脫敏）。問題發生時間點。日誌（logcat/檔案日誌等，建議打包上傳）。配置資訊（如App名、包名、連麥配置等）。其他資料（如錄屏/截圖等）。	抓日誌前請先通過日誌介面（AlivcLiveBase類）開啟檔案日誌功能，可參考 Demo 中相關設定方法。建議關閉直播後再抓取日誌。日誌擷取路徑： Android：/sdcard/Android/data/${app_id}/files/ iOS：沙箱目錄下在直播連麥情境中，請提供以下資訊：主播推流地址（包括應用 ID、房間號、使用者識別碼）一般觀眾拉流地址（包括旁路轉推中配置的播放網域名稱）
補充資訊	是否有相關錯誤提示（如有請註明錯誤碼/錯誤資訊）。異常發生時是否可自動回復（如自動重連）。其它可協助定位問題的資訊。

問題描述填寫規範

標準問題範本

問題標題：（一句話概述問題現象）
業務情境：（如 基礎直播 / 互動直播 / 低延遲直播 等）
SDK 及版本號碼：（如 AlivcLivePusher: x.y.z 或 AlivcLivePusher_Interactive: x.y.z）
應用程式名稱/包名：（如 LiveExample / com.example.liveapp）

問題類型及表現：（如 偶爾斷流 / 無法拉流 / 無畫面等，請簡要描述具體現象）
複現機率：（如 偶發 / 必現）
詳細複現步驟：
1. 
2. 
3. 
影響使用者/裝置分布：（如 Android 9 及以下 / iOS / 特定地區等）

推流地址：（請粘貼完整推流 URL）
拉流地址：（如有，請填寫）
發生時間：（請註明具體時間，或多次發生時請舉例）
網路環境：（如 Wi-Fi/4G/5G/有線網路）
問題日誌：（如 logcat 日誌、推流/拉流日誌等，建議打包壓縮上傳）
錄屏/截圖：（如有異常現象錄屏或關鍵截圖請上傳）
推流參數配置：（如解析度、幀率、碼率等）

是否有相關錯誤提示：（如有報錯，請提供錯誤碼或提示資訊）
異常發生時是否自動回復：（如自動重連，需描述重連結果）
其它備忘：（任何你認為有協助的資訊）

基礎直播問題樣本

問題標題：基礎直播推流過程中偶爾斷流
業務情境：基礎直播
SDK 及版本號碼：AlivcLivePusher: x.y.z
應用程式名稱/包名：LiveExample / com.example.liveapp

問題類型及表現：推流過程中，每隔約 30 分鐘偶發斷流，需手動重新推流
複現機率：偶發
詳細複現步驟：
1. 啟動推流
2. 30 分鐘左右發生斷流
3. 需重啟推流恢複
影響使用者/裝置分布：Android 9 及以下，多個機型，東南亞地區較多

推流地址：rtmp://test.alivecdn.com/live/streamId?auth_key=XXX
發生時間：2024-05-18 12:34
網路環境：4G
問題日誌：見附件 logcat_20240518.zip
錄屏/截圖：見附件
推流參數配置：解析度 720p，碼率 1500kbps，幀率 30fps

是否有相關錯誤提示：無報錯提示
異常發生時是否自動回復：無，需手動重推
其它備忘：無

互動直播問題樣本

問題標題：直播連麥 CDN 觀眾無法接收到主播畫面
業務情境：直播連麥，AUI Kits 互動直播
SDK 及版本號碼：AlivcLivePusher_Interactive: x.y.z
應用程式名稱/包名：LiveExample / com.example.liveapp

問題類型及表現：主播端正常推流，連麥觀眾端可以正常拉流，CDN 觀眾端始終無法看到主播畫面，無任何錯誤提示
複現機率：必現
詳細複現步驟：
1. 主播端啟動互動直播並推流
2. 連麥觀眾端正常收到主播畫面
3. CDN 觀眾端（Android/iOS 端）進入直播間，始終無法看到主播畫面
影響使用者/裝置分布：Android 和 iOS 端均必現

推流地址：artc://live.aliyun.com/push/633?timestamp=1685094092&token=fe4e674ade****6686&userId=718&sdkAppId=xxx
拉流地址：rtmp://test.alivecdn.com/live/xxx_633_718_camera?auth_key=XXX
配置資訊：房間號 633，應用ID xxx，使用者ID 718，播放網域名稱 test.alivecdn.com
發生時間：2024-05-18 12:34
網路環境：Wi-Fi
問題日誌：見附件 logcat_20240518.zip
錄屏/截圖：見附件
推流參數配置：解析度 720p，碼率 1200kbps，幀率 20fps

是否有相關錯誤提示：無
異常發生時是否自動回復：否，需關閉推流重新啟動
其它備忘：觀眾端未見任何提示，切換不同網路/裝置均無效

ApsaraVideo Live：推流SDK異常自助排查

相關文檔參考