ByteRTCTranscoderErrorCode

public enum com.ss.bytertc.engine.live.ByteRTCTranscoderErrorCode

转推直播错误码

枚举值

类型	说明
TRANSCODER_ERROR_OK(0)	推流成功。
TRANSCODER_ERROR_BASE(1090)	未定义的合流错误
TRANSCODER_ERROR_INVALID_PARAM(1091)	客户端 SDK 检测到无效推流参数。
TRANSCODER_ERROR_INVALID_STATE(1092)	状态错误，需要在状态机正常状态下发起操作
TRANSCODER_ERROR_INVALID_OPERATOR(1093)	无效操作
TRANSCODER_ERROR_TIMEOUT(1094)	转推直播任务处理超时，请检查网络状态并重试
TRANSCODER_ERROR_INVALID_PARAM_BY_SERVER(1095)	服务端检测到错误的推流参数
TRANSCODER_ERROR_SUB_TIMEOUT_BY_SERVER(1096)	对流的订阅超时
TRANSCODER_ERROR_INVALID_STATE_BY_SERVER(1097)	合流服务端内部错误。
TRANSCODER_ERROR_AUTHENTICATION_BY_CDN(1098)	合流服务端推 CDN 失败。
TRANSCODER_ERROR_TIMEOUT_BY_SIGNALING(1099)	服务端接收信令超时，请检查网络状态并重试。
TRANSCODER_ERROR_MIX_IMAGE_FAIL(1100)	图片合流失败。
TRANSCODER_ERROR_UNKNOW_ERROR_BY_SERVER(1101)	服务端未知错误。

成员函数

返回	名称
ByteRTCTranscoderErrorCode	ByteRTCTranscoderErrorCode

函数说明

ByteRTCTranscoderErrorCode

com.ss.bytertc.engine.live.ByteRTCTranscoderErrorCode.ByteRTCTranscoderErrorCode(
    int value)

ErrorCode

public class com.ss.bytertc.engine.type.ErrorCode

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

成员变量

类型	名称
int	ERROR_CODE_INVALID_TOKEN
int	ERROR_CODE_JOIN_ROOM
int	ERROR_CODE_NO_PUBLISH_PERMISSION
int	ERROR_CODE_NO_SUBSCRIBE_PERMISSION
int	ERROR_CODE_DUPLICATE_LOGIN
int	ERROR_CODE_APP_ID_NULL
int	ERROR_CODE_KICKED_OUT
int	ERROR_CODE_ROOM_ID_ILLEGAL
int	ERROR_CODE_TOKEN_EXPIRED
int	ERROR_CODE_UPDATE_TOKEN_WITH_INVALID_TOKEN
int	ERROR_CODE_ROOM_DISMISS
int	ERROR_CODE_JOIN_ROOM_WITHOUT_LICENSE_AUTHENTICATE_SDK
int	ERROR_CODE_ROOM_ALREADY_EXIST
int	ERROR_CODE_OVER_SUBSCRIBE_LIMIT
int	ERROR_CODE_OVER_STREAM_PUBLISH_LIMIT
int	ERROR_CODE_OVER_SCREEN_PUBLISH_LIMIT
int	ERROR_CODE_OVER_VIDEO_PUBLISH_LIMIT
int	ERROR_CODE_INVALID_AUDIO_SYNC_USERID_REPEATED
int	ERROR_CODE_ABNORMAL_SERVER_STATUS

变量说明

ERROR_CODE_INVALID_TOKEN

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_INVALID_TOKEN = -1000;

Token 无效。
进房时使用的 Token 无效或过期失效。需要用户重新获取 Token，并调用 updateToken 方法更新 Token。

ERROR_CODE_JOIN_ROOM

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_JOIN_ROOM = -1001;

加入房间错误。
进房时发生未知错误导致加入房间失败。需要用户重新加入房间。

ERROR_CODE_NO_PUBLISH_PERMISSION

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_NO_PUBLISH_PERMISSION = -1002;

没有发布音视频流权限。用户在所在房间中发布音视频流失败，失败原因为用户没有发布流的权限。

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_NO_SUBSCRIBE_PERMISSION = -1003;

没有订阅音视频流权限。用户订阅所在房间中的音视频流失败，失败原因为用户没有订阅流的权限。

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_DUPLICATE_LOGIN = -1004;

相同用户 ID 的用户加入本房间，当前用户被踢出房间

ERROR_CODE_APP_ID_NULL

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_APP_ID_NULL = -1005;

App ID 参数异常。创建引擎时传入的 App ID 参数为空。

ERROR_CODE_KICKED_OUT

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_KICKED_OUT = -1006;

服务端调用 OpenAPI 将当前用户踢出房间

