## WarningCode 类型：`enum` 回调警告码。警告码说明 SDK 内部遇到问题正在尝试恢复。警告码仅作通知。 |属性 |值 |描述 | |---|---|---| |WARNING_CODE_JOIN_ROOM_FAILED |`0` |进房失败。|\ | | |初次进房或者由于网络状况不佳断网重连时，由于服务器错误导致进房失败。SDK 会自动重试进房。通过 onRoomStateChanged 回调。 | |WARNING_CODE_PUBLISH_STREAM_FAILED |`1` |发布音视频流失败。|\ | | |当你在所在房间中发布音视频流时，由于服务器错误导致发布失败。SDK 会自动重试发布。通过 onStreamStateChanged 回调。 | |WARNING_CODE_SUBSCRIBE_STREAM_FAILED404 |`2` |订阅音视频流失败。|\ | | |当前房间中找不到订阅的音视频流导致订阅失败。SDK 会自动重试订阅，若仍订阅失败则建议你退出重试。通过 onStreamStateChanged 回调。 | |WARNING_CODE_SUBSCRIBE_STREAM_FAILED5XX |`3` |订阅音视频流失败。|\ | | |当你订阅所在房间中的音视频流时，由于服务器错误导致订阅失败。SDK 会自动重试订阅。通过 onStreamStateChanged 回调。 | |WARNING_CODE_PUBLISH_STREAM_FORBIDEN |`6` |当调用 `setUserVisibility` 将自身可见性设置为 false 后，再尝试发布流会触发此警告。通过 onStreamStateChanged 回调。 | |WARNING_CODE_SEND_CUSTOM_MESSAGE |`7` |发送自定义广播消息失败, 当前你未在房间中。 | |WARNING_CODE_RECEIVE_USER_NOTIFY_STOP |`8` |当房间内人数超过 500 人时，停止向房间内已有用户发送 `onUserJoined` 和 `onUserLeave` 回调，并通过广播提示房间内所有用户。通过 onRoomStateChanged 回调。 | |WARNING_CODE_USER_IN_PUBLISH |`9` |用户已经在其他房间发布过流，或者用户正在发布 WTN 流。通过 onStreamStateChanged 回调。 | |WARNING_CODE_OLD_ROOM_BEEN_REPLACED |`10` |已存在相同 roomId 的房间，新创建的房间实例已替换旧房间实例。通过 onRoomStateChanged 回调。 | |WARNING_CODE_IN_ECHO_TEST_MODE |`11` |当前正在进行回路测试，该接口调用无效 | |WARNING_CODE_NO_CAMERA_PERMISSION |`12` |摄像头权限异常，当前应用没有获取摄像头权限。 | |WARNING_CODE_SET_SCREEN_AUDIO_SOURCE_TYPE_FAILED |`13` |不支持在 publishScreen 之后，调用 setScreenAudioSourceType 设置屏幕音频采集类型 | |WARNING_CODE_SET_SCREEN_STREAM_INDEX_FAILED |`14` |不支持在 publishScreen 之后，调用 setScreenAudioStreamIndex 设置屏幕音频共享发布类型 | |WARNING_CODE_SET_SCREEN_STREAM_INVALID_VOICE_PITCH |`15` |设置语音音高不合法 | |WARNING_CODE_INVALID_CALL_FOR_EXT_AUDIO |`16` |外部音频源新旧接口混用 | |WARNING_CODE_INVALID_SAMI_APPKEY_OR_TOKEN |`17` |[音频技术](https://www.volcengine.com/docs/6489/71986) SDK 鉴权失效。联系技术支持人员。 | |WARNING_CODE_INVALID_RESOURCE_PATH |`18` |[音频技术](https://www.volcengine.com/docs/6489/71986) 资源加载失败。传入正确的 DAT 路径，或联系技术支持人员。 | |WARNING_CODE_LOAD_SAMI_LIBRARY_FAILED |`19` |[音频技术](https://www.volcengine.com/docs/6489/71986) 库加载失败。使用正确的库，或联系技术支持人员。 | |WARNING_CODE_INVALID_SAMI_EFFECT_TYPE |`20` |[音频技术](https://www.volcengine.com/docs/6489/71986) 不支持此音效。联系技术支持人员。 | |WARNING_CODE_GET_ROOM_FAILED |`21` |获取房间信息失败警告 | |WARNING_CODE_SUBSCRIBE_STREAM_FORBIDEN |`22` |自动订阅模式未关闭时，尝试开启手动订阅模式会触发此警告。|\ | | |你需在进房前关闭自动订阅模式，再调用 subscribeUserStream 方法手动订阅音视频流。 | |WARNING_CODE_ROOM_ID_ALREADY_EXIST |`23` |已存在同样 roomId 的房间。 | |WARNING_CODE_NO_MICROPHONE_PERMISSION |`24` |麦克风权限异常，当前应用没有获取麦克风权限。 | |WARNING_CODE_RECODING_DEVICE_START_FAILED |`25` |音频采集设备启动失败。|\ | | |启动音频采集设备失败，当前设备可能被其他应用占用。 | |WARNING_CODE_PLAYOUT_DEVICE_START_FAILED |`26` |音频播放设备启动失败警告。|\ | | |可能由于系统资源不足，或参数错误。 | |WARNING_CODE_NO_RECORDING_DEVICE |`27` |无可用音频采集设备。|\ | | |启动音频采集设备失败，请插入可用的音频采集设备。 | |WARNING_CODE_NO_PLAYOUT_DEVICE |`28` |无可用音频播放设备。|\ | | |启动音频播放设备失败，请插入可用的音频播放设备。 | |WARNING_CODE_RECORDING_SILENCE |`29` |当前音频设备没有采集到有效的声音数据，请检查更换音频采集设备。 | |WARNING_CODE_MEDIA_DEVICE_OPERATION_DENIED |`30` |媒体设备误操作警告。|\ | | |使用自定义采集时，不可调用内部采集开关，调用时将触发此警告。 | |ByteRTCWarningCodeJoinRoomFailed |`31` |进房失败。通过 onRoomStateChanged 回调。|\ | | |初次进房或者由于网络状况不佳断网重连时，由于服务器错误导致进房失败。SDK 会自动重试进房。 | |ByteRTCWarningCodePublishStreamFailed |`32` |发布音视频流失败。通过 onStreamStateChanged 回调。|\ | | |当你在所在房间中发布音视频流时，由于服务器错误导致发布失败。SDK 会自动重试发布。 | |ByteRTCWarningCodeSubscribeStreamFailed404 |`33` |订阅音视频流失败。通过 onStreamStateChanged 回调。|\ | | |当前房间中找不到订阅的音视频流导致订阅失败。SDK 会自动重试订阅，若仍订阅失败则建议你退出重试。 | |ByteRTCWarningCodeSubscribeStreamFailed5xx |`34` |订阅音视频流失败。通过 onStreamStateChanged 回调。|\ | | |当你订阅所在房间中的音视频流时，由于服务器错误导致订阅失败。SDK 会自动重试订阅。 | |ByteRTCWarningCodePublishStreamForbiden |`37` |当调用 `setUserVisibility:` 将自身可见性设置为 false 后，再尝试发布流会触发此警告。通过 onStreamStateChanged 回调。 | |ByteRTCWarningCodeSendCustomMessage |`38` |发送自定义广播消息失败，当前你未在房间中。 | |ByteRTCWarningCodeCodeUserNotifyStop |`39` |当房间内人数超过 500 人时，停止向房间内已有用户发送 `rtcEngine:onUserJoined:elapsed:` 和 `rtcEngine:onUserLeave:reason:` 回调，并通过广播提示房间内所有用户。通过 onRoomStateChanged 回调。 | |ByteRTCWarningCodeUserInPublish |`40` |用户已经在其他房间发布过流，或者用户正在发布 WTN 流。通过 onStreamStateChanged 回调。 | |ByteRTCWarningCodeOldRoomBeenReplaced |`41` |已存在相同 roomId 的房间，新创建的房间实例已替换旧房间实例。通过 onRoomStateChanged 回调。 | |ByteRTCWarningCodeInEchoTestMode |`42` |当前正在进行回路测试，该接口调用无效 | |ByteRTCWarningCodeNoCameraPermission |`43` |摄像头权限异常，当前应用没有获取摄像头权限 | |ByteRTCWarningSetScreenAudioSourceTypeFailed |`44` |不支持在 `publishScreen` 之后，通过 `setScreenAudioSourceType` 设置屏幕音频采集类型 | |ByteRTCWarningSetScreenAudioStreamIndexFailed |`45` |不支持在 `publishScreen` 之后，通过 `setScreenAudioStreamIndex` 设置屏幕音频混流类型 | |ByteRTCWarningInvalidVoicePitch |`46` |设置语音音高不合法 | |ByteRTCWarningInvalidCallForExtAudio |`47` |外部音频源新旧接口混用 | |ByteRTCWarningCodeInvalidCanvasHandle |`48` |指定的内部渲染画布句柄无效。|\ | | |当你调用 setLocalVideoCanvas 或 setRemoteVideoCanvas 时指定了无效的画布句柄，触发此回调。 | |ByteRTCWarningCodeInvaildSamiAppkeyORToken |`49` |[音频技术](https://www.volcengine.com/docs/6489/71986) SDK 鉴权失效。联系技术支持人员。 | |ByteRTCWarningCodeInvaildSamiResourcePath |`50` |[音频技术](https://www.volcengine.com/docs/6489/71986) 资源加载失败。传入正确的 DAT 路径，或联系技术支持人员。 | |ByteRTCWarningCodeLoadSamiLibraryFailed |`51` |[音频技术](https://www.volcengine.com/docs/6489/71986) 库加载失败。使用正确的库，或联系技术支持人员。 | |ByteRTCWarningCodeInvaildSamiEffectType |`52` |[音频技术](https://www.volcengine.com/docs/6489/71986) 不支持此音效。联系技术支持人员。 | |ByteRTCWarningCodeGetRoomFailed |`53` |\- | |ByteRTCWarningCodeSubscribeStreamForbiden |`54` |自动订阅模式未关闭时，尝试开启手动订阅模式会触发此警告。|\ | | |你需在进房前关闭自动订阅模式，再调用 subscribeStream 方法手动订阅音视频流。 | |ByteRTCWarningCodeRoomAlreadyExist |`55` |同样 roomid 的房间已经存在了 | |ByteRTCWarningCodeNoMicrophonePermission |`56` |麦克风权限异常，当前应用没有获取麦克风权限。 | |ByteRTCWarningCodeAudioDeviceManagerRecordingStartFail |`57` |音频采集设备启动失败。|\ | | |启动音频采集设备失败，当前设备可能被其他应用占用。 | |ByteRTCWarningCodeAudioDeviceManagerPlayoutStartFail |`58` |音频播放设备启动失败警告。|\ | | |可能由于系统资源不足，或参数错误。 | |ByteRTCWarningCodeNoRecordingDevice |`59` |无可用音频采集设备。|\ | | |启动音频采集设备失败，请插入可用的音频采集设备。 | |ByteRTCWarningCodeNoPlayoutDevice |`60` |无可用音频播放设备。|\ | | |启动音频播放设备失败，请插入可用的音频播放设备。 | |ByteRTCWarningCodeRecordingSilence |`61` |当前音频设备没有采集到有效的声音数据，请检查更换音频采集设备。 | |ByteRTCWarningCodeMediaDeviceOperationDennied |`62` |媒体设备误操作警告。|\ | | |使用自定义采集时，不可调用内部采集开关，调用时触发此警告。 | ## ErrorCode 类型：`enum` 回调错误码。 SDK 内部遇到不可恢复的错误时，会通过 `onError` 回调通知用户。 |属性 |值 |描述 | |---|---|---| |ERROR_CODE_INVALID_TOKEN |`0` |Token 无效。|\ | | |进房时使用的 Token 无效或过期失效。需要用户重新获取 Token，并调用 `updateToken` 方法更新 Token。通过 onRoomStateChanged 回调。 | |ERROR_CODE_JOIN_ROOM |`1` |加入房间错误。|\ | | |进房时发生未知错误导致加入房间失败。需要用户重新加入房间。通过 onRoomStateChanged 回调。 | |ERROR_CODE_NO_PUBLISH_PERMISSION |`2` |没有发布音视频流权限。|\ | | |用户在所在房间中发布音视频流失败，失败原因为用户没有发布流的权限。通过 onStreamStateChanged 回调。 | |ERROR_CODE_NO_SUBSCRIBE_PERMISSION |`3` |没有订阅音视频流权限。|\ | | |用户订阅所在房间中的音视频流失败，失败原因为用户没有订阅流的权限。通过 onStreamStateChanged 回调。 | |ERROR_CODE_DUPLICATE_LOGIN |`4` |相同用户 ID 的用户加入本房间，当前用户被踢出房间。通过 onRoomStateChanged 回调。 | |ERROR_CODE_APP_ID_NULL |`5` |App ID 参数异常。|\ | | |创建引擎时传入的 App ID 参数为空。 | |ERROR_CODE_KICKED_OUT |`6` |服务端调用 OpenAPI 将当前用户踢出房间。通过 onRoomStateChanged 回调。 | |ERROR_CODE_ROOM_ID_ILLEGAL |`7` |当调用 `createRoom` ，如果 roomId 非法，会返回 null，并抛出该错误。通过 onCreateRoomStateChanged 回调。 | |ERROR_CODE_TOKEN_EXPIRED |`8` |Token 过期。调用 `joinRoom` 使用新的 Token 重新加入房间。通过 onRoomStateChanged 回调。 | |ERROR_CODE_UPDATE_TOKEN_WITH_INVALID_TOKEN |`9` |调用 `updateToken` 传入的 Token 无效。通过 onRoomStateChanged 回调。 | |ERROR_CODE_ROOM_DISMISS |`10` |服务端调用 OpenAPI 解散房间，所有用户被移出房间。通过 onRoomStateChanged 回调。 | |ERROR_CODE_ROOM_ALREADY_EXIST |`12` |通话回路检测已经存在同样 roomId 的房间了。通过 onCreateRoomStateChanged 回调。 | |ERROR_CODE_USER_ID_DIFFERENT |`13` |加入多个房间时使用了不同的 uid。|\ | | |同一个引擎实例中，用户需使用同一个 uid 加入不同的房间。通过 onRoomStateChanged 回调。 | |ERROR_CODE_JOIN_ROOM_ROOM_FORBIDDEN |`22` |房间被封禁。通过 onRoomStateChanged 回调。 | |ERROR_CODE_JOIN_ROOM_USER_FORBIDDEN |`23` |用户被封禁。通过 onRoomStateChanged 回调。 | |ERROR_CODE_OVER_SUBSCRIBE_LIMIT |`25` |订阅音视频流失败，订阅音视频流总数超过上限。|\ | | |游戏场景下为了保证音视频通话的性能和质量，服务器会限制用户订阅的音视频流的总数。当用户订阅的音视频流总数已达上限时，继续订阅更多流时会失败，同时用户会收到此错误通知。通过 onStreamStateChanged 回调。 | |ERROR_CODE_OVER_STREAM_PUBLISH_LIMIT |`27` |发布流失败，发布流总数超过上限。|\ | | |RTC 系统会限制单个房间内发布的总流数，总流数包括视频流、音频流和屏幕流。如果房间内发布流数已达上限时，本地用户再向房间中发布流时会失败，同时会收到此错误通知。通过 onStreamStateChanged 回调。 | |ERROR_CODE_INVALID_AUDIO_SYNC_USERID_REPEATED |`28` |音视频同步失败。|\ | | |当前音频源已与其他视频源关联同步关系。|\ | | |单个音频源不支持与多个视频源同时同步。|\ | | |通过 onStreamStateChanged 回调。 | |ERROR_CODE_ABNORMAL_SERVER_STATUS |`29` |服务端异常状态导致退出房间。|\ | | |SDK 与信令服务器断开，并不再自动重连，可联系技术支持。通过 onRoomStateChanged 回调。 | |ERROR_CODE_OVER_SCREEN_PUBLISH_LIMIT |`32` |发布屏幕流失败，发布流总数超过上限。|\ | | |RTC 系统会限制单个房间内发布的总流数，总流数包括视频流、音频流和屏幕流。如果房间内发布流数已达上限时，本地用户再向房间中发布流时会失败，同时会收到此错误通知。 | |ERROR_CODE_OVER_VIDEO_PUBLISH_LIMIT |`33` |发布视频流总数超过上限。|\ | | |RTC 系统会限制单个房间内发布的视频流数。如果房间内发布视频流数已达上限时，本地用户再向房间中发布视频流时会失败，同时会收到此错误通知。 | |ByteRTCErrorCodeInvalidToken |`34` |Token 无效。通过 onRoomStateChanged 回调。|\ | | |调用 joinRoom 进房时使用的 Token 参数有误或过期失效。需要重新获取 Token，并调用 updateToken 方法更新 Token。 | |ByteRTCErrorCodeJoinRoom |`35` |加入房间错误。通过 onRoomStateChanged 回调。|\ | | |进房时发生未知错误导致加入房间失败。需要用户重新加入房间。 | |ByteRTCErrorCodeNoPublishPermission |`36` |没有发布音视频流权限。通过 onStreamStateChanged 回调。|\ | | |用户在所在房间中发布音视频流失败，失败原因为用户没有发布流的权限。 | |ByteRTCErrorCodeNoSubscribePermission |`37` |没有订阅音视频流权限。通过 onStreamStateChanged 回调。|\ | | |用户订阅所在房间中的音视频流失败，失败原因为用户没有订阅流的权限。 | |ByteRTCErrorCodeDuplicateLogin |`38` |相同用户 ID 的用户加入本房间，当前用户被踢出房间。通过 onRoomStateChanged 回调。 | |ByteRTCErrorCodeKickedOut |`39` |服务端调用 OpenAPI 将当前用户踢出房间。通过 onRoomStateChanged 回调。 | |ByteRTCErrorCodeRoomIdIllegal |`40` |当调用 `createRtcRoom:` ，如果 roomId 非法，会返回 null，并抛出该错误。通过 onCreateRoomStateChanged 回调。 | |ByteRTCErrorCodeTokenExpired |`41` |Token 过期。加入房间后 Token 过期时，返回此错误码。需使用新的 Token 重新加入房间。通过 onRoomStateChanged 回调。 | |ByteRTCErrorCodeUpdateTokenWithInvalidToken |`42` |调用 `updateToken:` 传入的 Token 无效。通过 onRoomStateChanged 回调。 | |ByteRTCErrorCodeRoomDismiss |`43` |服务端调用 OpenAPI 解散房间，所有用户被移出房间。通过 onRoomStateChanged 回调。 | |ByteRTCRoomAlreadyExist |`45` |通话回路检测已经存在同样 roomId 的房间了。通过 onCreateRoomStateChanged 回调。 | |ByteRTCUserIDDifferent |`46` |加入多个房间时使用了不同的 uid。通过 onRoomStateChanged 回调。|\ | | |同一个引擎实例中，用户需使用同一个 uid 加入不同的房间。 | |ByteRTCErrorCodeJoinRoomRoomForbidden |`55` |房间被封禁。通过 onRoomStateChanged 回调。 | |ByteRTCErrorCodeJoinRoomUserForbidden |`56` |用户被封禁。通过 onRoomStateChanged 回调。 | |ByteRTCErrorCodeOverStreamSubscribeLimit |`57` |订阅音视频流失败，订阅音视频流总数超过上限。通过 onStreamStateChanged 回调。|\ | | |游戏场景下，为了保证音视频通话的性能和质量，服务器会限制用户订阅的音视频流总数。当用户订阅的音视频流总数已达上限时，继续订阅更多流时会失败，同时用户会收到此错误通知。 | |ByteRTCErrorCodeOverStreamPublishLimit |`58` |发布流失败，发布流总数超过上限。通过 onStreamStateChanged 回调。|\ | | |RTC 系统会限制单个房间内发布的总流数，总流数包括视频流、音频流和屏幕流。如果房间内发布流数已达上限时，本地用户再向房间中发布流时会失败，同时会收到此错误通知。 | |ByteRTCErrorCodInvalidAudioSyncUidRepeated |`59` |音视频同步失败。|\ | | |当前音频源已与其他视频源关联同步关系。|\ | | |单个音频源不支持与多个视频源同时同步。|\ | | |通过 onStreamStateChanged 回调。 | |ByteRTCErrorCodeAbnormalServerStatus |`60` |服务端异常状态导致退出房间。通过 onRoomStateChanged 回调。|\ | | |SDK 与信令服务器断开，并不再自动重连，可联系技术支持。 | |ByteRTCErrorCodeOverScreenPublishLimit |`64` |发布屏幕流失败，发布流总数超过上限。|\ | | |RTC 系统会限制单个房间内发布的总流数，总流数包括视频流、音频流和屏幕流。如果房间内发布流数已达上限时，本地用户再向房间中发布流时会失败，同时会收到此错误通知。 | |ByteRTCErrorCodeOverVideoPublishLimit |`65` |发布视频流总数超过上限。|\ | | |RTC 系统会限制单个房间内发布的视频流数。如果房间内发布视频流数已达上限时，本地用户再向房间中发布视频流时会失败，同时会收到此错误通知。 | ## LoginErrorCode 类型：`enum` 登录结果调用 `login` 登录的结果，会通过 `onLoginResult` 回调通知用户。 |属性 |值 |描述 | |---|---|---| |LOGIN_ERROR_CODE_SUCCESS |`0` |调用 `login` 方法登录成功。 | |LOGIN_ERROR_CODE_INVALID_TOKEN |`1` |调用 `login` 方法时使用的 Token 无效或过期失效。需要用户重新获取 Token。 | |LOGIN_ERROR_CODE_LOGIN_FAILED |`2` |登录错误。|\ | | |调用 `login` 方法时发生未知错误导致登录失败，需要重新登录。 | |LOGIN_ERROR_CODE_INVALID_USER_ID |`3` |调用 `login` 方法时传入的用户 ID 有问题。 | |LOGIN_ERROR_CODE_SERVER_ERROR |`4` |调用 `login` 登录时服务器错误。 | |ByteRTCLoginErrorCodeSuccess |`5` |调用 `login:uid:` 方法登录成功。 | |ByteRTCLoginErrorCodeInvalidToken |`6` |调用 `login:uid:` 方法时使用的 Token 无效或过期失效。需要用户重新获取 Token。 | |ByteRTCLoginErrorCodeLoginFailed |`7` |登录错误|\ | | |调用 `login:uid:` 方法时发生未知错误导致登录失败。需要用户重新登录。 | |ByteRTCLoginErrorCodeInvalidUserId |`8` |调用 `login:uid:` 方法时传入的用户 ID 有问题。 | |ByteRTCLoginErrorCodeServerError |`9` |调用 `login:uid:` 登录时服务器错误。 | ## UserMessageSendResult 类型：`enum` 发送消息结果，成功或失败，及失败原因 |属性 |值 |描述 | |---|---|---| |USER_MESSAGE_SEND_RESULT_SUCCESS |`0` |发送消息成功 | |USER_MESSAGE_SEND_RESULT_TIMEOUT |`1` |发送超时，没有发送 | |USER_MESSAGE_SEND_RESULT_BROKEN |`2` |通道断开，没有发送 | |USER_MESSAGE_SEND_RESULT_NO_RECEIVER |`3` |找不到接收方 | |USER_MESSAGE_SEND_RESULT_NO_RELAY_PATH |`4` |远端用户没有登录或进房 | |USER_MESSAGE_SEND_RESULT_EXCEED_QPS |`5` |超过 QPS 限制 | |USER_MESSAGE_SEND_RESULT_NOT_JOIN |`6` |消息发送方没有加入房间 | |USER_MESSAGE_SEND_RESULT_INIT |`7` |连接未完成初始化。 | |USER_MESSAGE_SEND_RESULT_NO_CONNECTION |`8` |没有可用的数据传输通道连接 | |USER_MESSAGE_SEND_RESULT_EXCEED_MAX_LENGTH |`9` |消息超过最大长度。默认消息最大长度为 1 KB；若[启用了 RTS 高级功能](https://console.volcengine.com/rtc/cloudRTC?tab=RTSMode)，消息最大长度为 64 KB。 | |USER_MESSAGE_SEND_RESULT_EMPTY_USER |`10` |接收消息的单个用户 id 为空 | |USER_MESSAGE_SEND_RESULT_NOT_LOGIN |`11` |房间外或应用服务器消息发送方没有登录 | |USER_MESSAGE_SEND_RESULT_SERVER_PARAMS_NOT_SET |`12` |发送消息给业务方服务器之前没有设置参数 | |USER_MESSAGE_SEND_RESULT_UNKNOWN |`13` |未知错误 | |ByteRTCUserMessageSendResultSuccess |`14` |发送消息成功 | |ByteRTCUserMessageSendResultTimeout |`15` |发送超时，没有发送。 | |ByteRTCUserMessageSendResultNetworkDisconnected |`16` |通道断开，没有发送 | |ByteRTCUserMessageSendResultNoReceiver |`17` |找不到接收方 | |ByteRTCUserMessageSendResultNoRelayPath |`18` |远端用户没有登录或进房 | |ByteRTCUserMessageSendResultExceedQPS |`19` |超过 QPS 限制 | |ByteRTCUserMessageSendResultE2BSSendFailed |`20` |消息发送失败。应用服务器未收到客户端发送的消息。|\ | | |由 `sendServerMessage`/`sendServerBinaryMessage` 触发，通过 `onServerMessageSendResult` 回调。 | |ByteRTCUserMessageSendResultE2BSReturnFailed |`21` |消息发送失败。应用服务器接收到了客户端发送的消息，但响应失败。|\ | | |由 `sendServerMessage`/`sendServerBinaryMessage` 触发，通过 `onServerMessageSendResult` 回调。 | |ByteRTCUserMessageSendResultNotJoin |`22` |消息发送方没有加入房间 | |ByteRTCUserMessageSendResultInit |`23` |连接未完成初始化 | |ByteRTCUserMessageSendResultNoConnection |`24` |没有可用的数据传输通道连接 | |ByteRTCUserMessageSendResultExceedMaxLength |`25` |消息超过最大长度。默认消息最大长度为 1 KB；若[启用了 RTS 高级功能](https://console.volcengine.com/rtc/cloudRTC?tab=RTSMode)，消息最大长度为 64 KB。 | |ByteRTCUserMessageSendResultNotLogin |`27` |房间外或应用服务器消息发送方没有登录 | |ByteRTCUserMessageSendResultServerParamsNotSet |`28` |发送消息给业务方服务器之前没有设置参数 | |ByteRTCUserMessageSendResultUnknown |`29` |失败，未知错误。 | ## AudioRecordingErrorCode 类型：`enum` 音频文件录制的错误码 |属性 |值 |描述 | |---|---|---| |AUDIO_RECORDING_ERROR_CODE_ALREADY_STARTED |`0` |录制已经开始 | |AUDIO_RECORDING_ERROR_CODE_NOT_STARTED |`1` |录制还未开始 | |AUDIO_RECORDING_ERROR_CODE_OK |`2` |录制正常 | |AUDIO_RECORDING_ERROR_CODE_NO_PERMISSION |`3` |没有文件写权限 | |AUDIO_RECORDING_ERROR_CODE_NOT_IN_ROOM |`4` |没有进入房间 | |AUDIO_RECORDING_ERROR_CODE_NOT_SUPPORT |`5` |录制失败。文件格式不支持。 | |AUDIO_RECORDING_ERROR_CODE_OTHER |`6` |其他异常 | |ByteRTCAudioRecordingErrorCodeOk |`7` |录制正常 | |ByteRTCAudioRecordingErrorCodeNoPermission |`8` |没有文件写权限 | |ByteRTCAudioRecordingErrorNotInRoom |`9` |没有进入房间 | |ByteRTCAudioRecordingErrorCodeNotSupport |`10` |录制失败。文件格式不支持。 | |ByteRTCAudioRecordingErrorCodeOther |`11` |其他异常 | ## PublicStreamErrorCode 类型：`enum` WTN 流状态码 |属性 |值 |描述 | |---|---|---| |ERROR_CODE_SUCCESS |`0` |发布或订阅成功。 | |ERROR_CODE_PUSH_PARAM_ERROR |`1` |WTN 流的参数异常，请修改参数后重试。 | |ERROR_CODE_PUSH_INTERNAL_ERROR |`2` |内部错误，不可恢复，请重试。 | |ERROR_CODE_PUSH_ERROR |`3` |发布失败，将自动重试，请关注重试结果。 | |ERROR_CODE_PUSH_TIMEOUT |`4` |发布失败，10 s 后会重试，重试 3 次后自动停止。 | |ERROR_CODE_PULL_NO_PUSH_STREAM |`5` |订阅失败，发布端未开始发布流。 | |ERROR_CODE_PUSH_STATE_ERROR |`6` |服务端状态异常，将自动重试。 | |ByteRTCPublicStreamErrorCodePushStatusError |`7` |服务端状态异常，将自动重试。 | ## RTCStreamMixingErrorCode 类型：`enum` 转推直播错误码 |属性 |值 |描述 | |---|---|---| |TRANSCODER_ERROR_OK |`0` |推流成功。 | |TRANSCODER_ERROR_BASE |`1` |未定义的合流错误 | |TRANSCODER_ERROR_INVALID_PARAM |`2` |客户端 SDK 检测到无效推流参数。 | |TRANSCODER_ERROR_INVALID_STATE |`3` |状态错误，需要在状态机正常状态下发起操作 | |TRANSCODER_ERROR_INVALID_OPERATOR |`4` |无效操作 | |TRANSCODER_ERROR_TIMEOUT |`5` |转推直播任务处理超时，请检查网络状态并重试 | |TRANSCODER_ERROR_INVALID_PARAM_BY_SERVER |`6` |服务端检测到错误的推流参数 | |TRANSCODER_ERROR_SUB_TIMEOUT_BY_SERVER |`7` |对流的订阅超时 | |TRANSCODER_ERROR_INVALID_STATE_BY_SERVER |`8` |合流服务端内部错误。 | |TRANSCODER_ERROR_AUTHENTICATION_BY_CDN |`9` |合流服务端推 CDN 失败。 | |TRANSCODER_ERROR_TIMEOUT_BY_SIGNALING |`10` |服务端接收信令超时，请检查网络状态并重试。 | |TRANSCODER_ERROR_MIX_IMAGE_FAIL |`11` |图片合流失败。 | |TRANSCODER_ERROR_UNKNOW_ERROR_BY_SERVER |`12` |服务端未知错误。 | |ByteRTCStreamMixingErrorCodeOK |`13` |推流成功。 | |ByteRTCStreamMixingErrorCodeBase |`14` |未定义的合流错误 | |ByteRTCStreamMixingErrorCodeInvalidParam |`15` |客户端 SDK 检测到无效推流参数。 | |ByteRTCStreamMixingErrorCodeInvalidState |`16` |状态错误，需要在状态机正常状态下发起操作 | |ByteRTCStreamMixingErrorCodeInvalidOperator |`17` |无效操作 | |ByteRTCStreamMixingErrorCodeTimeOut |`18` |转推直播任务处理超时，请检查网络状态并重试 | |ByteRTCStreamMixingErrorCodeInvalidParamByServer |`19` |服务端检测到错误的推流参数 | |ByteRTCStreamMixingErrorCodeSubTimeoutByServer |`20` |对流的订阅超时 | |ByteRTCStreamMixingErrorCodeInvalidStateByServer |`21` |合流服务端内部错误。 | |ByteRTCStreamMixingErrorCodeAuthenticationByCDN |`22` |合流服务端推 CDN 失败。 | |ByteRTCStreamMixingErrorCodeTimeoutBySignaling |`23` |服务端接收信令超时，请检查网络状态并重试。 | |ByteRTCStreamMixingErrorCodeMixImageFail |`24` |图片合流失败。 | |ByteRTCStreamMixingErrorCodeUnKnownErrorByServer |`25` |服务端未知错误。 | ## RTCStreamSinglePushEvent 类型：`enum` 单流转推直播错误码 |属性 |值 |描述 | |---|---|---| |SINGLE_STREAM_PUSH_START |`0` |开始推流。 | |SINGLE_STREAM_PUSH_SUCCESS |`1` |推流成功。 | |SINGLE_STREAM_PUSH_FAILED |`2` |推流失败。 | |SINGLE_STREAM_PUSH_STOP |`3` |停止推流。 | |SINGLE_STREAM_PUSH_TIMEOUT |`4` |单流转推直播任务处理超时，请检查网络状态并重试。 | |SINGLE_STREAM_PUSH_PARAM_ERROR |`5` |参数错误。 | |ByteRTCSingleStreamPushEventStart |`7` |开始推流。 | |ByteRTCSingleStreamPushEventStartSuccess |`8` |推流成功。 | |ByteRTCSingleStreamPushEventStartFailed |`9` |推流失败。 | |ByteRTCSingleStreamPushEventStop |`10` |停止推流。 | |ByteRTCSingleStreamPushEventTimeout |`11` |单流转推直播任务处理超时，请检查网络状态并重试。 | |ByteRTCSingleStreamPushEventParamError |`12` |参数错误。 | ## RTCUserOfflineReason 类型：`enum` 用户离线原因 |属性 |值 |描述 | |---|---|---| |ByteRTCUserOfflineReasonQuit |`0` |远端用户调用 `leaveRoom` 方法主动退出房间。 | |ByteRTCUserOfflineReasonDropped |`1` |远端用户因网络等原因掉线。 | |ByteRTCUserOfflineReasonSwitchToInvisible |`2` |远端用户切换至隐身状态。 | |ByteRTCUserOfflineReasonKickedByAdmin |`3` |远端用户被踢出出房间。|\ | | |因调用踢出用户的 OpenAPI，远端用户被踢出房间。 | ## RoomMessageSendResult 类型：`enum` 房间内群发消息结果 |属性 |值 |描述 | |---|---|---| |ROOM_MESSAGE_SEND_RESULT_SUCCESS |`0` |发送成功 | |ROOM_MESSAGE_SEND_RESULT_EXCEED_QPS |`1` |超过 QPS 限制 | |ROOM_MESSAGE_SEND_RESULT_NOT_JOIN |`2` |发送失败。消息发送方没有加入房间。 | |ROOM_MESSAGE_SEND_RESULT_INIT |`3` |发送失败。连接未完成初始化。 | |ROOM_MESSAGE_SEND_RESULT_NO_CONNECTION |`4` |发送失败。没有可用的数据传输通道连接 | |ROOM_MESSAGE_SEND_RESULT_EXCEED_MAX_LENGTH |`5` |发送失败。消息超过最大长度。默认消息最大长度为 1 KB；若[启用了 RTS 高级功能](https://console.volcengine.com/rtc/cloudRTC?tab=RTSMode)，消息最大长度为 64 KB。 | |ROOM_MESSAGE_SEND_RESULT_UNKNOWN |`6` |发送失败。未知错误 | |ByteRTCRoomMessageSendResultSuccess |`7` |消息发送成功 | |ByteRTCRoomMessageSendResultTimeout |`8` |发送超时，没有发送 | |ByteRTCRoomMessageSendResultNetworkDisconnected |`9` |通道断开，没有发送 | |ByteRTCRoomMessageSendResultExceedQPS |`10` |超过 QPS 限制 | |ByteRTCRoomMessageSendResultNotJoin |`11` |失败，发送方未加入房间 | |ByteRTCRoomMessageSendResultInit |`12` |失败，连接未完成初始化。 | |ByteRTCRoomMessageSendResultNoConnection |`13` |失败，没有可用的连接。 | |ByteRTCRoomMessageSendResultExceedMaxLength |`14` |消息超过最大长度。默认消息最大长度为 1 KB；若[启用了 RTS 高级功能](https://console.volcengine.com/rtc/cloudRTC?tab=RTSMode)，消息最大长度为 64 KB。 | |ByteRTCRoomMessageSendResultUnknown |`15` |失败，未知错误。 | ## SubtitleErrorCode 类型：`enum` 字幕任务错误码。 |属性 |值 |描述 | |---|---|---| |SUBTITLE_ERROR_CODE_UNKNOW |`0` |客户端无法识别云端媒体处理发送的错误码。请联系技术支持。 | |SUBTITLE_ERROR_CODE_SUCCESS |`1` |字幕已开启。 | |SUBTITLE_ERROR_CODE_POST_PROCESS_ERROR |`2` |云端媒体处理内部出现错误，请联系技术支持。 | |SUBTITLE_ERROR_CODE_ASR_CONNECTION_ERROR |`3` |第三方服务连接失败，请联系技术支持。 | |SUBTITLE_ERROR_CODE_ASR_SERVICE_ERROR |`4` |第三方服务内部出现错误，请联系技术支持。 | |SUBTITLE_ERROR_CODE_BEFORE_JOIN_ROOM |`5` |未进房导致调用`startSubtitle`失败。请加入房间后再调用此方法。 | |SUBTITLE_ERROR_CODE_ALREADY_ON |`6` |字幕已开启，无需重复调用 `startSubtitle`。 | |SUBTITLE_ERROR_CODE_UNSUPPORTED_LANGUAGE |`7` |你选择的目标语言目前暂不支持。 | |SUBTITLE_ERROR_CODE_POST_PROCESS_TIMEOUT |`8` |云端媒体处理超时未响应，请联系技术支持。 | |ByteRTCSubtitleErrorCodeUnknow |`9` |客户端无法识别云端媒体处理发送的错误码。 | |ByteRTCSubtitleErrorCodeSuccess |`10` |字幕已开启。 | |ByteRTCSubtitleErrorCodePostProcessError |`11` |云端媒体处理内部出现错误，请联系技术支持。 | |ByteRTCSubtitleErrorCodeASRConnectionError |`12` |第三方服务连接失败，请联系技术支持。 | |ByteRTCSubtitleErrorCodeASRServiceError |`13` |第三方服务内部出现错误，请联系技术支持。 | |ByteRTCSubtitleErrorCodeBeforeJoinRoom |`14` |未进房导致调用`startSubtitle`失败。请加入房间后再调用此方法。 | |ByteRTCSubtitleErrorCodeAlreadyOn |`15` |字幕已开启，无需重复调用 `startSubtitle`。 | |ByteRTCSubtitleErrorCodeUnsupportedLanguage |`16` |用户选择的目标语言目前暂不支持。 | |ByteRTCSubtitleErrorCodePostProcessTimeout |`17` |云端媒体处理超时未响应，请联系技术支持。 | ## KTVErrorCode 类型：`enum` KTV 错误码。 |属性 |值 |描述 | |---|---|---| |OK |`0` |成功。 | |APPID_INVALID |`1` |AppID 异常。 | |PARAS_INVALID |`2` |非法参数，传入的参数不正确。 | |GET_MUSIC_FAILED |`3` |获取歌曲资源失败。 | |GET_LYRIC_FAILED |`4` |获取歌词失败。 | |MUSIC_TAKEDOWN |`5` |歌曲下架。 | |MUSIC_DOWNLOAD |`6` |歌曲文件下载失败。 | |MIDI_DOWNLOAD_FAILED |`7` |MIDI 文件下载失败。 | |SYSTEM_BUSY |`8` |系统繁忙。 | |NETWORK |`9` |网络异常。 | |NOT_JOIN_ROOM |`10` |KTV 功能未加入房间。 | |PARSE_DATA |`11` |解析数据失败。 | |DOWNLOADING |`12` |已在下载中。 | |INTERNAL_DOMAIN |`13` |内部错误，联系技术支持人员。 | |INSUFFICIENT_DISK_SPACE |`14` |下载失败，磁盘空间不足。清除缓存后重试。 | |MUSIC_DECRYPTION_FAILED |`15` |下载失败，音乐文件解密失败，联系技术支持人员。 | |FILE_RENAME_FAILED |`16` |下载失败，音乐文件重命名失败，请重试。 | |DOWNLOAD_TIMEOUT |`17` |下载失败，下载超时，请重试。 | |CLEAR_CACHE_FAILED |`18` |清除缓存失败，可能原因是文件被占用或者系统异常，请重试。 | |DOWNLOAD_CANCELED |`19` |取消下载。 | |ByteRTCKTVErrorCodeOK |`20` |成功。 | |ByteRTCKTVErrorCodeAppidInValid |`21` |AppID 异常。 | |ByteRTCKTVErrorCodeParasInValid |`22` |非法参数，传入的参数不正确。 | |ByteRTCKTVErrorCodeGetMusicFailed |`23` |获取歌曲资源失败。 | |ByteRTCKTVErrorCodeGetLyricFailed |`24` |获取歌词失败。 | |ByteRTCKTVErrorCodeMusicTakedown |`25` |歌曲下架。 | |ByteRTCKTVErrorCodeMusicDownload |`26` |歌曲文件下载失败。 | |ByteRTCKTVErrorCodeMidiDownloadFailed |`27` |MIDI 文件下载失败。 | |ByteRTCKTVErrorCodeSystemBusy |`28` |系统繁忙。 | |ByteRTCKTVErrorCodeNetwork |`29` |网络异常。 | |ByteRTCKTVErrorCodeNotJoinRoom |`30` |KTV 功能未加入房间。 | |ByteRTCKTVErrorCodeParseData |`31` |解析数据失败。 | |ByteRTCKTVErrorCodeDownloading |`32` |已在下载中。 | |ByteRTCKTVErrorCodeInternal |`33` |内部错误，联系技术支持人员。 | |ByteRTCKTVErrorCodeInsufficientDiskSpace |`34` |下载失败，磁盘空间不足。清除缓存后重试。 | |ByteRTCKTVErrorCodeMusicDecryptionFailed |`35` |下载失败，音乐文件解密失败，联系技术支持人员。 | |ByteRTCKTVErrorCodeFileRenameFailed |`36` |下载失败，音乐文件重命名失败，请重试。 | |ByteRTCKTVErrorCodeDownloadTimeOut |`37` |下载失败，下载超时，请重试。 | |ByteRTCKTVErrorCodeClearCacheFailed |`38` |清除缓存失败，可能原因是文件被占用或者系统异常，请重试。 | |ByteRTCKTVErrorCodeDownloadCanceled |`39` |取消下载。 |

实时音视频