错误码--实时音视频-火山引擎

文档中心

实时音视频

Windows 3.60

错误码

UserMessageSendResult

enum bytertc::UserMessageSendResult

发送消息结果，成功或失败，及失败原因

枚举值

类型	值	说明
kUserMessageSendResultSuccess	0	发送消息成功。
kUserMessageSendResultTimeout	1	消息发送失败。发送超时。
kUserMessageSendResultNetworkDisconnected	2	消息发送失败。连接断开，消息未发出。
kUserMessageSendResultNoReceiver	3	消息发送失败。找不到接收方。
kUserMessageSendResultNoRelayPath	4	消息发送失败。远端用户没有登录或进房。
kUserMessageSendResultExceedQPS	5	消息发送失败。超过 QPS 限制。
kUserMessageSendResultE2BSSendFailed	17	消息发送失败。应用服务器未收到客户端发送的消息。由 `sendServerMessage`/`sendServerBinaryMessage` 触发，通过 `onServerMessageSendResult` 回调。
kUserMessageSendResultE2BSReturnFailed	18	消息发送失败。应用服务器接收到了客户端发送的消息，但响应失败。由 `sendServerMessage`/`sendServerBinaryMessage` 触发，通过 `onServerMessageSendResult` 回调。
kUserMessageSendResultNotJoin	100	消息发送失败。消息发送方没有加入房间。
kUserMessageSendResultInit	101	消息发送失败。连接未完成初始化。
kUserMessageSendResultNoConnection	102	消息发送失败。没有可用的数据传输通道连接。
kUserMessageSendResultExceedMaxLength	103	消息发送失败。消息超过最大长度 (64 KB)。
kUserMessageSendResultEmptyUser	104	消息发送失败。接收方用户 ID 为空。
kUserMessageSendResultNotLogin	105	消息发送失败。房间外或应用服务器消息发送方没有登录。
kUserMessageSendResultServerParamsNotSet	106	消息发送失败。发送消息给业务方服务器之前没有设置参数。
kUserMessageSendResultUnknown	1000	消息发送失败。未知错误。

SubtitleErrorCode

enum bytertc::SubtitleErrorCode

字幕任务错误码。

枚举值

类型	值	说明
kSubtitleErrorCodeUnknow	-1	客户端无法识别云端媒体处理发送的错误码。请联系技术支持。
kSubtitleErrorCodeSuccess	0	字幕已开启。
kSubtitleErrorCodePostProcessError	1	云端媒体处理内部出现错误，请联系技术支持。
kSubtitleErrorCodeASRConnectionError	2	第三方服务连接失败，请联系技术支持。
kSubtitleErrorCodeASRServiceError	3	第三方服务内部出现错误，请联系技术支持。
kSubtitleErrorCodeBeforeJoinRoom	4	未进房导致调用`startSubtitle`失败。请加入房间后再调用此方法。
kSubtitleErrorCodeAlreadyOn	5	重复调用 `startSubtitle`。
kSubtitleErrorCodeUnsupportedLanguage	6	用户选择的目标语言目前暂不支持。
kSubtitleErrorCodePostProcessTimeout	7	云端媒体处理超时未响应，请联系技术支持。

LocalVideoStreamError

enum bytertc::LocalVideoStreamError

本地视频状态改变时的错误码

枚举值

类型	值	说明
kLocalVideoStreamErrorOk	0	状态正常
kLocalVideoStreamErrorFailure	1	本地视频流发布失败
kLocalVideoStreamErrorDeviceNoPermission	2	没有权限启动本地视频采集设备
kLocalVideoStreamErrorDeviceBusy	3	本地视频采集设备已被占用
kLocalVideoStreamErrorDeviceNotFound	4	本地视频采集设备不存在
kLocalVideoStreamErrorCaptureFailure	5	本地视频采集失败，建议检查采集设备是否正常工作
kLocalVideoStreamErrorEncodeFailure	6	本地视频编码失败
kLocalVideoStreamErrorDeviceDisconnected	7	通话过程中本地视频采集设备被其他程序抢占，导致设备连接中断

