100: （默认）RAWDATA。

101: OpenGLES 2。

102: Unity 底层接口。

-7: SDK 尚未初始化，就调用其 API。请确认在调用 API 之前已创建 IRtcEngine 对象并完成初始化。

0: 没有错误。

-2: API 调用了无效的参数。例如指定的频道名含有非法字符。

-100: 未插入设备。

0: 视频大流。

1: 视频小流。

0: 远端视频默认初始状态。在 REMOTE_VIDEO_STATE_REASON_LOCAL_MUTED(3)、REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED(5) 或 REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE(7) 的情况下，会报告该状态。

1: 本地用户已接收远端视频首包。

2: 远端视频流正在解码，正常播放。在 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) 的情况下，会报告该状态。

3: 远端视频流卡顿。在 REMOTE_VIDEO_STATE_REASON_NETWORK_CONGESTION(1) 或 REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK(8) 的情况下，会报告该状态。

4: 远端视频流播放失败。在 REMOTE_VIDEO_STATE_REASON_INTERNAL(0) 的情况下，会报告该状态。

0: 用户主动离开。

1: 因过长时间收不到对方数据包，超时掉线。注意：由于 SDK 使用的是不可靠通道，也有可能对方主动离开本方没收到对方离开消息而误判为超时掉线。

2: （直播场景中）用户身份从主播切换为观众时触发。

0: 不输出日志信息。

0x80f: 输出所有 API 日志信息。如果你想获取最完整的日志，可以将日志级别设为该等级。

0x0f: 输出 CRITICAL、ERROR、WARNING 和 INFO 级别的日志信息。我们推荐你将日志级别设为该等级。

0x0e: 输出 CRITICAL、ERROR 和 WARNING 级别的日志信息。

0x0c: 输出 CRITICAL 和 ERROR 级别的日志信息。

0x08: 输出 CRITICAL 级别的日志信息。

0: 通信场景 (默认)。该场景下，频道内所有用户都可以发布和接收音、视频流。适用于语音通话、视频群聊等应用场景。

1: 直播场景。该场景有主播和观众两种用户角色，可以通过 SetClientRole 设置。主播可以发布和接收音视频流，观众直接接收流。适用于语聊房、视频直播、互动大班课等应用场景。

2: 游戏语音场景。频道内任何用户可自由发言。该模式下默认使用低功耗低码率的编解码器。

   @note Agora 不推荐使用该场景。

0: 低音质。采样率为 32 kHz，录制 10 分钟的文件大小为 1.2 M 左右。

1: 中音质。采样率为 32 kHz，录制 10 分钟的文件大小为 2 M 左右。

2: 高音质。采样率为 32 kHz，录制 10 分钟的文件大小为 3.75 M 左右。

-1: 使用默认的语音路由。

0: 使用耳机为语音路由。

1: 使用听筒为语音路由。

2: 使用不带麦的耳机为语音路由。

3: 使用手机的扬声器为语音路由。

4: 使用外接的扬声器为语音路由。

5: 使用蓝牙耳机为语音路由。

7: 使用 HDMI 外围设备为语音路由（仅适用于 macOS）

8: 使用 DisplayPort 外围设备为语音路由（仅适用于 macOS）

9: 使用 Apple AirPlay 为语音路由（仅适用于 macOS）

1: 网络连接断开。

• 调用 JoinChannelByKey 加入频道前的初始化阶段；
• 或调用 LeaveChannel 后的离开频道阶段。

2: 建立网络连接中。

• 该状态表示 SDK 在调用 JoinChannelByKey 后正在与指定的频道建立连接。
• 如果成功加入频道，App 会收到 OnConnectionStateChangedHandler 回调，通知当前网络状态变成 CONNECTION_STATE_CONNECTED(3)。
• 建立连接后，SDK 还会初始化媒体，一切就绪后会回调 OnJoinChannelSuccessHandler。

3: 网络已连接。 该状态表示用户已经加入频道，可以在频道内发布或订阅媒体流。如果因网络断开或切换而导致 SDK 与频道的连接中断，SDK 会自动重连，此时应用程序会收到：

• OnConnectionInterruptedHandler 回调（已废弃）。
• 同时会收到 OnConnectionStateChangedHandler：通知当前网络状态变成 CONNECTION_STATE_RECONNECTING(4)。