ERROR_CODE_ROOM_ID_ILLEGAL

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_ROOM_ID_ILLEGAL = -1007;

当调用 createRoom ，如果 roomId 非法，会返回 null，并抛出该错误

ERROR_CODE_TOKEN_EXPIRED

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_TOKEN_EXPIRED = -1009;

Token 过期。调用 joinRoom 使用新的 Token 重新加入房间。

ERROR_CODE_UPDATE_TOKEN_WITH_INVALID_TOKEN

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_UPDATE_TOKEN_WITH_INVALID_TOKEN = -1010;

调用 updateToken 传入的 Token 无效

ERROR_CODE_ROOM_DISMISS

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_ROOM_DISMISS = -1011;

服务端调用 OpenAPI 解散房间，所有用户被移出房间。

ERROR_CODE_JOIN_ROOM_WITHOUT_LICENSE_AUTHENTICATE_SDK

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_JOIN_ROOM_WITHOUT_LICENSE_AUTHENTICATE_SDK = -1012;

加入房间错误。
调用 joinRoom 方法时, LICENSE 计费账号未使用 LICENSE_AUTHENTICATE SDK，加入房间错误。

ERROR_CODE_ROOM_ALREADY_EXIST

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_ROOM_ALREADY_EXIST = -1013;

通话回路检测已经存在同样 roomId 的房间了

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_OVER_SUBSCRIBE_LIMIT = -1070;

订阅音视频流失败，订阅音视频流总数超过上限。游戏场景下为了保证音视频通话的性能和质量，服务器会限制用户订阅的音视频流的总数。当用户订阅的音视频流总数已达上限时，继续订阅更多流时会失败，同时用户会收到此错误通知。

ERROR_CODE_OVER_STREAM_PUBLISH_LIMIT

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_OVER_STREAM_PUBLISH_LIMIT = -1080;

发布流失败，发布流总数超过上限。 RTC 系统会限制单个房间内发布的总流数，总流数包括视频流、音频流和屏幕流。如果房间内发布流数已达上限时，本地用户再向房间中发布流时会失败，同时会收到此错误通知。

ERROR_CODE_OVER_SCREEN_PUBLISH_LIMIT

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_OVER_SCREEN_PUBLISH_LIMIT = -1081;

发布屏幕流失败，发布流总数超过上限。 RTC 系统会限制单个房间内发布的总流数，总流数包括视频流、音频流和屏幕流。如果房间内发布流数已达上限时，本地用户再向房间中发布流时会失败，同时会收到此错误通知。

ERROR_CODE_OVER_VIDEO_PUBLISH_LIMIT

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_OVER_VIDEO_PUBLISH_LIMIT = -1082;

发布视频流总数超过上限。 RTC 系统会限制单个房间内发布的视频流数。如果房间内发布视频流数已达上限时，本地用户再向房间中发布视频流时会失败，同时会收到此错误通知。

ERROR_CODE_INVALID_AUDIO_SYNC_USERID_REPEATED

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_INVALID_AUDIO_SYNC_USERID_REPEATED = -1083;

音视频同步失败。
当前音频源已与其他视频源关联同步关系。
单个音频源不支持与多个视频源同时同步。

ERROR_CODE_ABNORMAL_SERVER_STATUS

public static final int com.ss.bytertc.engine.type.ErrorCode.ERROR_CODE_ABNORMAL_SERVER_STATUS = -1084;

服务端异常状态导致退出房间。
SDK与信令服务器断开，并不再自动重连，可联系技术支持。

LoginErrorCode

public class com.ss.bytertc.engine.type.LoginErrorCode

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

成员变量

类型	名称
int	LOGIN_ERROR_CODE_SUCCESS
int	LOGIN_ERROR_CODE_INVALID_TOKEN
int	LOGIN_ERROR_CODE_LOGIN_FAILED
int	LOGIN_ERROR_CODE_INVALID_USER_ID
int	LOGIN_ERROR_CODE_SERVER_ERROR

变量说明

public static final int com.ss.bytertc.engine.type.LoginErrorCode.LOGIN_ERROR_CODE_SUCCESS = 0;

调用 login 方法登录成功。

public static final int com.ss.bytertc.engine.type.LoginErrorCode.LOGIN_ERROR_CODE_INVALID_TOKEN = -1000;

调用 login 方法时使用的 Token 无效或过期失效。需要用户重新获取 Token。

public static final int com.ss.bytertc.engine.type.LoginErrorCode.LOGIN_ERROR_CODE_LOGIN_FAILED = -1001;

登录错误。
调用 login 方法时发生未知错误导致登录失败，需要重新登录。

public static final int com.ss.bytertc.engine.type.LoginErrorCode.LOGIN_ERROR_CODE_INVALID_USER_ID = -1002;

调用 login 方法时传入的用户 ID 有问题。

