全部產品
Search
文件中心

ApsaraVideo Live:錯誤碼列表

更新時間:Jan 21, 2026

通過閱讀本文,您可以瞭解即時音視頻SDK常見的錯誤碼及對應解決方案。

錯誤碼列表

十六進位

十進位

錯誤描述

原因分析

解決方案

0x01010301

16843521

already joint

使用者已經加入房間。

檢查介面調用邏輯。

0x02010903

33622275

failed to join channel due to invalid channel profile

channel profile不匹配,如第一個人以通訊模式入會,之後如果有人以互動模式入會就會報此錯。

重新檢查使用者入會模式和其他使用者的入會模式(頻道模式)是否一致。

0x05040002

84148226

channel is overdue

  • 使用者欠費了。

  • 使用者的Token到期了,可以通過timestamp參數判斷。

  • appid,appkey不對,或者不對應,一個appid對應唯一的一個appkey。

  • 使用者的鑒權參數錯誤。

排查以下情況:

  • 確認賬戶餘額是否充足。

  • 確認Token是否到期,可以通過timestamp參數判斷,轉成北京時間。第一種情況本身就是到期時間,第二種是本身+48小時是到期時間。

  • AppId和AppKey不匹配,一個AppId對應唯一的AppKey。

  • 確認鑒權參數是否正確。

0x02010702

33621762

join channel failed due to same user repeat join,please check if another device still in the channel

使用者重複入會失敗。如同一個使用者,使用兩個裝置,進入同一個會。或者該使用者上一個session還沒有退會完成。

檢查介面調用邏輯。

0x02010104

33620228

session join

用戶端離開頻道了之後又使用了相同的sessionId入會。

請嘗試重新加入頻道。

0x02010204

33620484

channel is not exist

加入頻道失敗,頻道不存在。如會議發起者入會後又很快離會,第二個人隨後入會,發現會議已經不存在了。

請嘗試重新加入頻道。

0x02010201

33620481

bad appid

appid不存在。

請檢查環境、控制台是否存在此appid。

0x02010202

33620482

invaild appid

appid失效。

請檢查控制台appid當前的狀態。

0x02010203

33620483

bad channel

channel不可建立或建立失敗。

請檢查channelid的命名或重試。

0x02010205

33620485

bad token

計算的token與RTC服務計算的token不一致。

  • 使用相同的參數用阿里雲提供的範例程式碼運行後進行對比驗證。

  • 請檢查鑒權使用的各個參數與傳入SDK的是否一致。

  • 請檢查使用的演算法是否正確。

0x01030101

16974081

bad param

參數不合法。

  • 使用相同的參數用阿里雲提供的範例程式碼運行後進行對比驗證。

  • 請檢查token計算時各個參數是否符合命名規範(字串長度、特殊字元等)。

  • 請檢查演算法是否正確。

0x05010011

83951633

join channel failed due to invaild channel id

gslb請求ChannelId無效。如ChannelId不能帶有空格。

檢查channelId(頻道ID)格式。

頻道ID支援1~64位,大小寫字母、數字、底線(_)、中劃線(-)。

0x05010012

83951634

join channel failed due to invaild user id

gslb請求UserId無效。

請嘗試重新加入頻道。

0x0501001a

83951642

join channel due to invaild channel id

AppId配置了大方會模式,需要使用1.16.5以上的包入會,否則會入會失敗。

檢查SDK版本。

0x01020201

16908801

signal request is timeout

gslb請求長時間未收到,導致響應逾時。

檢查網路連接是否正常。

0x01020204

16908804

join timeout

入會請求長時間未收到,導致響應逾時。

檢查網路連接是否正常。

0x01030202

16974338

join error

加入房間錯誤。

檢查鑒權資訊是否正確以及網路環境是否正常。

0x01030201

16974337

gslb error

參數AuthInfo中的gslb欄位錯誤。

檢查AuthInfo中gslb欄位是否完整,或驗證AuthInfo是否可以通過校正。

0x01040404

17040388

mic open fail

採集裝置初始化失敗,如裝置被佔用。

mac和windows可以查看系統設定裡面是否有能量條;

ios和android確認是否有其他應用佔用

如果都正常,請重啟下裝置。

0x01040405

17040389

speaker open fail

播放裝置初始化失敗。

mac和windows可以查看系統設定裡面是否有能量條;

ios和android確認是否有其他應用佔用

如果都正常,請重啟下裝置。

0x01040406

17040390

mic interrupt

裝置被其他應用佔用。

需要其他應用釋放。

0x01040407

17040391

speaker interrupt

裝置被其他應用佔用。

需要其他應用釋放。

0x01040408

17040392

mic auth fail

音頻採集裝置未授權。

提示使用者授權。

0x01040409

17040393

mic not available

無可用音頻採集裝置。

檢查系統中裝置是否存在;

檢查系統中裝置是否禁用。

0x01040410

17040400

speaker not available

無可用音頻播放裝置。

檢查系統中裝置是否存在;

檢查系統中裝置是否禁用。

0x01040104

17039620

camera open fail

視頻採集裝置初始化失敗。

檢查App是否佔用了相機。

0x01040106

17039622

camera interrupt

視頻採集裝置被強制中斷。

查看是否被其他應用佔用;

檢查裝置是否正常。

0x01040201

17039873

display open fail

渲染裝置初始化失敗。

windows裝置檢查下裝置顯卡驅動,移動端需要檢查下是否有裝置螢幕。

0x01040202

17039874

display interrupt

渲染裝置被打斷。

檢查系統驅動是否正常,如果都正常建議重啟裝置。

0x01030404

16974852

subscribe invalid

無效訂閱。

檢查是否對方已入會。

0x01010550

16844112

subscribe not joinchannel

未進入頻道訂閱失敗。

請先調用joinchannel API。

0x01010551

16844113

subscribe audio stream failed

訂閱的音頻流無效。

檢查對方是否存在訂閱的音頻流

檢查本端收到OnRemoteTrackAvailable裡面存在此音頻流。

0x01010552

16844114

subscribe video stream failed

訂閱的視頻流無效。

檢查對方是否存在訂閱的視頻流

檢查本端收到的OnRemoteTrackAvailable裡面存在此視頻流。

0x01070101

17236225

audio buffer full

調用自訂音頻採集功能介面向 SDK 內部送音頻流資料時,如果 SDK 內部 buffer 隊列飽和時會返回該錯誤碼。

建議降低外部輸入頻次,設定等待20ms,並且單次送入不超過40ms資料。

0x01070102

17236226

video buffer full

SDK 內部 buffer隊列飽和,用於外部輸送裸資料功能。

建議降低外部輸入頻次,設定等待視訊框架間隔後再輸入。