4: 重新建立网络连接中。该状态表示 SDK 之前曾加入过频道，但因网络等原因连接中断了，此时 SDK 会自动尝试重新接入频道。

• 如果 SDK 无法在 10 秒内重新加入频道，则 OnConnectionLostHandler 会被触发，SDK 会一直保持在 CONNECTION_STATE_RECONNECTING(4) 的状态，并不断尝试重新加入频道。
• 如果 SDK 在断开连接后，20 分钟内还是没能重新加入频道，则应用程序会收到 OnConnectionStateChangedHandler 回调，通知的网络状态进入 CONNECTION_STATE_FAILED(5)，SDK 停止尝试重连。

5: 网络连接失败。 该状态表示 SDK 已不再尝试重新加入频道，用户必须要调用 LeaveChannel 离开频道。如果用户还想重新加入频道，则需要再次调用 JoinChannelByKey。 如果 SDK 因服务器端使用 RESTful API 禁止加入频道，则应用程序会收到 OnConnectionBannedHandler 回调（已废弃）和 OnConnectionStateChangedHandler 回调。

0: 建立网络连接中。

1: 成功加入频道。

2: 网络连接中断。

3: 网络连接被服务器禁止。可能服务端踢人场景时会报这个错。

4: 加入频道失败。SDK 在尝试加入频道 20 分钟后还是没能加入频道，会返回该状态，并停止尝试重连。

5: 离开频道。

6: 不是有效的 APP ID。请更换有效的 APP ID 重新加入频道。

7: 不是有效的频道名。请更换有效的频道名重新加入频道。

8: 生成的 Token 无效。一般有以下原因：

• 在控制台上启用了 App Certificate，但加入频道未使用 Token。当启用了 App Certificate，必须使用 Token。
• 在调用 JoinChannelByKey 加入频道时指定的 uid 与生成 Token 时传入的 uid 不一致。

9: 当前使用的 Token 过期，不再有效，需要重新在你的服务端申请生成 Token。

10: 此用户被服务器禁止。一般有以下原因：

• 用户已进入频道，再次调用加入频道的 API，例如 JoinChannelByKey，会返回此状态。停止调用该方法即可。
• 用户在调用 StartEchoTest 进行通话测试时尝试加入频道。等待通话测试结束后再加入频道即可。

11: 由于设置了代理服务器，SDK 尝试重连。

12: 更新 Token 引起网络连接状态改变。

13: 客户端 IP 地址变更，可能是由于网络类型，或网络运营商的 IP 或端口发生改变引起。

14: SDK 和服务器连接保活超时，进入自动重连状态 CONNECTION_STATE_RECONNECTING(4)。

0: 上行/下行网络较弱时，不对音视频流作回退处理，但不能保证音视频流的质量。

1: 在下行网络条件较差时只接收视频小流（低分辨率、低码率视频流）。该选项只对 SetRemoteSubscribeFallbackOption 有效，对 SetLocalPublishFallbackOption 方法无效。

2: 上行/下行网络较弱时，先尝试只接收视频小流（低分辨率、低码率视频流）；如果网络环境无法显示视频，则再回退到只接收远端订阅的音频流。

（默认）无指定的内容类型。

内容类型为动画。当共享的内容是视频、电影或视频游戏时，推荐选择该内容类型。

内容类型为细节。当共享的内容是图片或文字时，推荐选择该内容类型。

0: 视频状态发生改变时，会报告该原因。

1: 网络阻塞。

2: 网络恢复正常。

3: 本地用户停止接收远端视频流或本地用户禁用视频模块。

4: 本地用户恢复接收远端视频流或本地用户启动视频模块。

5: 远端用户停止发送视频流或远端用户禁用视频模块。

6: 远端用户恢复发送视频流或远端用户启用视频模块。

7: 远端用户离开频道。

8: 弱网情况下，远端音视频流回退为音频流。

9: 网络情况改善时，远端音频流恢复为音视频流。

0: 本地视频默认初始状态。

1: 本地视频采集设备启动成功。调用 StartScreenCaptureByWindowId 方法共享窗口且共享窗口为最大化时，也会报告该状态。

2: 本地视频首帧编码成功。

3: 本地视频启动失败。

0: 本地视频状态正常。

1: 出错原因不明确。

2: 没有权限启动本地视频采集设备。

3: 本地视频采集设备正在使用中。

4: 本地视频采集失败，建议检查采集设备是否正常工作。

5: 本地视频编码失败。