public static final int com.ss.bytertc.engine.type.LoginErrorCode.LOGIN_ERROR_CODE_SERVER_ERROR = -1003;

调用 login 登录时服务器错误。

NetworkDetectionStartReturn

public enum com.ss.bytertc.engine.type.NetworkDetectionStartReturn

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

枚举值

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

TranscodingError

public class com.ss.bytertc.engine.type.TranscodingError

转推直播功能错误码。

成员变量

类型	名称
int	TRANSCODING_ERROR_OK
int	TRANSCODING_ERROR_INVALID_ARGUMENT
int	TRANSCODING_ERROR_SUBSCRIBE
int	TRANSCODING_ERROR_PROCESSING
int	TRANSCODING_ERROR_PUBLISH

变量说明

TRANSCODING_ERROR_OK

public static final int com.ss.bytertc.engine.type.TranscodingError.TRANSCODING_ERROR_OK = 0;

推流成功。

TRANSCODING_ERROR_INVALID_ARGUMENT

public static final int com.ss.bytertc.engine.type.TranscodingError.TRANSCODING_ERROR_INVALID_ARGUMENT = 1;

推流参数错误。你必须更新合流参数并重试。

public static final int com.ss.bytertc.engine.type.TranscodingError.TRANSCODING_ERROR_SUBSCRIBE = 2;

和 RTC 服务端建立连接失败。会自动重连

TRANSCODING_ERROR_PROCESSING

public static final int com.ss.bytertc.engine.type.TranscodingError.TRANSCODING_ERROR_PROCESSING = 3;

合流服务中间过程存在错误，建议重试。

TRANSCODING_ERROR_PUBLISH

public static final int com.ss.bytertc.engine.type.TranscodingError.TRANSCODING_ERROR_PUBLISH = 4;

推流失败，可以等待服务端重新推流。

UserMessageSendResult

public class com.ss.bytertc.engine.type.UserMessageSendResult

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

成员变量

类型	名称
int	USER_MESSAGE_SEND_RESULT_SUCCESS
int	USER_MESSAGE_SEND_RESULT_TIMEOUT
int	USER_MESSAGE_SEND_RESULT_BROKEN
int	USER_MESSAGE_SEND_RESULT_NO_RECEIVER
int	USER_MESSAGE_SEND_RESULT_NO_RELAY_PATH
int	USER_MESSAGE_SEND_RESULT_NOT_JOIN
int	USER_MESSAGE_SEND_RESULT_INIT
int	USER_MESSAGE_SEND_RESULT_NO_CONNECTION
int	USER_MESSAGE_SEND_RESULT_EXCEED_MAX_LENGTH
int	USER_MESSAGE_SEND_RESULT_EMPTY_USER
int	USER_MESSAGE_SEND_RESULT_NOT_LOGIN
int	USER_MESSAGE_SEND_RESULT_SERVER_PARAMS_NOT_SET
int	USER_MESSAGE_SEND_RESULT_UNKNOWN

变量说明

USER_MESSAGE_SEND_RESULT_SUCCESS

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_SUCCESS = 0;

发送消息成功

USER_MESSAGE_SEND_RESULT_TIMEOUT

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_TIMEOUT = 1;

发送超时，没有发送

USER_MESSAGE_SEND_RESULT_BROKEN

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_BROKEN = 2;

通道断开，没有发送

USER_MESSAGE_SEND_RESULT_NO_RECEIVER

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_NO_RECEIVER = 3;

找不到接收方

USER_MESSAGE_SEND_RESULT_NO_RELAY_PATH

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_NO_RELAY_PATH = 4;

获取级联路径失败

USER_MESSAGE_SEND_RESULT_NOT_JOIN

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_NOT_JOIN = 100;

消息发送方没有加入房间

USER_MESSAGE_SEND_RESULT_INIT

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_INIT = 101;

连接未完成初始化。

USER_MESSAGE_SEND_RESULT_NO_CONNECTION

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_NO_CONNECTION = 102;

没有可用的数据传输通道连接

USER_MESSAGE_SEND_RESULT_EXCEED_MAX_LENGTH

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_EXCEED_MAX_LENGTH = 103;

消息超过最大长度，当前为64KB

USER_MESSAGE_SEND_RESULT_EMPTY_USER

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_EMPTY_USER = 104;

接收消息的单个用户 id 为空

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_NOT_LOGIN = 105;

房间外或应用服务器消息发送方没有登录

USER_MESSAGE_SEND_RESULT_SERVER_PARAMS_NOT_SET

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_SERVER_PARAMS_NOT_SET = 106;

发送消息给业务方服务器之前没有设置参数

USER_MESSAGE_SEND_RESULT_UNKNOWN