MixedStreamTaskErrorCode

enum bytertc::MixedStreamTaskErrorCode

合流和 WTN 流任务错误码

枚举值

类型	值	说明
kMixedStreamTaskErrorCodeOK	0	推流成功。
kMixedStreamTaskErrorCodeTimeout	1091	任务处理超时，请检查网络状态并重试。
kMixedStreamTaskErrorCodeInvalidParamByServer	1092	服务端检测到错误的推流参数。
kMixedStreamTaskErrorCodeSubTimeoutByServer	1093	对流的订阅超时
kMixedStreamTaskErrorCodeInvalidStateByServer	1094	合流服务端内部错误。
kMixedStreamTaskErrorCodeAuthenticationByCDN	1095	合流服务端推 CDN 失败。
kMixedStreamTaskErrorCodeUnKnownByServer	1096	服务端未知错误。
kMixedStreamTaskErrorCodeSignalRequestTimeout	1097	服务端接收信令超时，请检查网络状态并重试。
kMixedStreamTaskErrorCodeMixImageFailed	1098	图片合流失败。
kMixedStreamTaskErrorCodePushWTNFailed	1195	发布 WTN 流失败

WarningCode

enum bytertc::WarningCode

回调警告码。

警告码说明 SDK 内部遇到问题正在尝试恢复。警告码仅起通知作用。

枚举值