12: 该错误码表示通过窗口 ID 共享的窗口已关闭，或通过窗口 ID 共享的全屏窗口已退出全屏。 退出全屏模式后，远端用户将无法看到共享的窗口。为避免远端用户看到黑屏，Agora 建议你立即结束本次共享。

报告该错误码的常见场景：

• 本地用户关闭共享的窗口时，SDK 会报告该错误码。
• 本地用户先放映幻灯片，然后共享放映中的幻灯片。结束放映时，SDK 会报告该错误码。
• 本地用户先全屏观看网页视频或网页文档，然后共享网页视频或网页文档。结束全屏时，SDK 会报告该错误码。

1: 主播，可以发布和接收音视频流。

2: 观众，默认角色，只能接收音视频流，无法发布。

-1: 设备类型未知。

0: 音频播放设备。

1: 音频采集设备。

2: 视频渲染设备。

3: 视频采集设备。

4: 音频应用播放设备。

0: 只读模式，用户仅从 AudioFrame 获取原始数据，不作任何修改。例如: 若用户通过 Unity SDK 采集数据，自己进行 RTMP 推流，则可以选择该模式。

1: 只写模式，用户替换 AudioFrame 中的数据以供 SDK 编码传输。例如: 若用户自行采集数据，可选择该模式。

2: 读写模式, 用户从 AudioFrame 获取并修改数据、修改，并返回给 SDK 进行编码传输。例如: 若用户自己有音效处理模块，且想要根据实际需要对数据进行前处理(例如变声)，则可以选择该模式。

0: 默认设置。

• 通信场景下：
  • Windows: 16 KHz 采样率，语音编码，单声道，编码码率最大值为 16 Kbps。
  • Android/iOS/macOS: 32 KHz 采样率，语音编码，单声道，编码码率最大值为 18 Kbps。
• 直播场景下：全平台为 48 KHz 采样率，音乐编码，单声道，编码码率最大值为 64 Kbps。

1: 指定 32 kHz 采样率，语音编码，单声道，编码码率最大值为 18 Kbps。

2: 指定 48 kHz 采样率，音乐编码，单声道，编码码率最大值为 64 Kbps。

3: 指定 48 kHz 采样率，音乐编码，双声道，编码码率最大值为 80 Kbps。

4: 指定 48 kHz 采样率，音乐编码，单声道，编码码率最大值为 96 Kbps。

5: 指定 48 kHz 采样率，音乐编码，双声道，编码码率最大值为 128 Kbps。

6: 指定 16 kHz 采样率，语音编码，单声道，应用回声消除算法 AES。

枚举的数量。

0: 默认的音频应用场景。

1: 娱乐场景，适用于用户需要频繁上下麦的场景。

2: 教育场景，适用于需要高流畅度和稳定性的场景。

3: 高音质语聊房场景，适用于音乐为主的场景。

4: 秀场场景，适用于需要高音质的单主播场景。

5: 游戏开黑场景，适用于只有人声的场景。

6: IoT（物联网）场景，适用于使用低功耗 IoT 设备的场景。

8: 会议场景，适用于人声为主的多人会议。

   @since v3.2.1

枚举的数量。

66: Baseline 级别的视频编码规格，一般用于低阶或需要额外容错的应用，比如视频通话、手机视频等。

77: Main 级别的视频编码规格，一般用于主流消费类电子产品，如 mp4、便携的视频播放器、PSP 和 iPad 等。

100: （默认）High 级别的视频编码规格，一般用于广播及视频碟片存储，高清电视。

32000: 32 kHz

44100: 44.1 kHz

48000: 48 kHz

710: 音乐文件正常播放。

   该状态表示 SDK 处于以下阶段：
   - 成功调用 {@link agora_gaming_rtc.IRtcEngine.StartAudioMixing StartAudioMixing} 播放音乐文件。
   - 成功调用 {@link agora_gaming_rtc.IRtcEngine.ResumeAudioMixing ResumeAudioMixing} 恢复播放音乐文件。

711: 音乐文件暂停播放。

   该状态表示 SDK 成功调用 {@link agora_gaming_rtc.IRtcEngine.PauseAudioMixing PauseAudioMixing} 暂停播放音乐文件。

713: 音乐文件停止播放。

   该状态表示 SDK 成功调用 {@link agora_gaming_rtc.IRtcEngine.StopAudioMixing StopAudioMixing} 停止播放音乐文件。

