LoginErrorCode

enum bytertc::LoginErrorCode

登录结果
调用 Login 登录的结果,会通过 OnLoginResult 回调通知用户。

Defined in : bytertc_common_defines.h

枚举值

类型 值 说明
kLoginErrorCodeSuccess 0 调用 Login 方法登录成功
kLoginErrorCodeInvalidToken -1000 调用 Login 方法时使用的 Token 无效或过期失效,需要用户重新获取 Token。
kLoginErrorCodeLoginFailed -1001 登录错误

调用 Login 方法时发生未知错误导致登录失败,需要重新登录。
kLoginErrorCodeInvalidUserId -1002 调用 Login 方法时传入的用户 ID 有问题。
kLoginErrorCodeServerError -1003 调用 Login 登录时服务端出错。

UserMessageSendResult

enum bytertc::UserMessageSendResult

向房间内单个用户发送消息(P2P)的结果

Defined in : bytertc_common_defines.h

枚举值

类型 值 说明
kUserMessageSendResultSuccess 0 向房间内单个用户发送消息成功
kUserMessageSendResultTimeout 1 发送超时,没有发送
kUserMessageSendResultBroken 2 通道断开,没有发送
kUserMessageSendResultNoReceiver 3 找不到接收方
kUserMessageSendResultNoRelayPath 4 获取级联路径失败
kUserMessageSendResultNotJoin 100 消息发送方没有加入房间
kUserMessageSendResultInit 101 连接未完成初始化
kUserMessageSendResultNoConnection 102 没有可用的数据传输通道连接
kUserMessageSendResultExceedMaxLength 103 消息超过最大长度,当前为 64 KB
kUserMessageSendResultEmptyUser 104 接收消息的单个用户 id 为空
kUserMessageSendResultNotLogin 105 房间外或业务服务器消息发送方没有登录
kUserMessageSendResultServerParamsNotSet 106 发送消息给业务方服务器之前没有设置参数
kUserMessageSendResultUnknown 1000 未知错误

NetworkDetectionStartReturn

enum bytertc::NetworkDetectionStartReturn

开始探测的返回值 StartNetworkDetection 返回对象类型

Defined in : bytertc_common_defines.h

枚举值

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

ErrorCode

enum bytertc::ErrorCode

回调错误码。
SDK 内部遇到不可恢复的错误时,会通过 OnError 回调通知用户。

Defined in : bytertc_common_defines.h

枚举值

类型 值 说明
kErrorCodeInvalidToken -1000 Token 无效。
进房时使用的 Token 无效或过期失效。需要用户重新获取 Token,并调用 UpdateToken 方法更新 Token。
kErrorCodeJoinRoom -1001 加入房间错误。
进房时发生未知错误导致加入房间失败。需要用户重新加入房间。
kErrorCodeNoPublishPermission -1002 没有发布音视频流权限。
用户在所在房间中发布音视频流失败,失败原因为用户没有发布流的权限。
kErrorCodeNoSubscribePermission -1003 没有订阅音视频流权限。
用户订阅所在房间中的音视频流失败,失败原因为用户没有订阅流的权限。
kErrorCodeDuplicateLogin -1004 用户被踢出房间:

+ 本地用户所在房间中有相同用户 ID 的用户加入房间,导致前者被踢出房间;

+ 因调用踢出用户的 OpenAPI,被踢出房间;

+ 因调用解散房间的 OpenAPI,离开房间。
kErrorCodeKickedOut -1006 用户被踢出房间。
本端用户被主动踢出所在房间时,回调此错误。
kRoomErrorCodeRoomIdIllegal -1007 当调用 CreateRTCRoom ,如果roomid 非法,会返回null,并抛出该error
kRoomErrorCodeUserIsInRoom -1008 当调用 CreateRTCRoom ,如果已经存在了相同的房间,会返回null,并抛出该error
kRoomErrorTokenExpired -1009 Token 过期。调用 JoinRoom 使用新的 Token 重新加入房间。
kRoomErrorUpdateTokenWithInvalidToken -1010 调用 updateToken 传入的 Token 无效
kErrorCodeOverStreamSubscribeLimit -1070 订阅音视频流失败,订阅音视频流总数超过上限。
游戏场景下,为了保证音视频通话的性能和质量,服务器会限制用户订阅的音视频流总数。当用户订阅的音视频流总数已达上限时,继续订阅更多流时会失败,同时用户会收到此错误通知。
kErrorCodeOverStreamPublishLimit -1080 发布流失败,发布流总数超过上限。
RTC 系统会限制单个房间内发布的总流数,总流数包括视频流、音频流和屏幕流。如果房间内发布流数已达上限时,本地用户再向房间中发布流时会失败,同时会收到此错误通知。
kErrorCodeOverScreenPublishLimit -1081 发布屏幕流失败,发布流总数超过上限。
RTC 系统会限制单个房间内发布的总流数,总流数包括视频流、音频流和屏幕流。如果房间内发布流数已达上限时,本地用户再向房间中发布流时会失败,同时会收到此错误通知。
kErrorCodeOverVideoPublishLimit -1082 发布视频流总数超过上限。
RTC 系统会限制单个房间内发布的视频流数。如果房间内发布视频流数已达上限时,本地用户再向房间中发布视频流时会失败,同时会收到此错误通知。