类型	值	说明
kWarningCodeJoinRoomFailed	-2001	进房失败。通过 onRoomStateChanged 回调。当你调用初次加入房间或者由于网络状况不佳断网重连时，由于服务器错误导致进房失败。SDK 会自动重试进房。
kWarningCodePublishStreamFailed	-2002	发布音视频流失败。通过 onVideoPublishStateChanged、onAudioPublishStateChanged 回调。当你在所在房间中发布音视频流时，由于服务器错误导致发布失败。SDK 会自动重试发布。
kWarningCodeSubscribeStreamFailed404	-2003	订阅音视频流失败。通过 onVideoSubscribeStateChanged、onAudioSubscribeStateChanged 回调。当前房间中找不到订阅的音视频流导致订阅失败。SDK 会自动重试订阅，若仍订阅失败则建议你退出重试。
kWarningCodeSubscribeStreamFailed5xx	-2004	订阅音视频流失败。通过 onVideoSubscribeStateChanged、onAudioSubscribeStateChanged 回调。当你订阅所在房间中的音视频流时，由于服务器错误导致订阅失败。SDK 会自动重试订阅。
kWarningCodePublishStreamForbidden	-2009	当调用 `setUserVisibility` 将自身可见性设置为 false 后，再尝试发布流会触发此警告。通过 onVideoPublishStateChanged、onAudioPublishStateChanged 回调通知。
kWarningCodeSendCustomMessage	-2011	发送自定义广播消息失败，当前你未在房间中。
kWarningCodeUserNotifyStop	-2013	当房间内人数超过 500 人时，停止向房间内已有用户发送 `onUserJoined` 和 `onUserLeave` 回调，并通过广播提示房间内所有用户。通过 onRoomStateChanged 回调。
kWarningCodeUserInPublish	-2014	用户已经在其他房间发布过流，或者用户正在发布 WTN 流。通过 onVideoPublishStateChanged、onAudioPublishStateChanged 回调通知。
kWarningCodeInEchoTestMode	-2017	当前正在进行回路测试，该接口调用无效
kWarningCodeNoCameraPermission	-5001	摄像头权限异常，当前应用没有获取摄像头权限。
kWarningCodeNoMicrophonePermission	-5002	已在 3.33 版本中废弃，使用 MediaDeviceError.kMediaDeviceErrorDeviceNoPermission 代替。麦克风权限异常，当前应用没有获取麦克风权限。
kWarningCodeRecodingDeviceStartFailed	-5003	已在 3.33 版本中废弃，使用 MediaDeviceError.kMediaDeviceErrorDeviceFailure 代替。音频采集设备启动失败，当前设备可能被其他应用占用。
kWarningCodePlayoutDeviceStartFailed	-5004	已在 3.33 版本中废弃，使用 use MediaDeviceError.kMediaDeviceErrorDeviceFailure 代替。音频播放设备启动失败警告，可能由于系统资源不足，或参数错误。
kWarningCodeNoRecordingDevice	-5005	已在 3.33 版本中废弃，使用 MediaDeviceError.kMediaDeviceErrorDeviceNotFound 代替。无可用音频采集设备，请插入可用的音频采集设备。
kWarningCodeNoPlayoutDevice	-5006	已在 3.33 版本中废弃，使用 MediaDeviceError.kMediaDeviceErrorDeviceNotFound 代替。无可用音频播放设备，请插入可用的音频播放设备。
kWarningCodeRecordingSilence	-5007	已在 3.33 版本中废弃，使用 MediaDeviceWarning.kMediaDeviceWarningCaptureSilence 代替。当前音频设备没有采集到有效的声音数据，请检查更换音频采集设备。
kWarningCodeMediaDeviceOperationDenied	-5008	已在 3.33 版本中废弃，使用 MediaDeviceWarning.kMediaDeviceWarningOperationDenied 代替。媒体设备误操作警告。使用自定义采集时，不可调用内部采集开关，调用时将触发此警告。
kWarningCodeSetScreenAudioSourceTypeFailed	-5009	你需要在 publishStreamAudio 之前调用 `setScreenAudioSourceType` 设置屏幕音频采集类型。
kWarningCodeSetScreenAudioStreamIndexFailed	-5010	不支持在 publishStreamAudio 之后，通过 `setScreenAudioStreamIndex` 设置屏幕共享时的音频采集方式。
kWarningCodeInvalidVoicePitch	-5011	设置语音音高不合法
kWarningCodeInvalidAudioFormat	-5012	设置音频格式不合法
kWarningCodeInvalidCallForExtAudio	-5013	外部音频源新旧接口混用
kWarningCodeInvalidRemoteStreamKey	-5014	非法的远端流索引
kWarningCodeInvalidCanvasHandle	-6001	指定的内部渲染画布句柄无效。当你调用 setLocalVideoCanvas 时指定了无效的画布句柄，触发此回调。
kWarningLicenseFileExpired	-7001	鉴权文件失效，当检查鉴权文件状态时，本地文件与远端文件不一致会触发次警告。通过 onRoomStateChanged 回调。
kWarningInvaildSamiAppkeyORToken	-7002	音频技术 SDK 鉴权失效。联系技术支持人员。
kWarningInvaildSamiResourcePath	-7003	音频技术资源加载失败。传入正确的 DAT 路径，或联系技术支持人员。
kWarningLoadSamiLibraryFailed	-7004	音频技术库加载失败。使用正确的库，或联系技术支持人员。
kWarningInvaildSamiEffectType	-7005	音频技术不支持此音效。联系技术支持人员。

LoginErrorCode

enum bytertc::LoginErrorCode

登录结果

调用 login 登录的结果，会通过 onLoginResult 回调通知用户。

枚举值

类型	值	说明
kLoginErrorCodeSuccess	0	调用 `login` 方法登录成功
kLoginErrorCodeInvalidToken	-1000	调用 `login` 方法时使用的 Token 无效或过期失效，需要用户重新获取 Token。
kLoginErrorCodeLoginFailed	-1001	登录错误调用 `login` 方法时发生未知错误导致登录失败，需要重新登录。
kLoginErrorCodeInvalidUserId	-1002	调用 `login` 方法时传入的用户 ID 有问题。
kLoginErrorCodeServerError	-1003	调用 `login` 登录时服务端出错。
kLoginErrorCodeLimitedMode	-1004	当前为受限模式，禁止 `login` 登录。

RtsWarningCode

enum bytertc::RtsWarningCode

回调警告码。

警告码说明 SDK 内部遇到问题正在尝试恢复。警告码仅起通知作用。

枚举值