714: 音乐文件报错。

   错误类型详见: #AUDIO_MIXING_ERROR_TYPE 。

701: 音乐文件打开出错。

702: 音乐文件打开太频繁。

703: 音乐文件播放中断。

0: 音乐文件状态正常。

0: 推流未开始或已结束。成功调用 RemovePublishStreamUrl 方法删除推流地址后，也会返回该状态。

1: 正在连接 Agora 推流服务器和 RTMP 服务器。调用 AddPublishStreamUrl 方法后，会返回该状态。

2: 推流正在进行。成功推流后，会返回该状态。

3: 正在恢复推流。当 CDN 出现异常，或推流短暂中断时，SDK 会自动尝试恢复推流，并返回该状态。

• 如成功恢复推流，则进入状态 RTMP_STREAM_PUBLISH_STATE_RUNNING(2)。
• 如服务器出错或 60 秒内未成功恢复，则进入状态 RTMP_STREAM_PUBLISH_STATE_FAILURE(4)。如果觉得 60 秒太长，也可以主动调用 RemovePublishStreamUrl 和 AddPublishStreamUrl 方法尝试重连。

4: 推流失败。失败后，你可以通过返回的错误码排查错误原因，也可以再次调用 AddPublishStreamUrl 重新尝试推流。

0: 推流成功

1: 参数无效。请检查输入参数是否正确。例如如果你在调用 AddPublishStreamUrl 前没有调用 SetLiveTranscoding 设置转码参数，SDK 会返回该错误。

2: 推流已加密，不能推流

3: 推流超时未成功。可调用 AddPublishStreamUrl 重新推流。

4: 推流服务器出现错误。请调用 AddPublishStreamUrl 重新推流。

5: RTMP 服务器出现错误。

6: 推流请求过于频繁。

7: 单个主播的推流地址数目达到上线 10。请删掉一些不用的推流地址再增加推流地址。

8: 主播操作不属于自己的流。例如更新其他主播的流参数、停止其他主播的流。请检查 app 逻辑。

9: 服务器未找到这个流。

10: 推流地址格式有错误。请检查推流地址格式是否正确。

-1: 网络连接类型未知。

0: 网络连接已断开。

1: 网络类型为 LAN。