WarningCode

enum bytertc::WarningCode

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

Defined in : bytertc_common_defines.h

枚举值

类型 值 说明
kWarningCodeJoinRoomFailed -2001 进房失败。

当你调用初次加入房间或者由于网络状况不佳断网重连时,由于服务器错误导致进房失败。SDK 会自动重试进房。
kWarningCodePublishStreamFailed -2002 发布音视频流失败。

当你在所在房间中发布音视频流时,由于服务器错误导致发布失败。SDK 会自动重试发布。
kWarningCodeSubscribeStreamFailed404 -2003 订阅音视频流失败。

当前房间中找不到订阅的音视频流导致订阅失败。SDK 会自动重试订阅,若仍订阅失败则建议你退出重试。
kWarningCodeSubscribeStreamFailed5xx -2004 订阅音视频流失败。

当你订阅所在房间中的音视频流时,由于服务器错误导致订阅失败。SDK 会自动重试订阅。
kWarningCodePublishStreamForbiden -2009 当调用 SetUserVisibility 将自身可见性设置为 false 后,再尝试发布流会触发此警告。
kWarningCodeSendCustomMessage -2011 发送自定义广播消息失败,当前你未在房间中。
kWarningCodeUserNotifyStop -2013 当房间内人数超过 500 人时,停止向房间内已有用户发送 OnUserJoined 和 OnUserLeave 回调,并通过广播提示房间内所有用户。
kWarningCodeNoCameraPermission -5001 摄像头权限异常,当前应用没有获取摄像头权限。
kWarningCodeNoMicrophonePermission -5002 麦克风权限异常,当前应用没有获取麦克风权限。
@deprecated since 333.1, use MediaDeviceWarning instead
kWarningCodeRecodingDeviceStartFailed -5003 音频采集设备启动失败,当前设备可能被其他应用占用。
@deprecated since 333.1, use MediaDeviceWarning instead
kWarningCodePlayoutDeviceStartFailed -5004 音频播放设备启动失败警告,可能由于系统资源不足,或参数错误。
@deprecated since 333.1, use MediaDeviceWarning instead
kWarningCodeNoRecordingDevice -5005 无可用音频采集设备,请插入可用的音频采集设备。
@deprecated since 333.1, use MediaDeviceWarning instead
kWarningCodeNoPlayoutDevice -5006 无可用音频播放设备,请插入可用的音频播放设备。
@deprecated since 333.1, use MediaDeviceWarning instead
kWarningCodeRecordingSilence -5007 当前音频设备没有采集到有效的声音数据,请检查更换音频采集设备。
@deprecated since 333.1, use MediaDeviceWarning instead
kWarningCodeMediaDeviceOperationDenied -5008 媒体设备误操作警告。

使用自定义采集时,不可调用内部采集开关,调用时将触发此警告。
@deprecated since 333.1, use MediaDeviceWarning instead
kWarningCodeSetScreenAudioSourceTypeFailed -5009 不支持在 PublishScreen 之后调用 SetScreenAudioSourceType 设置屏幕音频采集类型,请在 PublishScreen 之前设置
kWarningCodeSetScreenAudioStreamIndexFailed -5010 不支持在 PublishScreen 之后, 通过 SetScreenAudioStreamIndex 设置屏幕共享时的音频采集方式。
kWarningCodeInvalidVoicePitch -5011 设置语音音高不合法
kWarningCodeInvalidAudioFormat -5012 设置音频格式不合法
kWarningCodeInvalidCanvasHandle = -6001 -6001 指定的内部渲染画布句柄无效。

当你调用 SetLocalVideoCanvas 时指定了无效的画布句柄,触发此回调。

LocalVideoStreamError

enum bytertc::LocalVideoStreamError

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

Defined in : bytertc_common_defines.h

枚举值

类型 值 说明
kLocalVideoStreamErrorOk 0 状态正常
kLocalVideoStreamErrorFailure 1 本地视频流发布失败
kLocalVideoStreamErrorDeviceNoPermission 2 没有权限启动本地视频采集设备
kLocalVideoStreamErrorDeviceBusy 3 本地视频采集设备被占用
kLocalVideoStreamErrorDeviceNotFound 4 本地视频采集设备不存在
kLocalVideoStreamErrorCaptureFailure 5 本地视频采集失败,建议检查采集设备是否正常工作
kLocalVideoStreamErrorEncodeFailure 6 本地视频编码失败
kLocalVideoStreamErrorDeviceDisconnected 7 本地视频采集设备被移除