类型	值	说明
kRtsWarningCodeJoinRoomFailed	-2001	进房失败。当你调用初次加入房间或者由于网络状况不佳断网重连时，由于服务器错误导致进房失败。SDK 会自动重试进房。
kRtsWarningCodePublishStreamFailed	-2002	发布音视频流失败。当你在所在房间中发布音视频流时，由于服务器错误导致发布失败。SDK 会自动重试发布。
kRtsWarningCodeSendCustomMessage	-2011	发送自定义广播消息失败，当前你未在房间中。
kRtsWarningCodeUserNotifyStop	-2013	当房间内人数超过 500 人时，停止向房间内已有用户发送 `onUserJoined` 和 `onUserLeave` 回调，并通过广播提示房间内所有用户。
kRtsWarningCodeOldRoomBeenReplaced	-2016	新生成的房间已经替换了同样 roomId 的旧房间

NetworkDetectionStartReturn

enum bytertc::NetworkDetectionStartReturn

开始探测的返回值

startNetworkDetection 返回对象类型

枚举值

类型	值	说明
kNetworkDetectionStartReturnSuccess	0	成功开启网络探测。
kNetworkDetectionStartReturnParamErr	1	开始探测失败。参数错误，上下行探测均为 `false`，或期望带宽超过了范围 [100,10000]
kNetworkDetectionStartReturnStreaming	2	开始探测失败。失败原因为，本地已经开始推拉流
kNetworkDetectionStartReturnStarted	3	已经开始探测，无需重复开启
kNetworkDetectionStartReturnNotSupport	4	不支持该功能

KTVErrorCode

enum bytertc::KTVErrorCode

KTV 错误码。

枚举值

类型	值	说明
kKTVErrorCodeOK	0	成功。
kKTVErrorCodeAppidInValid	-3000	AppID 异常。
kKTVErrorCodeParasInValid	-3001	非法参数，传入的参数不正确。
kKTVErrorCodeGetMusicFailed	-3002	获取歌曲资源失败。
kKTVErrorCodeGetLyricFailed	-3003	获取歌词失败。
kKTVErrorCodeMusicTakedown	-3004	歌曲下架。
kKTVErrorCodeMusicDownload	-3005	歌曲文件下载失败。
kKTVErrorCodeMidiDownloadFailed	-3006	MIDI 文件下载失败。
kKTVErrorCodeSystemBusy	-3007	系统繁忙。
kKTVErrorCodeNetwork	-3008	网络异常。
kKTVErrorCodeNotJoinRoom	-3009	KTV 功能未加入房间。
kKTVErrorCodeParseData	-3010	解析数据失败。
kKTVErrorCodeDownloading	-3012	已在下载中。
kKTVErrorCodeInternalDomain	-3013	内部错误，联系技术支持人员。
kKTVErrorCodeInsufficientDiskSpace	-3014	下载失败，磁盘空间不足。清除缓存后重试。
kKTVErrorCodeMusicDecryptionFailed	-3015	下载失败，音乐文件解密失败，联系技术支持人员。
kKTVErrorCodeFileRenameFailed	-3016	下载失败，音乐文件重命名失败，请重试。
kKTVErrorCodeDownloadTimeOut	-3017	下载失败，下载超时，请重试。
kKTVErrorCodeClearCacheFailed	-3018	清除缓存失败，可能原因是文件被占用或者系统异常，请重试。
kKTVErrorCodeDownloadCanceled	-3019	取消下载。

ErrorCode

enum bytertc::ErrorCode

回调错误码。

枚举值

