# 枚举类 (/zh-CN/api-reference/local-server-recording/java/enum) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## AreaCode [#areacode] 连接区域,即 SDK 所连接服务器所在的区域。 #### 枚举值 [#枚举值] | 枚举值 | 描述 | | --- | --- | | `AREA_CODE_CN` | (0x00000001):中国大陆区域。 | | `AREA_CODE_NA` | (0x00000002):北美区域。 | | `AREA_CODE_EU` | (0x00000004):欧洲区域。 | | `AREA_CODE_AS` | (0x00000008):亚洲区域(不含中国大陆)。 | | `AREA_CODE_JP` | (0x00000010):日本区域。 | | `AREA_CODE_IN` | (0x00000020):印度区域。 | | `AREA_CODE_GLOB` | (0xFFFFFFFF):(默认)全球区域。 | ## ChannelProfileType [#channelprofiletype] 频道场景类型。 #### 枚举值 [#枚举值-1] | 枚举值 | 描述 | | --- | --- | | `CHANNEL_PROFILE_COMMUNICATION` | (0):通信场景,优先保证通话流畅性,适用于一对一通话。 | | `CHANNEL_PROFILE_LIVE_BROADCASTING` | (1):(默认)互动直播场景,优先支持在频道中容纳大量观众。 | | `CHANNEL_PROFILE_GAME` | (2):游戏场景。该场景已废弃。 | | `CHANNEL_PROFILE_CLOUD_GAMING` | (3):云游戏场景。该场景已废弃。 | | `CHANNEL_PROFILE_COMMUNICATION_1v1` | (4):通信 1v1 场景。该场景已废弃。 | ## AudioScenarioType [#audioscenariotype] 音频场景类型。 #### 枚举值 [#枚举值-2] | 枚举值 | 描述 | | --- | --- | | `AUDIO_SCENARIO_DEFAULT` | (0):自动场景,SDK 会根据用户角色和音频路由自动选择合适的音频质量。 | | `AUDIO_SCENARIO_GAME_STREAMING` | (3):直播游戏场景,需在扬声器中启用游戏音效。推荐使用此场景以实现高保真音乐播放。 | | `AUDIO_SCENARIO_CHATROOM` | (5):聊天室场景,即使将客户端角色设置为观众,也需保持录音。通常也可通过静音 API 实现相同效果,此“非正交”行为用于保持 API 向后兼容。 | | `AUDIO_SCENARIO_CHORUS` | (7):实时合唱场景,适用于网络条件良好且对超低延迟有要求的用户。 | | `AUDIO_SCENARIO_MEETING` | (8):会议场景。 | | `AUDIO_SCENARIO_AI_SERVER` | (9):AI Server 场景。 | | `AUDIO_SCENARIO_AI_CLIENT` | (10):AI Client 场景。 | | `AUDIO_SCENARIO_NUM` | (11):枚举值的数量。 | ## EncryptionErrorType [#encryptionerrortype] 加密错误类型。 #### 枚举值 [#枚举值-3] | 枚举值 | 描述 | | --- | --- | | `ENCRYPTION_ERROR_INTERNAL_FAILURE` | (0):因内部原因导致的加密错误。 | | `ENCRYPTION_ERROR_DECRYPTION_FAILURE` | (1):媒体流解密失败。请确保接收端和发送端使用相同的加密模式和密钥。 | | `ENCRYPTION_ERROR_ENCRYPTION_FAILURE` | (2):媒体流加密失败。 | | `ENCRYPTION_ERROR_DATASTREAM_DECRYPTION_FAILURE` | (3):数据流解密失败。请确保接收端和发送端使用相同的加密模式和密钥。 | | `ENCRYPTION_ERROR_DATASTREAM_ENCRYPTION_FAILURE` | (4):数据流加密失败。 | ## ErrorCodeType [#errorcodetype] 错误码。 #### 枚举值 [#枚举值-4] | 枚举值 | 描述 | | --- | --- | | `ERR_OK` | (0):没有错误发生。 | | `ERR_FAILED` | (1):发生通用错误(无明确原因)。 | | `ERR_INVALID_ARGUMENT` | (2):参数无效。例如,指定的频道名包含非法字符。 | | `ERR_NOT_READY` | (3):SDK 模块尚未就绪。可尝试以下方案:检查音频设备;检查应用完整性;重新初始化 RTC 引擎。 | | `ERR_NOT_SUPPORTED` | (4):SDK 不支持该功能。 | | `ERR_REFUSED` | (5):请求被拒绝。 | | `ERR_BUFFER_TOO_SMALL` | (6):缓冲区大小不足,无法存储返回数据。 | | `ERR_NOT_INITIALIZED` | (7):在调用该方法前,SDK 尚未初始化。 | | `ERR_INVALID_STATE` | (8):状态无效。 | | `ERR_NO_PERMISSION` | (9):无权限。该错误仅供内部使用,不通过任何方法或回调返回给应用。 | | `ERR_TIMEDOUT` | (10):API 调用超时。部分 API 方法需要 SDK 返回执行结果,若请求处理时间超过 10 秒,则会触发该错误。 | | `ERR_CANCELED` | (11):请求被取消。该错误仅供内部使用,不通过任何方法或回调返回给应用。 | | `ERR_TOO_OFTEN` | (12):方法调用过于频繁。该错误仅供内部使用,不通过任何方法或回调返回给应用。 | | `ERR_BIND_SOCKET` | (13):SDK 绑定网络 socket 失败。该错误仅供内部使用,不通过任何方法或回调返回给应用。 | | `ERR_NET_DOWN` | (14):网络不可用。该错误仅供内部使用,不通过任何方法或回调返回给应用。 | | `ERR_JOIN_CHANNEL_REJECTED` | (17):加入频道请求被拒绝。通常发生在用户已在频道中仍调用 [`joinChannel`](/zh-CN/api-reference/local-server-recording/java/agoramediartcrecorder.java#joinchannel) 方法的情况下。 | | `ERR_LEAVE_CHANNEL_REJECTED` | (18):离开频道请求被拒绝。通常发生在用户已离开频道仍调用 [`leaveChannel`](/zh-CN/api-reference/local-server-recording/java/agoramediartcrecorder.java#leavechannel) 方法的情况下。 | | `ERR_ALREADY_IN_USE` | (19):资源已被占用,无法重复使用。 | | `ERR_ABORTED` | (20):由于请求过多,SDK 放弃该请求。该错误仅供内部使用,不通过任何方法或回调返回给应用。 | | `ERR_INIT_NET_ENGINE` | (21):在 Windows 平台上,特定防火墙设置可能导致 SDK 初始化失败并崩溃。 | | `ERR_RESOURCE_LIMITED` | (22):应用占用系统资源过多,SDK 无法分配资源。 | | `ERR_INVALID_APP_ID` | (101):App ID 无效,通常是因为 App ID 的数据格式不正确。解决方案:检查 App ID 的数据格式,确保使用正确的 App ID 初始化声网服务。 | | `ERR_INVALID_CHANNEL_NAME` | (102):频道名无效。请尝试使用有效的频道名重新加入频道。 | | `ERR_NO_SERVER_RESOURCES` | (103):在指定区域无法获取服务器资源。请在调用 [`initialize`](/zh-CN/api-reference/local-server-recording/java/agoraservice.java#initialize) 时尝试指定其他区域。 | | `ERR_TOKEN_EXPIRED` | [enum-java-html-4-25-1 details](#table-slot-enum-java-html-4-25-1) | | `ERR_INVALID_TOKEN` | [enum-java-html-4-26-1 details](#table-slot-enum-java-html-4-26-1) | | `ERR_STREAM_MESSAGE_TIMEOUT` | (117):数据流传输超时。 | | `ERR_SET_CLIENT_ROLE_NOT_AUTHORIZED` | (119):切换用户角色失败。请尝试重新加入频道。 | | `ERR_DECRYPTION_FAILED` | (120):媒体流解密失败。用户可能使用了错误的密码加入频道。请检查设置或尝试重新加入频道。 | | `ERR_INVALID_USER_ID` | (121):用户 ID 无效。 | | `ERR_DATASTREAM_DECRYPTION_FAILED` | (122):数据流解密失败。对端可能使用了错误的密码加入频道,或未启用数据流加密。 | | `ERR_CLIENT_IS_BANNED_BY_SERVER` | (123):应用被服务器封禁。 | | `ERR_LICENSE_CREDENTIAL_INVALID` | (131):License 凭证无效。 | | `ERR_INVALID_USER_ACCOUNT` | (134):用户账号无效,通常是因为账号格式不正确。 | | `ERR_LOAD_MEDIA_ENGINE` | (1001):加载媒体引擎失败。 | | `ERR_ADM_GENERAL_ERROR` | (1005):音频设备模块:发生通用错误(无具体原因)。请检查音频设备是否被其他应用占用,或尝试重新加入频道。 | | `ERR_ADM_INIT_PLAYOUT` | (1008):音频设备模块:初始化播放设备失败。 | | `ERR_ADM_START_PLAYOUT` | (1009):音频设备模块:启动播放设备失败。 | | `ERR_ADM_STOP_PLAYOUT` | (1010):音频设备模块:停止播放设备失败。 | | `ERR_ADM_INIT_RECORDING` | (1011):音频设备模块:初始化录音设备失败。 | | `ERR_ADM_START_RECORDING` | (1012):音频设备模块:启动录音设备失败。 | | `ERR_ADM_STOP_RECORDING` | (1013):音频设备模块:停止录音设备失败。 | | `ERR_VDM_CAMERA_NOT_AUTHORIZED` | (1501):视频设备模块:摄像头未授权。 | **enum-java-html-4-25-1 details** (109): Token 已过期,可能原因如下: - Token 授权超时: Token 生成后需在 24 小时内使用,否则将失效; - Token 权限过期:生成 Token 时设置的权限有效期已过,例如设置为 7 天,则 Token 在使用后 7 天过期。 此时用户将无法访问声网服务,无法通话或被踢出频道。 解决方案:无论是授权超时还是权限过期,均需在服务器端重新生成 Token 并尝试重新加入频道。 **enum-java-html-4-26-1 details** (110): Token 无效,可能原因如下: - 项目启用了 App 证书,但加入频道时未提供 Token。 - 项目未启用 App 证书,但加入频道时提供了 Token。 - 用于生成 Token 的 App ID、用户 ID 和频道名与加入频道时使用的不一致。 解决方案: - 加入频道前,检查项目是否启用了 App 证书。若启用,必须提供 Token;若未启用,则无需提供 Token。 - 使用 Token 加入频道时,确保用于生成 Token 的 App ID、用户 ID 和频道名与初始化声网服务及加入频道时使用的一致。 ## LogLevel [#loglevel] 日志等级。 #### 枚举值 [#枚举值-5] | 枚举值 | 描述 | | --- | --- | | `LOG_LEVEL_NONE` | (0x0000):不输出任何日志。 | | `LOG_LEVEL_INFO` | (0x0001):输出 INFO 级别日志。 | | `LOG_LEVEL_WARN` | (0x0002):输出 WARNING 级别日志。 | | `LOG_LEVEL_ERROR` | (0x0004):输出 ERROR 级别日志。 | | `LOG_LEVEL_FATAL` | (0x0008):输出 CRITICAL 级别日志。 | ## EncryptionMode [#encryptionmode] 加密模式。 #### 枚举值 [#枚举值-6] | 枚举值 | 描述 | | --- | --- | | `AES_128_XTS` | (1):使用 128 位 AES 加密,XTS 模式。 | | `AES_128_ECB` | (2):使用 128 位 AES 加密,ECB 模式。 | | `AES_256_XTS` | (3):使用 256 位 AES 加密,XTS 模式。 | | `SM4_128_ECB` | (4):使用 128 位 SM4 加密,ECB 模式。 | | `AES_128_GCM` | (5):使用 128 位 AES 加密,GCM 模式。 | | `AES_256_GCM` | (6):使用 256 位 AES 加密,GCM 模式。 | | `AES_128_GCM2` | (7):(默认)使用 128 位 AES 加密,GCM 模式。该模式需设置 salt(`encryptionKdfSalt`)。 | | `AES_256_GCM2` | (8):使用 256 位 AES 加密,GCM 模式。该模式需设置 salt(`encryptionKdfSalt`)。 | | `MODE_END` | (9):枚举值边界。 | ## VideoStreamType [#videostreamtype] 视频流类型。 #### 枚举值 [#枚举值-7] | 枚举值 | 描述 | | --- | --- | | `VIDEO_STREAM_HIGH` | (0):高质量视频流,分辨率和码率最高。 | | `VIDEO_STREAM_LOW` | (1):低质量视频流,分辨率和码率最低。 | ## MediaRecorderContainerFormat [#mediarecordercontainerformat] 录制文件的格式。 #### 枚举值 [#枚举值-8] | 枚举值 | 描述 | | --- | --- | | `FORMAT_MP4` | (1):默认使用 MP4 格式(默认)。 | ## MediaRecorderStreamType [#mediarecorderstreamtype] 录制内容类型。 #### 枚举值 [#枚举值-9] | 枚举值 | 描述 | | --- | --- | | `STREAM_TYPE_AUDIO` | (0x01):仅录制音频。 | | `STREAM_TYPE_VIDEO` | (0x02):仅录制视频。 | | `STREAM_TYPE_BOTH` | (0x03):(默认)录制音频和视频。 | ## VideoSourceType [#videosourcetype] 视频源类型。 #### 枚举值 [#枚举值-10] | 枚举值 | 描述 | | --- | --- | | `VIDEO_SOURCE_CAMERA_PRIMARY` | (0):主摄像头采集的视频。 | | `VIDEO_SOURCE_CAMERA` | (0):主摄像头采集的视频。 | | `VIDEO_SOURCE_CAMERA_SECONDARY` | (1):第二路摄像头采集的视频。 | | `VIDEO_SOURCE_SCREEN_PRIMARY` | (2):主屏幕共享的视频。 | | `VIDEO_SOURCE_SCREEN` | (2):主屏幕共享的视频。 | | `VIDEO_SOURCE_SCREEN_SECONDARY` | (3):第二路屏幕共享的视频。 | | `VIDEO_SOURCE_CUSTOM` | (4):自定义视频源。 | | `VIDEO_SOURCE_MEDIA_PLAYER` | (5):媒体播放器共享的视频。 | | `VIDEO_SOURCE_RTC_IMAGE_PNG` | (6):PNG 图像生成的视频。 | | `VIDEO_SOURCE_RTC_IMAGE_JPEG` | (7):JPEG 图像生成的视频。 | | `VIDEO_SOURCE_RTC_IMAGE_GIF` | (8):GIF 图像生成的视频。 | | `VIDEO_SOURCE_REMOTE` | (9):接收的远端视频。 | | `VIDEO_SOURCE_TRANSCODED` | (10):用于本地合图的视频。 | | `VIDEO_SOURCE_CAMERA_THIRD` | (11):第三路摄像头采集的视频。 | | `VIDEO_SOURCE_CAMERA_FOURTH` | (12):第四路摄像头采集的视频。 | | `VIDEO_SOURCE_SCREEN_THIRD` | (13):第三路屏幕共享的视频。 | | `VIDEO_SOURCE_SCREEN_FOURTH` | (14):第四路屏幕共享的视频。 | | `VIDEO_SOURCE_SPEECH_DRIVEN` | (15):语音驱动生成的视频。 | | `VIDEO_SOURCE_UNKNOWN` | (100):未知类型的视频源。 | ## WatermarkSourceType [#watermarksourcetype] 水印源类型。 #### 枚举值 [#枚举值-11] | 枚举值 | 描述 | | --- | --- | | `LITERA` | (0):水印源为文字。 | | `TIMESTAMPS` | (1):水印源为时间戳。 | | `PICTURE` | (2):水印源为图片。 | ## WatermarkFitMode [#watermarkfitmode] 水印的适配模式。 #### 枚举值 [#枚举值-12] | 枚举值 | 描述 | | --- | --- | | `FIT_MODE_COVER_POSITION` | (0):使用在 [`WatermarkOptions`](/zh-CN/api-reference/local-server-recording/java/struct#watermarkoptions) 中设置的 `positionInLandscapeMode` 和 `positionInPortraitMode` 值,[`WatermarkRatio`](/zh-CN/api-reference/local-server-recording/java/struct#watermarkratio) 中的设置无效。 | | `FIT_MODE_USE_IMAGE_RATIO` | (1):使用在 [`WatermarkRatio`](/zh-CN/api-reference/local-server-recording/java/struct#watermarkratio) 中设置的值,[`WatermarkOptions`](/zh-CN/api-reference/local-server-recording/java/struct#watermarkoptions) 中的 `positionInLandscapeMode` 和 `positionInPortraitMode` 设置无效。 | ## ConnectionChangedReasonType [#connectionchangedreasontype] 连接状态变化的原因。 #### 枚举值 [#枚举值-13] | 枚举值 | 描述 | | --- | --- | | `CONNECTION_CHANGED_UNKNOWN` | (-1):未知原因。 | | `CONNECTION_CHANGED_CONNECTING` | (0):SDK 正在连接服务器。 | | `CONNECTION_CHANGED_JOIN_SUCCESS` | (1):SDK 成功加入频道。 | | `CONNECTION_CHANGED_INTERRUPTED` | (2):SDK 与服务器的连接已中断。 | | `CONNECTION_CHANGED_BANNED_BY_SERVER` | (3):SDK 与服务器的连接被服务器禁止,通常是用户被服务器踢出频道所致。 | | `CONNECTION_CHANGED_JOIN_FAILED` | (4):SDK 加入频道失败。当失败持续超过 20 分钟时触发该错误,并停止重连。 | | `CONNECTION_CHANGED_LEAVE_CHANNEL` | (5):SDK 已离开频道。 | | `CONNECTION_CHANGED_INVALID_APP_ID` | (6):连接失败,App ID 无效。 | | `CONNECTION_CHANGED_INVALID_CHANNEL_NAME` | (7):连接失败,频道名无效。请使用有效的频道名重新加入。 | | `CONNECTION_CHANGED_INVALID_TOKEN` | (8):连接失败, Token 无效。常见原因包括:项目在声网控制台启用了 App 证书,但加入频道时未使用 Token;调用 [`joinChannel`](/zh-CN/api-reference/local-server-recording/java/agoramediartcrecorder.java#joinchannel) 时指定的 uid 与生成 Token 时传入的 uid 不一致。 | | `CONNECTION_CHANGED_TOKEN_EXPIRED` | (9):连接失败, Token 已过期。 | | `CONNECTION_CHANGED_REJECTED_BY_SERVER` | (10):连接被服务器拒绝。常见原因包括:用户已在频道中仍调用 [`joinChannel`](/zh-CN/api-reference/local-server-recording/java/agoramediartcrecorder.java#joinchannel) 加入频道;或在通话前测试期间尝试加入频道,需在测试结束后再加入。 | | `CONNECTION_CHANGED_SETTING_PROXY_SERVER` | (11):由于设置了代理服务器,连接状态变为重连中。 | | `CONNECTION_CHANGED_RENEW_TOKEN` | (12):由于 Token 被更新,连接状态发生变化。 | | `CONNECTION_CHANGED_CLIENT_IP_ADDRESS_CHANGED` | (13):客户端 IP 地址发生变化,可能由于网络类型、IP 地址或端口变化所致。 | | `CONNECTION_CHANGED_KEEP_ALIVE_TIMEOUT` | (14):SDK 与声网边缘服务器之间的连接保活超时,连接状态变为 `CONNECTION_STATE_RECONNECTING`。 | | `CONNECTION_CHANGED_REJOIN_SUCCESS` | (15):SDK 成功重新加入频道。 | | `CONNECTION_CHANGED_LOST` | (16):SDK 与服务器的连接已丢失。 | | `CONNECTION_CHANGED_ECHO_TEST` | (17):连接状态变化由回声测试引起。 | | `CONNECTION_CHANGED_CLIENT_IP_ADDRESS_CHANGED_BY_USER` | (18):本地 IP 地址被用户更改。 | | `CONNECTION_CHANGED_SAME_UID_LOGIN` | (19):连接失败,原因是在另一设备上使用相同 uid 加入了相同频道。 | | `CONNECTION_CHANGED_TOO_MANY_BROADCASTERS` | (20):连接失败,频道中主播数量过多。 | | `CONNECTION_CHANGED_LICENSE_VALIDATION_FAILURE` | (21):连接失败,License 校验失败。 | | `CONNECTION_CHANGED_CERTIFICATION_VERIFY_FAILURE` | (22):连接失败,证书验证失败。 | | `CONNECTION_CHANGED_STREAM_CHANNEL_NOT_AVAILABLE` | (23):连接失败,未授予流通道权限。 | | `CONNECTION_CHANGED_INCONSISTENT_APPID` | (24):连接失败,使用了不一致的 App ID 加入频道。 | ## UserOfflineReasonType [#userofflinereasontype] 用户离线的原因。 #### 枚举值 [#枚举值-14] | 枚举值 | 描述 | | --- | --- | | `USER_OFFLINE_UNKNOWN` | (-1):因未知原因离线。 | | `USER_OFFLINE_QUIT` | (0):用户离开当前频道。 | | `USER_OFFLINE_DROPPED` | (1):在一定时间内未收到数据包,SDK 超时,用户掉线。如果用户退出通话但消息未成功传递给 SDK(如信道不可靠),SDK 也会认为用户掉线。 | | `USER_OFFLINE_BECOME_AUDIENCE` | (2):用户将客户端角色从主播切换为观众。 | ## RemoteVideoState [#remotevideostate] 远端视频的状态。 #### 枚举值 [#枚举值-15] | 枚举值 | 描述 | | --- | --- | | `REMOTE_VIDEO_STATE_UNKNOWN` | (-1):远端视频处于未知状态。 | | `REMOTE_VIDEO_STATE_STOPPED` | (0):远端视频处于默认状态。SDK 在以下情况下会报告该状态:`REMOTE_VIDEO_STATE_REASON_LOCAL_MUTED`(3)、`REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED`(5)、`REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE`(7)或 `REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK`(8)。 | | `REMOTE_VIDEO_STATE_STARTING` | (1):已接收到首个远端视频包。 | | `REMOTE_VIDEO_STATE_DECODING` | (2):远端视频流已解码并正常播放。SDK 在以下情况下会报告该状态:`REMOTE_VIDEO_STATE_REASON_NETWORK_RECOVERY`(2)、`REMOTE_VIDEO_STATE_REASON_LOCAL_UNMUTED`(4)、`REMOTE_VIDEO_STATE_REASON_REMOTE_UNMUTED`(6)或 `REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK_RECOVERY`(9)。 | | `REMOTE_VIDEO_STATE_FROZEN` | (3):远端视频卡顿,可能由于 `REMOTE_VIDEO_STATE_REASON_NETWORK_CONGESTION`(1)导致。 | | `REMOTE_VIDEO_STATE_FAILED` | (4):远端视频启动失败。SDK 在 `REMOTE_VIDEO_STATE_REASON_INTERNAL`(0)情况下会报告该状态。 | ## RemoteVideoStateReason [#remotevideostatereason] 远端视频状态变化的原因。 #### 枚举值 [#枚举值-16] | 枚举值 | 描述 | | --- | --- | | `REMOTE_VIDEO_STATE_REASON_UNKNOWN` | (-1):未知原因。 | | `REMOTE_VIDEO_STATE_REASON_INTERNAL` | (0):远端视频状态发生变化时,SDK 上报该原因。 | | `REMOTE_VIDEO_STATE_REASON_NETWORK_CONGESTION` | (1):网络拥塞导致远端视频状态变化。 | | `REMOTE_VIDEO_STATE_REASON_NETWORK_RECOVERY` | (2):网络恢复导致远端视频状态变化。 | | `REMOTE_VIDEO_STATE_REASON_LOCAL_MUTED` | (3):本地用户停止接收远端视频流或关闭视频模块。 | | `REMOTE_VIDEO_STATE_REASON_LOCAL_UNMUTED` | (4):本地用户恢复接收远端视频流或开启视频模块。 | | `REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED` | (5):远端用户停止发送视频流或关闭视频模块。 | | `REMOTE_VIDEO_STATE_REASON_REMOTE_UNMUTED` | (6):远端用户恢复发送视频流或开启视频模块。 | | `REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE` | (7):远端用户离开频道。 | | `REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK` | (8):由于网络条件差,远端音视频流降级为纯音频流。 | | `REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK_RECOVERY` | (9):网络条件改善后,远端纯音频流恢复为音视频流。 | | `REMOTE_VIDEO_STATE_REASON_VIDEO_STREAM_TYPE_CHANGE_TO_LOW` | (10):(仅用于内部)远端视频流类型切换为低质量流。 | | `REMOTE_VIDEO_STATE_REASON_VIDEO_STREAM_TYPE_CHANGE_TO_HIGH` | (11):(仅用于内部)远端视频流类型切换为高质量流。 | | `REMOTE_VIDEO_STATE_REASON_SDK_IN_BACKGROUND` | (12):(仅适用于 iOS 平台)远端用户的 App 处于后台状态。 | | `REMOTE_VIDEO_STATE_REASON_CODEC_NOT_SUPPORT` | (13):解码器不支持远端视频流。 | ## RemoteAudioState [#remoteaudiostate] 远端音频状态。 #### 枚举值 [#枚举值-17] | 枚举值 | 描述 | | --- | --- | | `REMOTE_AUDIO_STATE_UNKNOWN` | (-1):远端音频状态未知。 | | `REMOTE_AUDIO_STATE_STOPPED` | (0):远端音频处于默认状态。当出现 `REMOTE_AUDIO_REASON_LOCAL_MUTED(3)`、`REMOTE_AUDIO_REASON_REMOTE_MUTED(5)` 或 `REMOTE_AUDIO_REASON_REMOTE_OFFLINE(7)` 时,SDK 会报告该状态。 | | `REMOTE_AUDIO_STATE_STARTING` | (1):已接收到首个远端音频数据包。 | | `REMOTE_AUDIO_STATE_DECODING` | (2):远端音频流已解码并正常播放。当出现 `REMOTE_AUDIO_REASON_NETWORK_RECOVERY(2)`、`REMOTE_AUDIO_REASON_LOCAL_UNMUTED(4)` 或 `REMOTE_AUDIO_REASON_REMOTE_UNMUTED(6)` 时,SDK 会报告该状态。 | | `REMOTE_AUDIO_STATE_FROZEN` | (3):远端音频已冻结。当出现 `REMOTE_AUDIO_REASON_NETWORK_CONGESTION(1)` 时,SDK 会报告该状态。 | | `REMOTE_AUDIO_STATE_FAILED` | (4):远端音频启动失败。当出现 `REMOTE_AUDIO_REASON_INTERNAL(0)` 时,SDK 会报告该状态。 | ## RemoteAudioStateReason [#remoteaudiostatereason] 远端音频状态变化的原因。 #### 枚举值 [#枚举值-18] | 枚举值 | 描述 | | --- | --- | | `REMOTE_AUDIO_REASON_UNKNOWN` | (-1):未知原因。 | | `REMOTE_AUDIO_REASON_INTERNAL` | (0):远端视频状态发生变化时触发。 | | `REMOTE_AUDIO_REASON_NETWORK_CONGESTION` | (1):网络拥塞导致音频状态变化。 | | `REMOTE_AUDIO_REASON_NETWORK_RECOVERY` | (2):网络恢复导致音频状态变化。 | | `REMOTE_AUDIO_REASON_LOCAL_MUTED` | (3):本地用户停止接收远端音频流或关闭音频模块。 | | `REMOTE_AUDIO_REASON_LOCAL_UNMUTED` | (4):本地用户恢复接收远端音频流或开启音频模块。 | | `REMOTE_AUDIO_REASON_REMOTE_MUTED` | (5):远端用户停止发送音频流或关闭音频模块。 | | `REMOTE_AUDIO_REASON_REMOTE_UNMUTED` | (6):远端用户恢复发送音频流或开启音频模块。 | | `REMOTE_AUDIO_REASON_REMOTE_OFFLINE` | (7):远端用户离开频道。 | | `REMOTE_AUDIO_REASON_NO_PACKET_RECEIVE` | (8):本地用户未收到远端用户的任何音频数据包。 | | `REMOTE_AUDIO_REASON_LOCAL_PLAY_FAILED` | (9):本地用户收到远端音频数据包但播放失败。 | ## RecorderState [#recorderstate] 当前录制状态。 :::info[信息] 自 v3.5.2 版本新增。 ::: #### 枚举值 [#枚举值-19] | 枚举值 | 描述 | | --- | --- | | `RECORDER_STATE_ERROR` | (-1):录制过程中发生错误。详见 [`RecorderReasonCode`](/zh-CN/api-reference/local-server-recording/java/enum#recorderreasoncode)。 | | `RECORDER_STATE_START` | (2):音视频录制已开始。 | | `RECORDER_STATE_STOP` | (3):音视频录制已停止。 | ## RecorderReasonCode [#recorderreasoncode] 状态变更的原因。 :::info[信息] 自 v3.5.2 版本新增。 ::: #### 枚举值 [#枚举值-20] | 枚举值 | 描述 | | --- | --- | | `RECORDER_REASON_UNKNOWN` | (-1):未知原因。 | | `RECORDER_REASON_NONE` | (0):无错误发生。 | | `RECORDER_REASON_WRITE_FAILED` | (1):无法将录制数据写入文件。 | | `RECORDER_REASON_NO_STREAM` | (2):未检测到可录制的音视频流,或录制过程中音视频流中断超过 5 秒。 | | `RECORDER_REASON_OVER_MAX_DURATION` | (3):录制时长超过上限。 | | `RECORDER_REASON_CONFIG_CHANGED` | (4):录制配置发生变更。 | ## LocalProxyMode [#localproxymode] 本地代理连接模式类型。 #### 枚举值 [#枚举值-21] | 枚举值 | 描述 | | --- | --- | | `ConnectivityFirst` | (0):优先连接本地代理,若连接失败,则回退至 sdrtn。 | | `LocalOnly` | (1):仅连接本地代理。 | ## VideoFrameCaptureType [#videoframecapturetype] 视频帧采集类型。 #### 枚举值 [#枚举值-22] | 枚举值 | 描述 | | --- | --- | | `VIDEO_FORMAT_ENCODED_FRAME_TYPE` | (0):编码后的视频帧。 | | `VIDEO_FORMAT_YUV_FRAME_TYPE` | (1):YUV 视频帧。 | | `VIDEO_FORMAT_JPG_FRAME_TYPE` | (2):JPG 视频帧(内存中)。 | | `VIDEO_FORMAT_JPG_FILE_TYPE` | (3):保存到磁盘的 JPG 文件。 | ## VideoCodecType [#videocodectype] 视频编解码器类型。 #### 枚举值 [#枚举值-23] | 枚举值 | 描述 | | --- | --- | | `VIDEO_CODEC_NONE` | (0):无视频编解码器。 | | `VIDEO_CODEC_VP8` | (1):标准 VP8 编解码器。 | | `VIDEO_CODEC_H264` | (2):标准 H.264 编解码器。 | | `VIDEO_CODEC_H265` | (3):标准 H.265 编解码器。 | | `VIDEO_CODEC_GENERIC` | (6):通用类型,用于原始或加密的视频帧。 | | `VIDEO_CODEC_GENERIC_H264` | (7):通用 H.264 编解码器。 | | `VIDEO_CODEC_AV1` | (12):AV1 编解码器。 | | `VIDEO_CODEC_VP9` | (13):VP9 编解码器。 | | `VIDEO_CODEC_GENERIC_JPEG` | (20):通用 JPEG 编解码器。 | ## VideoFrameType [#videoframetype] 视频帧类型。 #### 枚举值 [#枚举值-24] | 枚举值 | 描述 | | --- | --- | | `VIDEO_FRAME_TYPE_BLANK_FRAME` | (0):黑帧。 | | `VIDEO_FRAME_TYPE_KEY_FRAME` | (3):关键帧。 | | `VIDEO_FRAME_TYPE_DELTA_FRAME` | (4):差值帧。 | | `VIDEO_FRAME_TYPE_B_FRAME` | (5):B 帧。 | | `VIDEO_FRAME_TYPE_DROPPABLE_FRAME` | (6):可丢弃帧。 | | `VIDEO_FRAME_TYPE_UNKNOW` | (7):未知帧。 | ## VideoOrientation [#videoorientation] 视频旋转信息。 #### 枚举值 [#枚举值-25] | 枚举值 | 描述 | | --- | --- | | `VIDEO_ORIENTATION_0` | (0):顺时针旋转视频 0 度。 | | `VIDEO_ORIENTATION_90` | (90):顺时针旋转视频 90 度。 | | `VIDEO_ORIENTATION_180` | (180):顺时针旋转视频 180 度。 | | `VIDEO_ORIENTATION_270` | (270):顺时针旋转视频 270 度。 |