public static final int com.ss.bytertc.engine.type.UserMessageSendResult.USER_MESSAGE_SEND_RESULT_UNKNOWN = 1000;

未知错误

WarningCode

public class com.ss.bytertc.engine.type.WarningCode

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

成员变量

类型	名称
int	WARNING_CODE_JOIN_ROOM_FAILED
int	WARNING_CODE_PUBLISH_STREAM_FAILED
int	WARNING_CODE_SUBSCRIBE_STREAM_FAILED404
int	WARNING_CODE_SUBSCRIBE_STREAM_FAILED5XX
int	WARNING_CODE_PUBLISH_STREAM_FORBIDEN
int	WARNING_CODE_SEND_CUSTOM_MESSAGE
int	WARNING_CODE_RECEIVE_USER_NOTIFY_STOP
int	WARNING_CODE_USER_IN_PUBLISH
int	WARNING_CODE_ROOM_ID_ALREADY_EXIST
int	WARNING_CODE_OLD_ROOM_BEEN_REPLACED
int	WARNING_CODE_IN_ECHO_TEST_MODE
int	WARNING_CODE_NO_CAMERA_PERMISSION
int	WARNING_CODE_SET_SCREEN_AUDIO_SOURCE_TYPE_FAILED
int	WARNING_CODE_SET_SCREEN_STREAM_INDEX_FAILED
int	WARNING_CODE_SET_SCREEN_STREAM_INVALID_VOICE_PITCH
int	WARNING_CODE_INVALID_CALL_FOR_EXT_AUDIO

变量说明

WARNING_CODE_JOIN_ROOM_FAILED

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_JOIN_ROOM_FAILED = -2001;

进房失败。
初次进房或者由于网络状况不佳断网重连时，由于服务器错误导致进房失败。SDK 会自动重试进房。

WARNING_CODE_PUBLISH_STREAM_FAILED

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_PUBLISH_STREAM_FAILED = -2002;

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

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_SUBSCRIBE_STREAM_FAILED404 = -2003;

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

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_SUBSCRIBE_STREAM_FAILED5XX = -2004;

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

WARNING_CODE_PUBLISH_STREAM_FORBIDEN

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_PUBLISH_STREAM_FORBIDEN = -2009;

当调用 setUserVisibility 将自身可见性设置为 false 后，再尝试发布流会触发此警告。

WARNING_CODE_SEND_CUSTOM_MESSAGE

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_SEND_CUSTOM_MESSAGE = -2011;

发送自定义广播消息失败, 当前你未在房间中。

WARNING_CODE_RECEIVE_USER_NOTIFY_STOP

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_RECEIVE_USER_NOTIFY_STOP = -2013;

当房间内人数超过 500 人时，停止向房间内已有用户发送 onUserJoined 和 onUserLeave 回调，并通过广播提示房间内所有用户。

WARNING_CODE_USER_IN_PUBLISH

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_USER_IN_PUBLISH = -2014;

用户已经在其他房间发布过流，或者用户正在发布公共流。

WARNING_CODE_ROOM_ID_ALREADY_EXIST

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_ROOM_ID_ALREADY_EXIST = -2015;

同样roomid的房间已经存在了

WARNING_CODE_OLD_ROOM_BEEN_REPLACED

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_OLD_ROOM_BEEN_REPLACED = -2016;

新生成的房间已经替换了同样roomId的旧房间

WARNING_CODE_IN_ECHO_TEST_MODE

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_IN_ECHO_TEST_MODE = -2017;

当前正在进行回路测试，该接口调用无效

WARNING_CODE_NO_CAMERA_PERMISSION

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_NO_CAMERA_PERMISSION = -5001;

摄像头权限异常，当前应用没有获取摄像头权限。

WARNING_CODE_SET_SCREEN_AUDIO_SOURCE_TYPE_FAILED

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_SET_SCREEN_AUDIO_SOURCE_TYPE_FAILED = -5009;

不支持在 publishScreen 之后，调用 setScreenAudioSourceType 设置屏幕音频采集类型

WARNING_CODE_SET_SCREEN_STREAM_INDEX_FAILED

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_SET_SCREEN_STREAM_INDEX_FAILED = -5010;

不支持在 publishScreen 之后，调用 setScreenAudioStreamIndex 设置屏幕音频共享发布类型

WARNING_CODE_SET_SCREEN_STREAM_INVALID_VOICE_PITCH

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_SET_SCREEN_STREAM_INVALID_VOICE_PITCH = -5011;

设置语音音高不合法

WARNING_CODE_INVALID_CALL_FOR_EXT_AUDIO

public static final int com.ss.bytertc.engine.type.WarningCode.WARNING_CODE_INVALID_CALL_FOR_EXT_AUDIO = -5013;

外部音频源新旧接口混用