类型	值	说明
kErrorCodeInvalidToken	-1000	Token 无效。通过 onRoomStateChanged 回调。调用 joinRoom 进房时使用的 Token 参数有误或过期失效。需要重新获取 Token，并调用 updateToken 方法更新 Token。
kErrorCodeJoinRoom	-1001	加入房间错误。通过 onRoomStateChanged 回调。进房时发生未知错误导致加入房间失败。需要用户重新加入房间。
kErrorCodeNoPublishPermission	-1002	没有发布音视频流权限。通过 onVideoPublishStateChanged、onAudioPublishStateChanged 回调通知。用户在所在房间中发布音视频流失败，失败原因为用户没有发布流的权限。
kErrorCodeNoSubscribePermission	-1003	没有订阅音视频流权限。通过 onVideoSubscribeStateChanged、onAudioSubscribeStateChanged 回调。用户订阅所在房间中的音视频流失败，失败原因为用户没有订阅流的权限。
kErrorCodeDuplicateLogin	-1004	相同用户 ID 的用户加入本房间，当前用户被踢出房间。通过 onRoomStateChanged 回调。
kErrorCodeKickedOut	-1006	服务端调用 OpenAPI 将当前用户踢出房间。通过 onRoomStateChanged 回调。
kRoomErrorTokenExpired	-1009	Token 过期。加入房间后 Token 过期时，返回此错误码。需使用新的 Token 重新加入房间。通过 onRoomStateChanged 回调。
kRoomErrorUpdateTokenWithInvalidToken	-1010	调用 `updateToken` 传入的 Token 无效。通过 onRoomStateChanged 回调。
kErrorCodeRoomDismiss	-1011	服务端调用 OpenAPI 解散房间，所有用户被移出房间。通过 onRoomStateChanged 回调。
kErrorCodeRoomAlreadyExist	-1013	通话回路检测已经存在同样 roomId 的房间了。通过 onRoomStateChanged 回调。
kErrorCodeUserIDDifferent	-1014	加入多个房间时使用了不同的 uid。通过 onRoomStateChanged 回调。同一个引擎实例中，用户需使用同一个 uid 加入不同的房间。
kErrorCodeJoinRoomRoomForbidden	-1025	房间被封禁。通过 onRoomStateChanged 回调。
kErrorCodeJoinRoomUserForbidden	-1026	用户被封禁。通过 onRoomStateChanged 回调。
kErrorCodeOverStreamSubscribeLimit	-1070	订阅音视频流失败，订阅音视频流总数超过上限。通过 onVideoSubscribeStateChanged、onAudioSubscribeStateChanged 回调。游戏场景下，为了保证音视频通话的性能和质量，服务器会限制用户订阅的音视频流总数。当用户订阅的音视频流总数已达上限时，继续订阅更多流时会失败，同时用户会收到此错误通知。
kErrorCodeOverStreamPublishLimit	-1080	发布流失败，发布流总数超过上限。通过 onVideoPublishStateChanged、onAudioPublishStateChanged 回调。 RTC 系统会限制单个房间内发布的总流数，总流数包括视频流、音频流和屏幕流。如果房间内发布流数已达上限时，本地用户再向房间中发布流时会失败，同时会收到此错误通知。
kErrorCodeAbnormalServerStatus	-1084	服务端异常状态导致退出房间。通过 onRoomStateChanged 回调。 SDK 与信令服务器断开，并不再自动重连，可联系技术支持。
[deprecated] kErrorCodeOverVideoPublishLimit	-1082	`Deprecated since 3.52, use kErrorCodeOverStreamPublishLimit（-1080）instead` 发布视频流总数超过上限。通过 onRoomStateChanged 回调。 RTC 系统会限制单个房间内发布的视频流数。如果房间内发布视频流数已达上限时，本地用户再向房间中发布视频流时会失败，同时会收到此错误通知。
[deprecated] kErrorCodeInvalidAudioSyncUidRepeated	-1083	`Deprecated since 3.60, use kAVSyncEventInvalidUidRepeated carried by [onAVSyncEvent](70096#IRTCRoomEventHandler-onavsyncevent) instead.` 音视频同步失败。通过 onStreamStateChanged 回调。当前音频源已与其他视频源关联同步关系。单个音频源不支持与多个视频源同时同步。

SingleStreamTaskErrorCode

enum bytertc::SingleStreamTaskErrorCode

单流转推任务错误码

枚举值