2: 网络类型为 Wi-Fi (包含热点）。

3: 网络类型为 2G 移动网络。

4: 网络类型为 3G 移动网络。

5: 网络类型为 4G 移动网络。

原声，即关闭本地美声效果。

老男人，建议用于处理男声。

小男孩，建议用于处理男声。

小女孩，建议用于处理女声。

猪八戒。

空灵。

绿巨人。

浑厚。

低沉。

圆润。

假音。

饱满。

清澈。

高亢。

嘹亮。

空旷。

磁性（男）。此枚举为男声定制化效果，不适用于女声。如果女声使用此音效设置，则音频可能会产生失真。

清新（女）。此枚举为女声定制化效果，不适用于男声。如果男声使用此音效设置，则音频可能会产生失真。

活力（女）。此枚举为女声定制化效果，不适用于男声。如果男声使用此音效设置，则音频可能会产生失真。

原声，即关闭本地音效。

KTV。

演唱会。

大叔。

少女。

录音棚。

流行。

R&B。

留声机。

流行（旧版）。

R&B（旧版）。

摇滚。

嘻哈。

演唱会（旧版）。

KTV（旧版）。

录音棚（旧版）。

虚拟立体声。虚拟立体声是指将单声道的音轨渲染出立体声的效果，使频道内所有用户听到有空间感的声音 效果。为达到更好的虚拟立体声效果，Agora 推荐在调用该方法前将 SetAudioProfile 的 profile 参 数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

0: 31 Hz

1: 62 Hz

2: 125 Hz

3: 250 Hz

4: 500 Hz

5: 1 kHz

6: 2 kHz

7: 4 kHz

8: 8 kHz

9: 16 kHz

本地视频质量不变。

因网络带宽增加，本地视频质量改善。

因网络带宽减少，本地视频质量变差。

0: 取值范围 [-20,10]，单位为 dB, 原始声音强度，即所谓的 dry signal。

1: 取值范围 [-20,10]，单位为 dB, 早期反射信号强度，即所谓的 wet signal。

2: 所需混响效果的房间尺寸，一般房间越大，混响越强，取值范围 [0,100]。

3: 取值范围 [0,200]，单位为毫秒, wet signal 的初始延迟长度，以毫秒为单位。

4: 取值范围 [0,100], 混响持续的强度。

0: LC-AAC 规格，表示基本音频编码规格。

1: HE-AAC 规格，表示高效音频编码规格。

1: 标准 VP8。

2: 标准 H264。

3: 增强 VP8。

4: 增强 H264。

中国大陆。

北美区域。

欧洲区域。

亚洲区域（中国大陆除外）。

日本。

印度。

（默认）全球。

1: 1 fps

7: 7 fps

10: 10 fps

15: 15 fps

24: 24 fps

30: 30 fps

60: 60 fps，仅适用于 WINDOWS 和 macOS 平台。

0: （默认）该模式下 SDK 输出的视频方向与采集到的视频方向一致。接收端会根据收到的视频旋转信息对视频进行旋转。该模式适用于接收端可以调整视频方向的场景。

• 如果采集的视频是横屏模式，则输出的视频也是横屏模式；
• 如果采集的视频是竖屏模式，则输出的视频也是竖屏模式。

1: 该模式下 SDK 固定输出风景（横屏）模式的视频。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该模式适用于当接收端无法调整视频方向时，如使用旁路推流场景下。

2: 该模式下 SDK 固定输出人像（竖屏）模式的视频，如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该模式适用于当接收端无法调整视频方向时，如使用旁路推流场景下。

0: （默认）降低编码帧率以保证视频质量。

1: 降低视频质量以保证编码帧率。

2: 预留参数，暂不支持。

0: YUV420

1: RGBA

0: PCM16

0: 音频播放设备。

1: 音频采集设备。

1: 表示本次 last mile 质量探测的结果是完整的。

2: 表示本次 last mile 质量探测未进行带宽预测，因此结果不完整。一个可能的原因是测试资源暂时受限。

3: 未进行 last mile 质量探测。一个可能的原因是网络连接中断。

0: 后置摄像头。

1: 前置摄像头。

0: （默认）自动调整采集参数。SDK 根据实际的采集设备性能及网络情况，选择合适的摄像头输出参数，在设备性能及视频预览质量之间，维持平衡。

1: 优先保证设备性能。SDK 根据用户在 SetVideoEncoderConfiguration 中设置编码器的分辨率和帧率，选择最接近的摄像头输出参数，从而保证设备性能。在这种情况下，预览质量接近于编码器的输出质量。

2: 中设置编码器的分辨率和帧率，选择最接近的摄像头输出参数，从而保证设备性能。在这种情况下，预览质量接近于编码器的输出质量。

0: 网络质量未知。

1: 网络质量极好。

2: 用户主观感觉和 QUALITY_EXCELLENT 差不多，但码率可能略低于 QUALITY_EXCELLENT

3: 用户主观感受有瑕疵但不影响沟通。

4: 勉强能沟通但不顺畅。

5: 网络质量非常差，基本不能沟通。

6: 完全无法沟通。

7: 暂时无法检测网络质量（未使用）。

8: 网络质量检测已开始还没完成。

1: 设备正在使用。

2: 设备被禁用。

4: 没有此设备。

8: 设备被拔出。

0: 外部视频流输入成功。

1: 外部视频流已存在。

2: 外部视频流输入未经授权。

3: 输入外部视频流超时。

4: 外部视频流输入失败。

5: 外部视频流停止输入成功。

6: 未找到要停止输入的外部视频流。

7: 要停止输入的外部视频流未经授权。

8: 停止输入外部视频流超时。

9: 停止输入外部视频流失败。

10: 输入的外部视频流被中断。

50: 用户需求优先级为高。

100: （默认）用户需求优先级为正常。

0: 本地音频默认初始状态。

1: 本地音频采集设备启动成功。

2: 本地音频首帧编码成功。

3: 本地音频启动失败。

0: 本地音频状态正常。

1: 本地音频出错原因不明确。

2: 没有权限启动本地音频采集设备。

3: 本地音频采集设备已经在使用中。

4: 本地音频采集失败，建议你检查采集设备是否正常工作。

5: 本地音频编码失败。

0: 远端音频流默认初始状态。在 REMOTE_AUDIO_REASON_LOCAL_MUTED(3)、 REMOTE_AUDIO_REASON_REMOTE_MUTED(5) 或 REMOTE_AUDIO_REASON_REMOTE_OFFLINE(7) 的情况下，会报告该状态。

1: 本地用户已接收远端音频首包。

2: 远端音频流正在解码，正常播放。在 REMOTE_AUDIO_REASON_NETWORK_RECOVERY(2)、 REMOTE_AUDIO_REASON_LOCAL_UNMUTED(4)或 REMOTE_AUDIO_REASON_REMOTE_UNMUTED(6)` 的情况下，会报告该状态。

3: 远端音频流卡顿。在 REMOTE_AUDIO_REASON_NETWORK_CONGESTION(1) 的情况下，会报告该状态。

4: 远端音频流播放失败。在 REMOTE_AUDIO_REASON_INTERNAL(0) 的情况下，会报告该状态。

0: 音频状态发生改变时，会报告该原因。

1: 网络阻塞。

2: 网络恢复正常。

3: 本地用户停止接收远端音频流或本地用户禁用音频模块。

4: 本地用户恢复接收远端音频流或本地用户启用音频模块。

5: 远端用户停止发送音频流或远端用户禁用音频模块。

6: 远端用户恢复发送音频流或远端用户启用音频模块。

7: 远端用户离开频道。

没有限制，SDK 可以完全控制 Audio Session 操作。

SDK 不能更改 Audio Session 的 category。

SDK 不能更改 Audio Session 的 category，mode，categoryOptions。

离开某个频道时，SDK 会保持 Audio Session 处于活动状态。

限制 SDK 对 Audio Session 进行任何操作，SDK 将不能再对 Audio Session 进行任何配置。

0: 网络中断导致用户与服务器连接断开。

1: 用户与服务器建立连接。

2: 用户已加入源频道。

3: 用户已加入目标频道。

4: SDK 开始向目标频道发送数据包。

5: 服务器收到了频道发送的视频流。

6: 服务器收到了频道发送的音频流。

7: 目标频道已更新。

8: 内部原因导致目标频道更新失败。

9: 目标频道未发生改变，即目标频道更新失败。

10: 目标频道名为 NULL。

11: 视频属性已发送至服务器。

0: 初始状态。在成功调用 StopChannelMediaRelay 停止 跨频道媒体流转发后，OnChannelMediaRelayStateChangedHandler 会回调该状态。

1: SDK 尝试跨频道。

2: 源频道主播成功加入目标频道。

3: 发生异常，详见 code 中提示的错误信息。

0: 160 × 120，帧率 15 fps，码率 65 Kbps。

2: 120 × 120，帧率 15 fps，码率 50 Kbps。

10: 320×180，帧率 15 fps，码率 140 Kbps。

12: 180 × 180，帧率 15 fps，码率 100 Kbps。

13: 240 × 180，帧率 15 fps，码率 120 Kbps。

20: 320 × 240，帧率 15 fps，码率 200 Kbps。

22: 240 × 240，帧率 15 fps，码率 140 Kbps。

23: 424 × 240，帧率 15 fps，码率 220 Kbps。

30: 640 × 360，帧率 15 fps，码率 400 Kbps。

32: 360 × 360，帧率 15 fps，码率 260 Kbps。

33: 640 × 360，帧率 30 fps，码率 600 Kbps。

35: 360 × 360，帧率 30 fps，码率 400 Kbps。

36: 480 × 360，帧率 15 fps，码率 320 Kbps。

37: 480 × 360，帧率 30 fps，码率 490 Kbps。

38: 640 × 360，帧率 15 fps，码率 800 Kbps。

注解

Live broadcast profile only.

39: 640 × 360，帧率 24 fps，码率 800 Kbps。

注解

Live broadcast profile only.

100: 640 × 360，帧率 24 fps，码率 1000 Kbps。

注解

Live broadcast profile only.

40: 640 × 480，帧率 15 fps，码率 500 Kbps。

42: 480 × 480，帧率 15 fps，码率 400 Kbps。

43: 640 × 480，帧率 30 fps，码率 750 Kbps。

45: 480 × 480，帧率 30 fps，码率 600 Kbps。

47: 848 × 480，帧率 15 fps，码率 610 Kbps。

48: 848 × 480，帧率 30 fps，码率 930 Kbps。

49: 640 × 480，帧率 10 fps，码率 400 Kbps。

50: 1280 × 720，帧率 15 fps，码率 1130 Kbps。

52: 1280 × 720，帧率 30 fps，码率 1710 Kbps。

54: 960 × 720，帧率 15 fps，码率 910 Kbps。

55: 960 × 720，帧率 30 fps，码率 1380 Kbps。

60: 1920 × 1080，帧率 15 fps，码率 2080 Kbps。

62: 1920 × 1080，帧率 30 fps，码率 3150 Kbps。

64: 1920 × 1080，帧率 60 fps，码率 4780 Kbps。

66: 2560 × 1440，帧率 30 fps，码率 4850 Kbps。

67: 2560 × 1440，帧率 60 fps，码率 6500 Kbps。

70: 3840 × 2160，帧率 30 fps，码率 6500 Kbps。

72: 3840 × 2160，帧率 60 fps，码率 6500 Kbps。

1000: 120 × 160，帧率 15 fps，码率 65 Kbps。

1002: 120 × 120，帧率 15 fps，码率 50 Kbps。

1010: 180 × 320，帧率 15 fps，码率 140 Kbps。

1012: 180 × 180，帧率 15 fps，码率 100 Kbps。

1013: 180 × 240，帧率 15 fps，码率 120 Kbps。

1020: 240 × 320，帧率 15 fps，码率 200 Kbps。

1022: 240 × 240，帧率 15 fps，码率 140 Kbps。

1023: 240 × 424，帧率 15 fps，码率 220 Kbps。

1030: 360 × 640，帧率 15 fps，码率 400 Kbps。

1032: 360 × 360，帧率 15 fps，码率 260 Kbps。

1033: 360 × 640，帧率 30 fps，码率 600 Kbps。

1035: 360 × 360，帧率 30 fps，码率 400 Kbps。

1036: 360 × 480，帧率 15 fps，码率 320 Kbps。

1037: 360 × 480，帧率 30 fps，码率 490 Kbps。

1038: 360 × 640，帧率 15 fps，码率 800 Kbps。

注解

Live broadcast profile only.

1039: 360 × 640，帧率 24 fps，码率 800 Kbps。

注解

Live broadcast profile only.

1100: 360 × 640，帧率 24 fps，码率 1000 Kbps。

注解

Live broadcast profile only.

1040: 480 × 640，帧率 15 fps，码率 500 Kbps。

1042: 480 × 480，帧率 15 fps，码率 400 Kbps。

1043: 480 × 640，帧率 30 fps，码率 750 Kbps。

1045: 480 × 480，帧率 30 fps，码率 600 Kbps。

1047: 480 × 848，帧率 15 fps，码率 610 Kbps。

1048: 480 × 848，帧率 30 fps，码率 930 Kbps。

1049: 480 × 640，帧率 10 fps，码率 400 Kbps。

1050: 720 × 1280，帧率 15 fps，码率 1130 Kbps。

1052: 720 × 1280，帧率 30 fps，码率 1710 Kbps。

1054: 720 × 960，帧率 15 fps，码率 910 Kbps。

1055: 720 × 960，帧率 30 fps，码率 1380 Kbps。

1060: 1080 × 1920，帧率 15 fps，码率 2080 Kbps。

1062: 1080 × 1920，帧率 30 fps，码率 3150 Kbps。

1064: 1080 × 1920，帧率 60 fps，码率 4780 Kbps。

1066: 1440 × 2560，帧率 30 fps，码率 4850 Kbps。

1067: 1440 × 2560，帧率 60 fps，码率 6500 Kbps。

1070: 2160 × 3840，帧率 30 fps，码率 6500 Kbps。

1072: 2160 × 3840，帧率 60 fps，码率 6500 Kbps。

Default 640 × 360，帧率 15 fps，码率 400 Kbps。

0: 一切正常。

1: 服务器回应出错。

2: 服务器无回应。你可以调用 LeaveChannel 方法离开频道。

3: SDK 无法获取服务，可能是因为服务器资源有限导致。

4: 发起跨频道转发媒体流请求失败。

5: 接受跨频道转发媒体流请求失败。

6: 服务器接收跨频道转发媒体流失败。

7: 服务器发送跨频道转发媒体流失败。

8: SDK 因网络质量不佳与服务器断开。你可以调用 LeaveChannel 方法离开当前频道。

9: 服务器内部出错。

10: 源频道的 Token 已过期。

11: 目标频道的 Token 已过期。

-1: Metadata 类型未知。

0: Metadata 类型为视频。

1: 视频尺寸等比缩放。优先保证视窗被填满。因视频尺寸与显示视窗尺寸不一致而多出的视频将被截掉。

2: 视频尺寸等比缩放。优先保证视频内容全部显示。因视频尺寸与显示视窗尺寸不一致造成的视窗未被填满的区域填充黑色。

弃用:

3: 该模式已废弃。

1:（默认）128 位 AES 加密，XTS 模式。

2: 128 位 AES 加密，ECB 模式。

3: 256 位 AES 加密，XTS 模式。

4: 128 位 SM4 加密，ECB 模式。

枚举值边界。

RTMP/RTMPS 推流时，添加背景图或水印出错。

0: 加入频道后的初始发布状态。

1: 发布失败。可能是因为：

• 本地用户调用 MuteLocalAudioStream(true) 或 MuteLocalVideoStream(true) 停止发送本地媒体流。
• 本地用户调用 DisableAudio 或 DisableVideo 关闭本地音频或视频模块。
• 本地用户调用 EnableLocalAudio(false) 或 EnableLocalVideo(false) 关闭本地音频或视频采集。
• 本地用户角色为观众。

2: 正在发布。

3: 发布成功。

0: 加入频道后的初始订阅状态。

1: 订阅失败。可能是因为：

• 远端用户：
  • 调用 MuteLocalAudioStream(true) 或 MuteLocalVideoStream(true) 停止发送本地媒体流。
  • 调用 DisableAudio 或 DisableVideo 关闭本地音频或视频模块。
  • 调用 EnableLocalAudio(false) 或 EnableLocalVideo(false) 关闭本地音频或视频采集。
  • 用户角色为观众。
• 本地用户调用以下方法停止接收远端媒体流：
  • 调用 MuteRemoteAudioStream(true)、MuteAllRemoteAudioStreams(true) 或 SetDefaultMuteAllRemoteAudioStreams(true) 停止接收远端音频流。
  • 调用 MuteRemoteVideoStream(true)、MuteAllRemoteVideoStreams(true) 或 SetDefaultMuteAllRemoteVideoStreams(true) 停止接收远端音频流。

2: 正在订阅。

3: 收到了远端流，订阅成功。

1: 低延时。

2: （默认）超低延时。

原声，即关闭美声效果。

磁性（男）。

注解

该设置仅对男声有效。**请勿**用于设置女声，否则音频会失真。

清新（女）。

注解

该设置仅对女声有效。**请勿**用于设置男声，否则音频会失真。

活力（女）。

注解

该设置仅对女声有效。**请勿**用于设置男声，否则音频会失真。

浑厚。

低沉。

圆润。

假音。

饱满。

清澈。

高亢。

嘹亮。

原声，即关闭人声音效。

KTV。

注解

为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

演唱会。

注解

为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

录音棚。

注解

为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

留声机。

注解

为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

虚拟立体声，即 SDK 将单声道的音频渲染出双声道的音效。

注解

你需要在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，否则该枚举设置无效。

空旷。

注解

为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

空灵。

注解

为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

3D 人声，即 SDK 将音频渲染出在用户周围环绕的效果，环绕周期为 10 秒。设置该音效后，你还可以 调用 SetAudioEffectParameters 修改环绕周期。

注解

• 你需要在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，否则该枚举设置无效。
• 启用 3D 人声后，用户需要使用支持双声道的音频播放设备才能听到预期效果。

大叔。

注解

• 建议用于处理男声，否则无法达到预期效果。
• 为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

老年男性。

注解

• 建议用于处理男声，否则无法达到预期效果。
• 为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

男孩。

注解

• 建议用于处理男声，否则无法达到预期效果。
• 为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

少女。

注解

• 建议用于处理女声，否则无法达到预期效果。
• 为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

女孩。

注解

• 建议用于处理女声，否则无法达到预期效果。
• 为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

猪八戒。

注解

为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

绿巨人。

注解

为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

R&B。

注解

你需要在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，否则该枚举设置无效。

流行。

注解

你需要在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，否则该枚举设置无效。

电音，即 SDK 以主音音高为 C 的自然大调为基础修正音频的实际音高。设置该音效后，你还可以 调用 SetAudioEffectParameters 调整修音的基础调式和主音音高。

注解

为获取更好的人声效果，Agora 建议你在使用该枚举前将 SetAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

0:（默认）SDK 启用镜像模式。

1: 启用镜像模式。

2: 关闭镜像模式。