类型	值	说明
kSingleStreamTaskErrorCodeOK	0	推流成功。
kSingleStreamTaskErrorCodeUnKnownByServer	1091	服务端未知错误。
kSingleStreamTaskErrorCodeSignalRequestTimeout	1092	任务处理超时，请检查网络状态并重试。
kSingleStreamTaskErrorCodeInvalidParamByServer	1093	服务端检测任务参数不合法
kSingleStreamTaskErrorRemoteKicked	1094	转推任务在目标房间的用户ID被踢出目标房间
kSingleStreamTaskErrorCodeJoinDestRoomFailed	1095	转推任务加入目标房间失败
kSingleStreamTaskErrorCodeReceiveSrcStreamTimeout	1096	转推任务在源房间拉流超时
kSingleStreamTaskErrorCodeNotSurportCodec	1097	音视频编码转推任务不支持

PublicStreamErrorCode

enum bytertc::PublicStreamErrorCode

Deprecated since 3.60, see onMixedStreamEvent.

WTN 流状态码

枚举值

类型	值	说明
kPublicStreamErrorCodeOK	0	发布或订阅成功。
kPublicStreamErrorCodePullNoPushStream	1300	订阅失败，发布端未开始发布流。

AudioRecordingErrorCode

enum bytertc::AudioRecordingErrorCode

音频文件录制的错误码

枚举值

类型	值	说明
kAudioRecordingErrorCodeOk	0	录制正常
kAudioRecordingErrorCodeNoPermission	-1	没有文件写权限
kAudioRecordingErrorCodeNotInRoom	-2	没有进入房间
kAudioRecordingErrorCodeAlreadyStarted	-3	录制已经开始
kAudioRecordingErrorCodeNotStarted	-4	录制还未开始
kAudioRecordingErrorCodeNotSupport	-5	录制失败。文件格式不支持。
kAudioRecordingErrorCodeOther	-6	其他异常

RtsErrorCode

enum bytertc::RtsErrorCode

回调错误码。

枚举值

类型	值	说明
kRtsErrorCodeInvalidToken	-1000	Token 无效。进房时使用的 Token 无效或过期失效。需要用户重新获取 Token，并调用 `updateToken` 方法更新 Token。
kRtsErrorCodeJoinRoom	-1001	加入房间错误。进房时发生未知错误导致加入房间失败。需要用户重新加入房间。
kRtsErrorCodeDuplicateLogin	-1004	相同用户 ID 的用户加入本房间，当前用户被踢出房间
kRtsErrorCodeKickedOut	-1006	服务端调用 OpenAPI 将当前用户踢出房间
kRtsRoomErrorCodeRoomIdIllegal	-1007	当调用 `createRTCRoom` ，如果 roomid 非法，会返回 null，并抛出该 error
kRtsRoomErrorTokenExpired	-1009	Token 过期。调用 `joinRoom` 使用新的 Token 重新加入房间。
kRtsRoomErrorUpdateTokenWithInvalidToken	-1010	调用 `updateToken` 传入的 Token 无效
kRtsErrorCodeRoomDismiss	-1011	服务端调用 OpenAPI 解散房间，所有用户被移出房间。
kRtsErrorCodeRoomAlreadyExist	-1013	通话回路检测已经存在同样 roomId 的房间了
kRtsErrorCodeUserIDDifferent	-1014	同一个引擎实例在进入多个房间时设置的用户名必须相同
kRtsErrorCodeAbnormalServerStatus	-1084	服务端异常状态导致退出房间。 SDK 与信令服务器断开，并不再自动重连，可联系技术支持。
kRtsErrorCodeJoinRoomLimitedMode	-1013	加入RTS房间错误。当前为受限模式。

SingleStreamTaskEvent

enum bytertc::SingleStreamTaskEvent

单流转推直播事件

枚举值

类型	值	说明
kSingleStreamTaskEventStartSuccess	1	任务发起成功。
kSingleStreamTaskEventStartFailed	2	任务发起失败。
kSingleStreamTaskEventStopSuccess	3	任务停止。
kSingleStreamTaskEventStopFailed	4	结束任务失败。
kSingleStreamTaskEventWarning	5	Warning 事件

最近更新时间：2025.10.15 22:27:26

这个页面对您有帮助吗？

有用

无用