# 方法 ## 引擎管理 | 方法 | 描述 | | --- | --- | | [createRTCVideo](70095#creatertcvideo) | 创建 IRTCVideo 实例。

如果当前进程中未创建引擎实例，那么你必须先使用此方法，以使用 RTC 提供的各种音视频能力。
如果当前进程中已创建了引擎实例，再次调用此方法时，会返回已创建的引擎实例。 | | [destroyRTCVideo](70095#destroyrtcvideo) | 销毁由 [createRTCVideo](70095#creatertcvideo) 所创建的引擎实例，并释放所有相关资源。
| | [getSDKVersion](70095#getsdkversion) | 获取当前 SDK 版本信息。 | | [feedback](70095#IRTCVideo-feedback) | 将用户反馈的问题上报到 RTC。 | | [getErrorDescription](70095#geterrordescription) | 获取 SDK 内各种错误码、警告码的描述文字。 | | [setBusinessId](70095#IRTCVideo-setbusinessid) | 设置业务标识参数

可通过 businessId 区分不同的业务场景。businessId 由客户自定义，相当于一个“标签”，可以分担和细化现在 AppId 的逻辑划分的功能，但不需要鉴权。 | | [setRuntimeParameters](70095#IRTCVideo-setruntimeparameters) | 设置运行时的参数 | | [setLogConfig](70095#setlogconfig) | 配置 SDK 本地日志参数，包括日志级别、存储路径、日志文件最大占用的总空间、日志文件名前缀。 | ## 房间管理 | 方法 | 描述 | | --- | --- | | [createRTCRoom](70095#IRTCVideo-creatertcroom) | 创建房间实例。

调用此方法仅返回一个房间实例，你仍需调用 [joinRoom](70095#IRTCRoom-joinroom) 才能真正地创建/加入房间。

多次调用此方法以创建多个 [IRTCRoom](70095#irtcroom) 实例。分别调用各 IRTCRoom 实例中的 [joinRoom](70095#IRTCRoom-joinroom) 方法，同时加入多个房间。

多房间模式下，用户可以同时订阅各房间的音视频流。 | | [destroy](70095#IRTCRoom-destroy) | 退出并销毁调用 [createRTCRoom](70095#IRTCVideo-creatertcroom) 所创建的房间实例。 | | [setRTCRoomEventHandler](70095#IRTCRoom-setrtcroomeventhandler) | 通过设置 [IRTCRoom](70095#irtcroom) 对象的事件句柄，监听此对象对应的回调事件。 | | [joinRoom](70095#IRTCRoom-joinroom) | 加入房间。

调用 [createRTCRoom](70095#IRTCVideo-creatertcroom) 创建房间后，调用此方法加入房间，同房间内其他用户进行音视频通话。
| | [setRoomExtraInfo](70095#IRTCRoom-setroomextrainfo) | 设置/更新房间附加信息，可用于标识房间状态或属性，或灵活实现各种业务逻辑。 | | [leaveRoom](70095#IRTCRoom-leaveroom) | 离开房间。

用户调用此方法离开房间，结束通话过程，释放所有通话相关的资源。

加入房间后，必须调用此方法结束通话，否则无法开始下一次通话。无论当前是否在房间内，都可以调用此方法。重复调用此方法没有负面影响。

此方法是异步操作，调用返回时并没有真正退出房间。真正退出房间后，本地会收到 [onLeaveRoom](70096#IRTCRoomEventHandler-onleaveroom) 回调通知。
| | [setUserVisibility](70095#IRTCRoom-setuservisibility) | 设置用户可见性。未调用该接口前，本地用户默认对他人可见。
默认情况下，一个 RTC 房间最多同时容纳 50 名可见用户，最多 30 人可同时上麦。更多信息参看[用户和媒体流上限](https://www.volcengine.com/docs/6348/257549)。 | | [updateToken](70095#IRTCRoom-updatetoken) | 更新 Token。
收到 [onTokenWillExpire](70096#IRTCRoomEventHandler-ontokenwillexpire)，[onPublishPrivilegeTokenWillExpire](70096#IRTCRoomEventHandler-onpublishprivilegetokenwillexpire)，或 [onSubscribePrivilegeTokenWillExpire](70096#IRTCRoomEventHandler-onsubscribeprivilegetokenwillexpire) 时，你必须重新获取 Token，并调用此方法更新 Token，以保证通话的正常进行。 | ## 音频管理 | 方法 | 描述 | | --- | --- | | [buildAudioFrame](70095#buildaudioframe) | 创建 IAudioFrame | | [enumerateAudioPlaybackDevices](70095#IAudioDeviceManager-enumerateaudioplaybackdevices) | 获取当前系统内音频播放设备列表。如果后续设备有变更，你会收到 `onAudioMediaDeviceStateChanged` 回调通知，然后需要重新调用本接口以获得新的设备列表。 | | [enumerateAudioCaptureDevices](70095#IAudioDeviceManager-enumerateaudiocapturedevices) | 获取当前系统内音频采集设备列表。如果后续设备有变更，你需要重新调用本接口以获得新的设备列表。 | | [setAudioPlaybackDevice](70095#IAudioDeviceManager-setaudioplaybackdevice) | 设置音频播放设备。 | | [setAudioCaptureDevice](70095#IAudioDeviceManager-setaudiocapturedevice) | 设置音频采集设备。 | | [getAudioPlaybackDevice](70095#IAudioDeviceManager-getaudioplaybackdevice) | 获取当前音频播放设备 ID。 | | [getAudioCaptureDevice](70095#IAudioDeviceManager-getaudiocapturedevice) | 获取当前音频采集设备 ID。 | | [followSystemPlaybackDevice](70095#IAudioDeviceManager-followsystemplaybackdevice) | 设置音频播放路由是否跟随系统。 | | [followSystemCaptureDevice](70095#IAudioDeviceManager-followsystemcapturedevice) | 设置音频采集路由是否跟随系统。 | | [setAudioPlaybackDeviceVolume](70095#IAudioDeviceManager-setaudioplaybackdevicevolume) | 设置当前音频播放设备音量 | | [getAudioPlaybackDeviceVolume](70095#IAudioDeviceManager-getaudioplaybackdevicevolume) | 获取当前音频播放设备音量 | | [setAudioCaptureDeviceVolume](70095#IAudioDeviceManager-setaudiocapturedevicevolume) | 设置当前音频采集设备音量 | | [getAudioCaptureDeviceVolume](70095#IAudioDeviceManager-getaudiocapturedevicevolume) | 获取当前音频采集设备音量 | | [setAudioPlaybackDeviceMute](70095#IAudioDeviceManager-setaudioplaybackdevicemute) | 设置当前音频播放设备静音状态，默认为非静音。 | | [getAudioPlaybackDeviceMute](70095#IAudioDeviceManager-getaudioplaybackdevicemute) | 获取当前音频播放设备是否静音的信息。 | | [setAudioCaptureDeviceMute](70095#IAudioDeviceManager-setaudiocapturedevicemute) | 设置当前音频采集设备静音状态，默认为非静音。 | | [getAudioCaptureDeviceMute](70095#IAudioDeviceManager-getaudiocapturedevicemute) | 获取当前音频采集设备是否静音的信息。 | | [startAudioPlaybackDeviceTest](70095#IAudioDeviceManager-startaudioplaybackdevicetest) | 启动音频播放设备检测。测试启动后，循环播放指定的音频文件，同时将通过 `onAudioPlaybackDeviceTestVolume` 回调播放时的音量信息。 | | [stopAudioPlaybackDeviceTest](70095#IAudioDeviceManager-stopaudioplaybackdevicetest) | 停止音频播放测试。
| | [initAudioPlaybackDeviceForTest](70095#IAudioDeviceManager-initaudioplaybackdevicefortest) | 尝试初始化音频播放设备，可检测出设备不存在、权限被拒绝/禁用等异常问题。 | | [initAudioCaptureDeviceForTest](70095#IAudioDeviceManager-initaudiocapturedevicefortest) | 尝试初始化音频采集设备，可检测设备不存在、权限被拒绝/禁用等异常问题。 | | [setCaptureVolume](70095#IRTCVideo-setcapturevolume) | 调节音频采集音量 | | [setPlaybackVolume](70095#IRTCVideo-setplaybackvolume) | 调节本地播放的所有远端用户音频混音后的音量，混音内容包括远端人声、音乐、音效等。

播放音频前或播放音频时，你都可以使用此接口设定播放音量。 | | [setRemoteAudioPlaybackVolume](70095#IRTCVideo-setremoteaudioplaybackvolume) | 调节来自指定远端用户的音频播放音量。 | | [setRemoteRoomAudioPlaybackVolume](70095#IRTCRoom-setremoteroomaudioplaybackvolume) | 调节某个房间内所有远端用户的音频播放音量。 | | [enableAudioPropertiesReport](70095#IRTCVideo-enableaudiopropertiesreport) | 启用音频信息提示。开启提示后，你会收到 [onLocalAudioPropertiesReport](70096#IRTCVideoEventHandler-onlocalaudiopropertiesreport)，[onRemoteAudioPropertiesReport](70096#IRTCVideoEventHandler-onremoteaudiopropertiesreport) 和 [onActiveSpeaker](70096#IRTCVideoEventHandler-onactivespeaker)。 | | [startAudioCapture](70095#IRTCVideo-startaudiocapture) | 开启内部音频采集。默认为关闭状态。

内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。
调用该方法开启后，本地用户会收到 [onAudioDeviceStateChanged](70096#IRTCVideoEventHandler-onaudiodevicestatechanged) 的回调。

可见用户进房后调用该方法，房间中的其他用户会收到 [onUserStartAudioCapture](70096#IRTCVideoEventHandler-onuserstartaudiocapture) 的回调。 | | [stopAudioCapture](70095#IRTCVideo-stopaudiocapture) | 立即关闭内部音频采集。默认为关闭状态。

内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。
调用该方法，本地用户会收到 [onAudioDeviceStateChanged](70096#IRTCVideoEventHandler-onaudiodevicestatechanged) 的回调。

可见用户进房后调用该方法后，房间中的其他用户会收到 [onUserStopAudioCapture](70096#IRTCVideoEventHandler-onuserstopaudiocapture) 的回调。 | | [startScreenAudioCapture](70095#IRTCVideo-startscreenaudiocapture) | 在屏幕共享时，开始使用 RTC SDK 内部采集方式，采集屏幕音频 | | [stopScreenAudioCapture](70095#IRTCVideo-stopscreenaudiocapture) | 在屏幕共享时，停止使用 RTC SDK 内部采集方式，采集屏幕音频。 | | [setAudioProfile](70095#IRTCVideo-setaudioprofile) | 设置音质档位。

当所选的 [RoomProfileType](70098#roomprofiletype) 中的音频参数无法满足你的场景需求时，调用本接口切换的音质档位。 | | [getAudioDeviceManager](70095#IRTCVideo-getaudiodevicemanager) | 设备音频管理接口创建 | | [startAudioDeviceRecordTest](70095#IAudioDeviceManager-startaudiodevicerecordtest) | 开始音频采集设备和音频播放设备测试。
| | [stopAudioDeviceRecordAndPlayTest](70095#IAudioDeviceManager-stopaudiodevicerecordandplaytest) | 停止采集本地音频，并开始播放采集到的声音。录音播放完毕后，设备测试流程结束。

调用 [startAudioDeviceRecordTest](70095#IAudioDeviceManager-startaudiodevicerecordtest) 30 s 内调用本接口来停止采集并开始播放此前采集到的声音。 | | [stopAudioDevicePlayTest](70095#IAudioDeviceManager-stopaudiodeviceplaytest) | 停止由调用 [startAudioDeviceRecordTest](70095#IAudioDeviceManager-startaudiodevicerecordtest) 开始的音频播放设备测试。

在音频播放设备测试自动结束前，可调用本接口停止音频采集与播放测试。 | | [enableExternalSoundCard](70095#IRTCVideo-enableexternalsoundcard) | 启用匹配外置声卡的音频处理模式 | | [enableAGC](70095#IRTCVideo-enableagc) | 打开/关闭 AGC(Automatic Gain Control) 自动增益控制功能。

开启该功能后，SDK 会自动调节麦克风的采集音量，确保音量稳定。 | | [startHardwareEchoDetection](70095#IRTCVideo-starthardwareechodetection) | 开启通话前回声检测 | | [stopHardwareEchoDetection](70095#IRTCVideo-stophardwareechodetection) | 停止通话前回声检测 | ## 视频管理 | 方法 | 描述 | | --- | --- | | [startVideoCapture](70095#IRTCVideo-startvideocapture) | 立即开启内部视频采集。默认为关闭状态。

内部视频采集指：使用 RTC SDK 内置视频采集模块，进行采集。

调用该方法后，本地用户会收到 [onVideoDeviceStateChanged](70096#IRTCVideoEventHandler-onvideodevicestatechanged) 的回调。

本地用户在非隐身状态下调用该方法后，房间中的其他用户会收到 [onUserStartVideoCapture](70096#IRTCVideoEventHandler-onuserstartvideocapture) 的回调。 | | [stopVideoCapture](70095#IRTCVideo-stopvideocapture) | 立即关闭内部视频采集。默认为关闭状态。

内部视频采集指：使用 RTC SDK 内置视频采集模块，进行采集。

调用该方法后，本地用户会收到 [onVideoDeviceStateChanged](70096#IRTCVideoEventHandler-onvideodevicestatechanged) 的回调。

可见用户进房后调用该方法，房间中的其他用户会收到 [onUserStopVideoCapture](70096#IRTCVideoEventHandler-onuserstopvideocapture) 的回调。 | | [setVideoCaptureConfig](70095#IRTCVideo-setvideocaptureconfig) | 设置 RTC SDK 内部采集时的视频采集参数。

如果你的项目使用了 SDK 内部采集模块，可以通过本接口指定视频采集参数，包括模式、分辨率、帧率。 | | [setLocalVideoCanvas](70095#IRTCVideo-setlocalvideocanvas) | 设置本地视频渲染时使用的视图，并设置渲染模式。 | | [updateLocalVideoCanvas](70095#IRTCVideo-updatelocalvideocanvas) | 修改本地视频渲染模式和背景色。 | | [setRemoteVideoCanvas](70095#IRTCVideo-setremotevideocanvas) | 设置渲染指定视频流 `stream_key` 时，使用的视图和渲染模式。

如果需要解除某个用户的绑定视图，你可以把 `canvas` 设置为空。 | | [enumerateVideoCaptureDevices](70095#IVideoDeviceManager-enumeratevideocapturedevices) | 获取当前系统内视频采集设备列表。 | | [setVideoCaptureDevice](70095#IVideoDeviceManager-setvideocapturedevice) | 设置当前视频采集设备 | | [getVideoDeviceManager](70095#IRTCVideo-getvideodevicemanager) | 创建视频设备管理实例 | | [getVideoCaptureDevice](70095#IVideoDeviceManager-getvideocapturedevice) | 获取当前 SDK 正在使用的视频采集设备信息 | | [buildVideoFrame](70095#buildvideoframe) | 创建 IVideoFrame | | [setVideoEncoderConfig](70095#IRTCVideo-setvideoencoderconfig) | 视频发布端设置期望发布的最大分辨率视频流参数，包括分辨率、帧率、码率、网络不佳时的回退策略等。

该接口支持设置一路视频流参数，设置多路参数请使用重载 API：[setVideoEncoderConfig](#IRTCVideo-setvideoencoderconfig-2)。 | | [setVideoEncoderConfig](70095#IRTCVideo-setvideoencoderconfig) | 视频发布端设置推送多路流时各路流的参数，包括分辨率、帧率、码率、网络不佳时的回退策略等。 | | [buildEncodedVideoFrame](70095#buildencodedvideoframe) | 创建 IEncodedVideoFrame | ## 音视频传输 | 方法 | 描述 | | --- | --- | | [publishStream](70095#IRTCRoom-publishstream) | 在当前所在房间内发布本地通过摄像头/麦克风采集的媒体流 | | [unpublishStream](70095#IRTCRoom-unpublishstream) | 停止将本地摄像头/麦克风采集的媒体流发布到当前所在房间中 | | [setDummyCaptureImagePath](70095#IRTCVideo-setdummycaptureimagepath) | 摄像头处于关闭状态时，使用静态图片填充本地推送的视频流。
调用 `stopVideoCapture` 接口时，会开始推静态图片。若要停止发送图片，可传入空字符串或启用内部摄像头采集。
可重复调用该接口来更新图片。 | | [subscribeStream](70095#IRTCRoom-subscribestream) | 订阅房间内指定的通过摄像头/麦克风采集的媒体流，或更新对指定远端用户的订阅选项 | | [unsubscribeStream](70095#IRTCRoom-unsubscribestream) | 取消订阅房间内指定的通过摄像头/麦克风采集的媒体流。

该方法对自动订阅和手动订阅模式均适用。 | | [subscribeAllStreams](70095#IRTCRoom-subscribeallstreams) | 订阅房间内所有通过摄像头/麦克风采集的媒体流，或更新订阅选项。 | | [unsubscribeAllStreams](70095#IRTCRoom-unsubscribeallstreams) | 取消订阅房间内所有的通过摄像头/麦克风采集的媒体流。

自动订阅和手动订阅的流都可以通过本方法取消订阅。 | | [requestRemoteVideoKeyFrame](70095#IRTCVideo-requestremotevideokeyframe) | 在订阅远端视频流之后，向远端请求关键帧 | | [startForwardStreamToRooms](70095#IRTCRoom-startforwardstreamtorooms) | 开始跨房间转发媒体流。
在调用 [joinRoom](70095#IRTCRoom-joinroom) 后调用本接口，实现向多个房间转发媒体流，适用于跨房间连麦等场景。
| | [stopForwardStreamToRooms](70095#IRTCRoom-stopforwardstreamtorooms) | 停止跨房间媒体流转发。
通过 [startForwardStreamToRooms](70095#IRTCRoom-startforwardstreamtorooms) 发起媒体流转发后，可调用本方法停止向所有目标房间转发媒体流。 | | [updateForwardStreamToRooms](70095#IRTCRoom-updateforwardstreamtorooms) | 更新跨房间媒体流转发信息。

通过 [startForwardStreamToRooms](70095#IRTCRoom-startforwardstreamtorooms) 发起媒体流转发后，可调用本方法增加或者减少目标房间，或更新房间密钥。
调用本方法增加或删减房间后，将在本端触发 [onForwardStreamStateChanged](70096#IRTCRoomEventHandler-onforwardstreamstatechanged) 回调，包含发生了变动的目标房间中媒体流转发状态。 | | [pauseForwardStreamToAllRooms](70095#IRTCRoom-pauseforwardstreamtoallrooms) | 暂停跨房间媒体流转发。
通过 [startForwardStreamToRooms](70095#IRTCRoom-startforwardstreamtorooms) 发起媒体流转发后，可调用本方法暂停向所有目标房间转发媒体流。
调用本方法暂停向所有目标房间转发后，你可以随时调用 [resumeForwardStreamToAllRooms](70095#IRTCRoom-resumeforwardstreamtoallrooms) 快速恢复转发。 | | [resumeForwardStreamToAllRooms](70095#IRTCRoom-resumeforwardstreamtoallrooms) | 恢复跨房间媒体流转发。
调用 [pauseForwardStreamToAllRooms](70095#IRTCRoom-pauseforwardstreamtoallrooms) 暂停转发之后，调用本方法恢复向所有目标房间转发媒体流。 | | [pauseAllSubscribedStream](70095#IRTCRoom-pauseallsubscribedstream) | 暂停接收来自远端的媒体流。 | | [resumeAllSubscribedStream](70095#IRTCRoom-resumeallsubscribedstream) | 恢复接收来自远端的媒体流 | | [setMultiDeviceAVSync](70095#IRTCRoom-setmultideviceavsync) | 设置发流端音画同步。

当同一用户同时使用两个通话设备分别采集发送音频和视频时，有可能会因两个设备所处的网络环境不一致而导致发布的流不同步，此时你可以在视频发送端调用该接口，SDK 会根据音频流的时间戳自动校准视频流，以保证接收端听到音频和看到视频在时间上的同步性。 | | [startPushPublicStream](70095#IRTCVideo-startpushpublicstream) | 发布一路公共流

用户可以指定房间内多个用户发布的媒体流合成一路公共流。使用同一 `appID` 的用户，可以调用 [startPlayPublicStream](70095#IRTCVideo-startplaypublicstream) 获取和播放指定的公共流。 | | [stopPushPublicStream](70095#IRTCVideo-stoppushpublicstream) | 停止发布当前用户发布的公共流

关于发布公共流，查看 [startPushPublicStream](70095#IRTCVideo-startpushpublicstream)。 | | [updatePublicStreamParam](70095#IRTCVideo-updatepublicstreamparam) | 更新公共流参数

关于发布公共流，查看 [startPushPublicStream](70095#IRTCVideo-startpushpublicstream)。 | | [startPlayPublicStream](70095#IRTCVideo-startplaypublicstream) | 订阅指定公共流

无论用户是否在房间内，都可以调用本接口获取和播放指定的公共流。 | | [stopPlayPublicStream](70095#IRTCVideo-stopplaypublicstream) | 取消订阅指定公共流

关于订阅公共流，查看 [startPlayPublicStream](70095#IRTCVideo-startplaypublicstream)。 | | [setPublicStreamVideoCanvas](70095#IRTCVideo-setpublicstreamvideocanvas) | 为指定公共流绑定内部渲染视图。 | | [setPublicStreamVideoSink](70095#IRTCVideo-setpublicstreamvideosink) | 为指定公共流绑定自定义渲染器。详见[自定义视频渲染](https://www.volcengine.com/docs/6348/81201)。 | | [setPublicStreamAudioPlaybackVolume](70095#IRTCVideo-setpublicstreamaudioplaybackvolume) | 调节公共流的音频播放音量。 | ## 视频处理 | 方法 | 描述 | | --- | --- | | [setLowLightAdjusted](70095#IRTCVideo-setlowlightadjusted) | 设置视频暗光增强模式。
对于光线不足、照明不均匀或背光等场景下推荐开启，可有效改善画面质量。 | | [setLocalVideoMirrorType](70095#IRTCVideo-setlocalvideomirrortype) | 为采集到的视频流开启镜像 | | [setRemoteVideoMirrorType](70095#IRTCVideo-setremotevideomirrortype) | 使用内部渲染时，为远端流开启镜像。 | | [setVideoCaptureRotation](70095#IRTCVideo-setvideocapturerotation) | 设置本端采集的视频帧的旋转角度。
当摄像头倒置或者倾斜安装时，可调用本接口进行调整。 | | [setVideoWatermark](70095#IRTCVideo-setvideowatermark) | 在指定视频流上添加水印。 | | [clearVideoWatermark](70095#IRTCVideo-clearvideowatermark) | 移除指定视频流的水印。 | | [enableEffectBeauty](70095#IRTCVideo-enableeffectbeauty) | 开启/关闭基础美颜。 | | [setBeautyIntensity](70095#IRTCVideo-setbeautyintensity) | 调整基础美颜强度。 | | [getVideoEffectInterface](70095#IRTCVideo-getvideoeffectinterface) | 获取视频特效接口。 | | [getAuthMessage](70095#IVideoEffect-getauthmessage) | 从特效 SDK 获取授权消息，用于获取在线许可证。 | | [freeAuthMessage](70095#IVideoEffect-freeauthmessage) | 使用完授权消息字符串后，释放内存。 | | [initCVResource](70095#IVideoEffect-initcvresource) | 检查视频特效证书，设置算法模型路径，并初始化特效模块。 | | [enableVideoEffect](70095#IVideoEffect-enablevideoeffect) | 开启高级美颜、滤镜等视频特效。 | | [disableVideoEffect](70095#IVideoEffect-disablevideoeffect) | 关闭视频特效。 | | [setEffectNodes](70095#IVideoEffect-seteffectnodes) | 设置视频特效素材包。 | | [updateEffectNode](70095#IVideoEffect-updateeffectnode) | 设置特效强度。 | | [setColorFilter](70095#IVideoEffect-setcolorfilter) | 设置颜色滤镜。 | | [setColorFilterIntensity](70095#IVideoEffect-setcolorfilterintensity) | 设置已启用颜色滤镜的强度。 | | [enableVirtualBackground](70095#IVideoEffect-enablevirtualbackground) | 将摄像头采集画面中的人像背景替换为指定图片或纯色背景。 | | [disableVirtualBackground](70095#IVideoEffect-disablevirtualbackground) | 关闭虚拟背景。 | | [enableFaceDetection](70095#IVideoEffect-enablefacedetection) | 开启人脸识别功能，并设置人脸检测结果回调观察者。
此观察者后，你会周期性收到 [onFaceDetectResult](70096#IFaceDetectionObserver-onfacedetectresult) 回调。 | | [disableFaceDetection](70095#IVideoEffect-disablefacedetection) | 关闭人脸识别功能。 | | [setVideoCaptureRotation](70095#IRTCVideo-setvideocapturerotation) | 设置本端采集的视频帧的旋转角度。
当摄像头倒置或者倾斜安装时，可调用本接口进行调整。 | | [setVideoDigitalZoomConfig](70095#IRTCVideo-setvideodigitalzoomconfig) | 设置本地摄像头数码变焦参数，包括缩放倍数，移动步长。 | | [setVideoDigitalZoomControl](70095#IRTCVideo-setvideodigitalzoomcontrol) | 控制本地摄像头数码变焦，缩放或移动一次。设置对本地预览画面和发布到远端的视频都生效。 | | [startVideoDigitalZoomControl](70095#IRTCVideo-startvideodigitalzoomcontrol) | 开启本地摄像头持续数码变焦，缩放或移动。设置对本地预览画面和发布到远端的视频都生效。 | | [stopVideoDigitalZoomControl](70095#IRTCVideo-stopvideodigitalzoomcontrol) | 停止本地摄像头持续数码变焦。 | ## 音频处理 | 方法 | 描述 | | --- | --- | | [setVoiceChangerType](70095#IRTCVideo-setvoicechangertype) | 设置变声特效类型 | | [setVoiceReverbType](70095#IRTCVideo-setvoicereverbtype) | 设置混响特效类型 | | [setLocalVoicePitch](70095#IRTCVideo-setlocalvoicepitch) | 开启本地语音变调功能，多用于 K 歌场景。

使用该方法，你可以对本地语音的音调进行升调或降调等调整。 | | [setLocalVoiceEqualization](70095#IRTCVideo-setlocalvoiceequalization) | 设置本地采集语音的均衡效果。包含内部采集和外部采集，但不包含混音音频文件。 | | [setLocalVoiceReverbParam](70095#IRTCVideo-setlocalvoicereverbparam) | 设置本地采集音频的混响效果。包含内部采集和外部采集，但不包含混音音频文件。 | | [enableLocalVoiceReverb](70095#IRTCVideo-enablelocalvoicereverb) | 开启本地音效混响效果 | ## 自定义流处理 | 方法 | 描述 | | --- | --- | | [setVideoSourceType](70095#IRTCVideo-setvideosourcetype) | 设置向 SDK 输入的视频源，包括屏幕流
默认使用内部采集。内部采集指：使用 RTC SDK 内置的视频采集机制进行视频采集。
| | [pushExternalVideoFrame](70095#IRTCVideo-pushexternalvideoframe) | 推送外部视频帧。 | | [setLocalVideoRender](70095#IRTCVideo-setlocalvideorender) | 将本地视频流与自定义渲染器绑定。你可以通过参数设置返回指定位置和格式的视频帧数据。 | | [setRemoteVideoRender](70095#IRTCVideo-setremotevideorender) | 将远端视频流与自定义渲染器绑定。你可以通过参数设置返回指定位置和格式的视频帧数据。 | | [registerRemoteEncodedVideoFrameObserver](70095#IRTCVideo-registerremoteencodedvideoframeobserver) | 注册远端待解码视频帧回调。

完成注册后，当 SDK 监测到远端编码后视频帧时，会触发 [onRemoteEncodedVideoFrame](70096#IRemoteEncodedVideoFrameObserver-onremoteencodedvideoframe) 回调 | | [setVideoDecoderConfig](70095#IRTCVideo-setvideodecoderconfig) | 在订阅远端视频流之前，设置远端视频数据解码方式 | | [setAudioSourceType](70095#IRTCVideo-setaudiosourcetype) | 切换音频采集方式 | | [setAudioRenderType](70095#IRTCVideo-setaudiorendertype) | 切换音频渲染方式 | | [pushExternalAudioFrame](70095#IRTCVideo-pushexternalaudioframe) | 推送自定义采集的音频数据到 RTC SDK。 | | [pullExternalAudioFrame](70095#IRTCVideo-pullexternalaudioframe) | 拉取下行音频数据用于自定义音频渲染。
调用该方法后，SDK 会主动拉取待播放的音频数据，包括远端已解码和混音后的音频数据，用于外部播放。 | | [registerLocalVideoProcessor](70095#IRTCVideo-registerlocalvideoprocessor) | 设置自定义视频前处理器。

使用这个视频前处理器，你可以调用 [processVideoFrame](70095#IVideoProcessor-processvideoframe) 对 RTC SDK 采集得到的视频帧进行前处理，并将处理后的视频帧用于 RTC 音视频通信。 | | [processVideoFrame](70095#IVideoProcessor-processvideoframe) | 获取 RTC SDK 采集得到的视频帧，根据 [registerLocalVideoProcessor](70095#IRTCVideo-registerlocalvideoprocessor) 设置的视频前处理器，进行视频前处理，最终将处理后的视频帧给到 RTC SDK 用于编码传输。 | | [registerAudioProcessor](70095#IRTCVideo-registeraudioprocessor) | 注册自定义音频处理器。

注册完成后，你可以调用 [enableAudioProcessor](70095#IRTCVideo-enableaudioprocessor)，对本地采集到的音频进行处理，RTC SDK 将对处理后的音频进行编码和发送。也可以对接收到的远端音频进行自定义处理，RTC SDK 将对处理后的音频进行渲染。 | | [enableAudioProcessor](70095#IRTCVideo-enableaudioprocessor) | 设置并开启指定的音频帧回调，进行自定义处理。 | | [disableAudioProcessor](70095#IRTCVideo-disableaudioprocessor) | 关闭自定义音频处理。 | | [registerAudioFrameObserver](70095#IRTCVideo-registeraudioframeobserver) | 注册音频数据回调观察者。
| | [enableAudioFrameCallback](70095#IRTCVideo-enableaudioframecallback) | 设置并开启指定的音频数据帧回调 | | [disableAudioFrameCallback](70095#IRTCVideo-disableaudioframecallback) | 关闭音频回调 | | [registerLocalEncodedVideoFrameObserver](70095#IRTCVideo-registerlocalencodedvideoframeobserver) | 注册本地视频帧监测器。

无论使用内部采集还是自定义采集，调用该方法后，SDK 每监测到一帧本地视频帧时，都会将视频帧信息通过 [onLocalEncodedVideoFrame](70096#ILocalEncodedVideoFrameObserver-onlocalencodedvideoframe) 回调给用户 | | [setExternalVideoEncoderEventHandler](70095#IRTCVideo-setexternalvideoencodereventhandler) | 注册自定义编码帧推送事件回调 | | [pushExternalEncodedVideoFrame](70095#IRTCVideo-pushexternalencodedvideoframe) | 推送自定义编码后的视频流 | ## 网络管理 | 方法 | 描述 | | --- | --- | | [enableSimulcastMode](70095#IRTCVideo-enablesimulcastmode) | 该方法设置视频流发布端是否开启发布多路编码参数不同的视频流的模式。 | | [setRemoteVideoConfig](70095#IRTCRoom-setremotevideoconfig) | 设置期望订阅的远端视频流的参数。 | | [setPublishFallbackOption](70095#IRTCVideo-setpublishfallbackoption) | 设置发布的音视频流的回退选项。

你可以调用该接口设置网络不佳或设备性能不足时从大流起进行降级处理，以保证通话质量。 | | [setSubscribeFallbackOption](70095#IRTCVideo-setsubscribefallbackoption) | 设置订阅的音视频流的回退选项。

你可调用该接口设置网络不佳或设备性能不足时允许订阅流进行降级或只订阅音频流，以保证通话流畅。 | | [setRemoteUserPriority](70095#IRTCVideo-setremoteuserpriority) | 设置用户优先级。 | | [startNetworkDetection](70095#IRTCVideo-startnetworkdetection) | 开启通话前网络探测 | | [stopNetworkDetection](70095#IRTCVideo-stopnetworkdetection) | 停止通话前网络探测 | | [startEchoTest](70095#IRTCVideo-startechotest) | 开启音视频回路测试。

在进房前，用户可调用该接口对音视频通话全链路进行检测，包括对音视频设备以及用户上下行网络的检测，从而帮助用户判断是否可以正常发布和接收音视频流。

开始检测后，SDK 会录制你声音或视频。如果你在设置的延时范围内收到了回放，则视为音视频回路测试正常。 | | [stopEchoTest](70095#IRTCVideo-stopechotest) | 停止音视频回路测试。

调用 [startEchoTest](70095#IRTCVideo-startechotest) 开启音视频回路检测后，你必须调用该方法停止检测。 | | [getNetworkTimeInfo](70095#IRTCVideo-getnetworktimeinfo) | 通过 NTP 协议，获取网络时间。 | ## 消息 | 方法 | 描述 | | --- | --- | | [sendRoomMessage](70095#IRTCRoom-sendroommessage) | 给房间内的所有其他用户群发文本消息。 | | [sendRoomBinaryMessage](70095#IRTCRoom-sendroombinarymessage) | 给房间内的所有其他用户群发二进制消息。 | | [login](70095#IRTCVideo-login) | 登录 RTS 服务器。
必须先登录，才能调用 [sendUserMessageOutsideRoom](70095#IRTCVideo-sendusermessageoutsideroom) 和 [sendServerMessage](70095#IRTCVideo-sendservermessage) 发送房间外点对点消息和向应用服务器发送消息

在调用本接口登录后，如果想要登出，需要调用 [logout](70095#IRTCVideo-logout)。 | | [logout](70095#IRTCVideo-logout) | 登出 RTS 服务器。
调用本接口登出后，无法调用房间外消息以及端到服务器消息相关的方法或收到相关回调。 | | [updateLoginToken](70095#IRTCVideo-updatelogintoken) | 更新用户用于登录的 Token

Token 有一定的有效期，当 Token 过期时，需调用此方法更新登录的 Token 信息。

调用 [login](70095#IRTCVideo-login) 方法登录时，如果使用了过期的 Token 将导致登录失败，并会收到 [onLoginResult](70096#IRTCVideoEventHandler-onloginresult) 回调通知，错误码为 kLoginErrorCodeInvalidToken。此时需要重新获取 Token，并调用此方法更新 Token。 | | [setServerParams](70095#IRTCVideo-setserverparams) | 设置应用服务器参数

客户端调用 [sendServerMessage](70095#IRTCVideo-sendservermessage) 或 [sendServerBinaryMessage](70095#IRTCVideo-sendserverbinarymessage) 发送消息给应用服务器之前，必须设置有效签名和应用服务器地址。 | | [getPeerOnlineStatus](70095#IRTCVideo-getpeeronlinestatus) | 查询对端用户或本端用户的登录状态 | | [sendUserMessage](70095#IRTCRoom-sendusermessage) | 给房间内指定的用户发送点对点文本消息（P2P）。 | | [sendUserBinaryMessage](70095#IRTCRoom-senduserbinarymessage) | 给房间内指定的用户发送点对点二进制消息（P2P）。 | | [sendUserMessageOutsideRoom](70095#IRTCVideo-sendusermessageoutsideroom) | 给房间外指定的用户发送文本消息（P2P） | | [sendUserBinaryMessageOutsideRoom](70095#IRTCVideo-senduserbinarymessageoutsideroom) | 给房间外指定的用户发送二进制消息（P2P） | | [sendServerMessage](70095#IRTCVideo-sendservermessage) | 客户端给应用服务器发送文本消息（P2Server） | | [sendServerBinaryMessage](70095#IRTCVideo-sendserverbinarymessage) | 客户端给应用服务器发送二进制消息（P2Server） | | [sendStreamSyncInfo](70095#IRTCVideo-sendstreamsyncinfo) | 发送音频流同步信息。将消息通过音频流发送到远端，并实现与音频流同步，该接口调用成功后，远端用户会收到 [onStreamSyncInfoReceived](70096#IRTCVideoEventHandler-onstreamsyncinforeceived) 回调。 | | [sendSEIMessage](70095#IRTCVideo-sendseimessage) | 通过视频帧发送 SEI 数据。
在视频通话场景下，SEI 数据会随视频帧发送；在语音通话场景下，SDK 会自动生成一路 16px × 16px 的黑帧视频流用来发送 SEI 数据。 | ## CDN 推流 | 方法 | 描述 | | --- | --- | | [startPushMixedStreamToCDN](70095#IRTCVideo-startpushmixedstreamtocdn) | 新增合流转推直播任务，并设置合流的图片、视频视图布局和音频属性。

同一个任务中转推多路直播流时，SDK 会先将多路流合成一路流，然后再进行转推。 | | [updatePushMixedStreamToCDN](70095#IRTCVideo-updatepushmixedstreamtocdn) | 更新合流转推直播参数，会收到 [onMixingEvent](70096#IMixedStreamObserver-onmixingevent) 回调。

使用 [startPushMixedStreamToCDN](70095#IRTCVideo-startpushmixedstreamtocdn) 启用转推直播功能后，使用此方法更新功能配置参数。 | | [startPushSingleStreamToCDN](70095#IRTCVideo-startpushsinglestreamtocdn) | 新增单流转推直播任务。 | | [stopPushStreamToCDN](70095#IRTCVideo-stoppushstreamtocdn) | 停止转推直播。

该方法可用于停止单流转推直播或停止合流转推直播，通过 taskId 区分需要停止的任务。 | ## 混音 | 方法 | 描述 | | --- | --- | | [getAudioEffectPlayer](70095#IRTCVideo-getaudioeffectplayer) | 创建音效播放器实例。 | | [start](70095#IAudioEffectPlayer-start) | 开始播放音效文件。

可以通过传入不同的 ID 和 filepath 多次调用本方法，以实现同时播放多个音效文件，实现音效叠加。 | | [stop](70095#IAudioEffectPlayer-stop) | 停止播放音效文件。 | | [stopAll](70095#IAudioEffectPlayer-stopall) | 停止播放所有音效文件。 | | [preload](70095#IAudioEffectPlayer-preload) | 预加载指定音乐文件到内存中，以避免频繁播放同一文件时的重复加载，减少 CPU 占用。 | | [unload](70095#IAudioEffectPlayer-unload) | 卸载指定音效文件。 | | [unloadAll](70095#IAudioEffectPlayer-unloadall) | 卸载所有音效文件。 | | [pause](70095#IAudioEffectPlayer-pause) | 暂停播放音效文件。 | | [pauseAll](70095#IAudioEffectPlayer-pauseall) | 暂停播放所有音效文件。 | | [resume](70095#IAudioEffectPlayer-resume) | 恢复播放音效文件。 | | [resumeAll](70095#IAudioEffectPlayer-resumeall) | 恢复播放所有音效文件。 | | [setPosition](70095#IAudioEffectPlayer-setposition) | 设置音效文件的起始播放位置。 | | [getPosition](70095#IAudioEffectPlayer-getposition) | 获取音效文件播放进度。 | | [setVolume](70095#IAudioEffectPlayer-setvolume) | 调节指定音效的音量大小，包括音效文件和 PCM 音频。 | | [getVolume](70095#IAudioEffectPlayer-getvolume) | 获取当前音量。 | | [getDuration](70095#IAudioEffectPlayer-getduration) | 获取音效文件时长。 | | [setEventHandler](70095#IAudioEffectPlayer-seteventhandler) | 设置回调句柄。 | | [getMediaPlayer](70095#IRTCVideo-getmediaplayer) | 创建音乐播放器实例。 | | [open](70095#IMediaPlayer-open) | 打开音乐文件。
一个播放器实例仅能够同时打开一个音乐文件。如果需要同时打开多个音乐文件，请创建多个音乐播放器实例。
要播放 PCM 格式的音频数据，参看 [openWithCustomSource](70095#IMediaPlayer-openwithcustomsource)。`openWithCustomSource` 和此 API 互斥。 | | [start](70095#IMediaPlayer-start) | 播放音乐。你仅需要在调用 [open](70095#IMediaPlayer-open)，且未开启自动播放时，调用此方法。 | | [openWithCustomSource](70095#IMediaPlayer-openwithcustomsource) | 启动音频裸数据混音。
要播放音乐文件，参看 [open](70095#IMediaPlayer-open)。`open` 与此 API 互斥。 | | [stop](70095#IMediaPlayer-stop) | 调用 [open](70095#IMediaPlayer-open), [start](70095#IMediaPlayer-start), 或 [openWithCustomSource](70095#IMediaPlayer-openwithcustomsource) 开始播放后，可以调用本方法停止。 | | [pause](70095#IMediaPlayer-pause) | 调用 [open](70095#IMediaPlayer-open)，或 [start](70095#IMediaPlayer-start) 开始播放音频文件后，调用本方法暂停播放。 | | [resume](70095#IMediaPlayer-resume) | 调用 [pause](70095#IMediaPlayer-pause) 暂停音频播放后，调用本方法恢复播放。 | | [setVolume](70095#IMediaPlayer-setvolume) | 调节指定混音的音量大小，包括音乐文件混音和 PCM 混音。 | | [getVolume](70095#IMediaPlayer-getvolume) | 获取当前音量 | | [getTotalDuration](70095#IMediaPlayer-gettotalduration) | 获取音乐文件时长。 | | [getPlaybackDuration](70095#IMediaPlayer-getplaybackduration) | 获取混音音乐文件的实际播放时长，单位为毫秒。 | | [getPosition](70095#IMediaPlayer-getposition) | 获取音乐文件播放进度。 | | [setAudioPitch](70095#IMediaPlayer-setaudiopitch) | 开启变调功能，多用于 K 歌场景。 | | [setPosition](70095#IMediaPlayer-setposition) | 设置音乐文件的起始播放位置。 | | [setAudioDualMonoMode](70095#IMediaPlayer-setaudiodualmonomode) | 设置当前音乐文件的声道模式 | | [getAudioTrackCount](70095#IMediaPlayer-getaudiotrackcount) | 获取当前音乐文件的音轨数 | | [selectAudioTrack](70095#IMediaPlayer-selectaudiotrack) | 指定当前音乐文件的播放音轨 | | [setPlaybackSpeed](70095#IMediaPlayer-setplaybackspeed) | 设置播放速度 | | [setProgressInterval](70095#IMediaPlayer-setprogressinterval) | 设置音频文件混音时，收到 [onMediaPlayerPlayingProgress](70096#IMediaPlayerEventHandler-onmediaplayerplayingprogress) 的间隔。 | | [setLoudness](70095#IMediaPlayer-setloudness) | 如果你需要使用 [enableVocalInstrumentBalance](70095#IRTCVideo-enablevocalinstrumentbalance) 对音频文件/PCM 音频数据设置音量均衡，你必须通过此接口传入其原始响度。 | | [registerAudioFrameObserver](70095#IMediaPlayer-registeraudioframeobserver) | 注册回调句柄以在本地音乐文件混音时，收到相关回调。 | | [pushExternalAudioFrame](70095#IMediaPlayer-pushexternalaudioframe) | 推送用于混音的 PCM 音频帧数据 | | [setEventHandler](70095#IMediaPlayer-seteventhandler) | 设置回调句柄。 | ## 屏幕分享 | 方法 | 描述 | | --- | --- | | [getScreenCaptureSourceList](70095#IRTCVideo-getscreencapturesourcelist) | 获取共享对象列表。 | | [startScreenVideoCapture](70095#IRTCVideo-startscreenvideocapture) | 采集屏幕视频流，用于共享。屏幕视频流包括：屏幕上显示的内容，应用窗口中显示的内容，或虚拟屏幕中显示的内容。

其中，虚拟屏幕中显示的内容仅在 Windows 平台上支持。 | | [updateScreenCaptureHighlightConfig](70095#IRTCVideo-updatescreencapturehighlightconfig) | 通过 RTC SDK 提供的采集模块采集屏幕视频流时，更新边框高亮设置。默认展示表框。 | | [updateScreenCaptureMouseCursor](70095#IRTCVideo-updatescreencapturemousecursor) | 通过 RTC SDK 提供的采集模块采集屏幕视频流时，更新对鼠标的处理设置。默认采集鼠标。 | | [updateScreenCaptureFilterConfig](70095#IRTCVideo-updatescreencapturefilterconfig) | 通过 RTC SDK 提供的采集模块采集屏幕视频流时，设置需要过滤的窗口。 | | [updateScreenCaptureRegion](70095#IRTCVideo-updatescreencaptureregion) | 通过 RTC SDK 提供的采集模块采集屏幕视频流时，更新采集区域。仅用于采集源为显示器屏幕时。 | | [stopScreenVideoCapture](70095#IRTCVideo-stopscreenvideocapture) | 停止屏幕视频流采集。 | | [publishScreen](70095#IRTCRoom-publishscreen) | 在当前所在房间内手动发布本地屏幕共享音视频流。

如果你需要手动向多个房间发布屏幕共享流，可以使用同样的 uid 加入多个房间，并在每个房间调用该方法。同时，你可以在不同的房间发布不同的屏幕共享流类型。 | | [unpublishScreen](70095#IRTCRoom-unpublishscreen) | 停止将本地屏幕共享音视频流发布到当前所在房间中 | | [getThumbnail](70095#IRTCVideo-getthumbnail) | 获取共享对象缩略图 | | [getWindowAppIcon](70095#IRTCVideo-getwindowappicon) | 获取应用窗体所属应用的图标。 | | [setScreenAudioSourceType](70095#IRTCVideo-setscreenaudiosourcetype) | 在屏幕共享时，设置屏幕音频的采集方式（内部采集/自定义采集） | | [setScreenAudioStreamIndex](70095#IRTCVideo-setscreenaudiostreamindex) | 在屏幕共享时，设置屏幕音频流和麦克风采集到的音频流的混流方式 | | [setScreenAudioChannel](70095#IRTCVideo-setscreenaudiochannel) | 在屏幕共享时，设置屏幕音频流的声道数 | | [pushScreenAudioFrame](70095#IRTCVideo-pushscreenaudioframe) | 使用自定义采集方式，采集屏幕共享时的屏幕音频时，将音频帧推送至 RTC SDK 处进行编码等处理。 | | [pushScreenVideoFrame](70095#IRTCVideo-pushscreenvideoframe) | 推送屏幕视频帧 | | [setOriginalScreenVideoInfo](70095#IRTCVideo-setoriginalscreenvideoinfo) | 外部采集时，当屏幕或待采集窗口大小发生改变，为了使 RTC 更好地决策合适的帧率和分辨率积，调用此接口设置改变前的分辨率。 | | [setScreenVideoEncoderConfig](70095#IRTCVideo-setscreenvideoencoderconfig) | 为发布的屏幕共享视频流设置期望的编码参数，包括分辨率、帧率、码率、网络不佳时的回退策略等。 | | [subscribeScreen](70095#IRTCRoom-subscribescreen) | 订阅房间内指定的远端屏幕共享音视频流，或更新对指定远端用户的订阅选项 | | [unsubscribeScreen](70095#IRTCRoom-unsubscribescreen) | 取消订阅房间内指定的远端屏幕共享音视频流。

该方法对自动订阅和手动订阅模式均适用。 | ## 安全与加密 | 方法 | 描述 | | --- | --- | | [startCloudProxy](70095#IRTCVideo-startcloudproxy) | 开启云代理 | | [stopCloudProxy](70095#IRTCVideo-stopcloudproxy) | 关闭云代理 | | [setCustomizeEncryptHandler](70095#IRTCVideo-setcustomizeencrypthandler) | 设置自定义加密和解密方式。 | | [setEncryptInfo](70095#IRTCVideo-setencryptinfo) | 设置传输时使用内置加密的方式。 | | [setLocalProxy](70095#IRTCVideo-setlocalproxy) | 设置本地代理。 | ## 高级功能 | 方法 | 描述 | | --- | --- | | [startFileRecording](70095#IRTCVideo-startfilerecording) | 录制通话过程中的音视频数据到本地的文件中。 | | [stopFileRecording](70095#IRTCVideo-stopfilerecording) | 停止本地录制 | | [startAudioRecording](70095#IRTCVideo-startaudiorecording) | 开启录制语音通话，生成本地文件。

在进房前后开启录制，如果未打开麦克风采集，录制任务正常进行，只是不会将数据写入生成的本地文件；只有调用 [startAudioCapture](70095#IRTCVideo-startaudiocapture) 接口打开麦克风采集后，才会将录制数据写入本地文件。 | | [stopAudioRecording](70095#IRTCVideo-stopaudiorecording) | 停止音频文件录制 | | [setEarMonitorMode](70095#IRTCVideo-setearmonitormode) | 开启/关闭耳返功能 | | [setEarMonitorVolume](70095#IRTCVideo-setearmonitorvolume) | 设置耳返的音量 | | [getSpatialAudio](70095#IRTCRoom-getspatialaudio) | 获取空间音频接口实例。 | | [disableRemoteOrientation](70095#ISpatialAudio-disableremoteorientation) | 关闭本地用户朝向对本地用户发声效果的影响。

调用此接口后，房间内的其他用户收听本地发声时，声源都在收听者正面。 | | [enableSpatialAudio](70095#ISpatialAudio-enablespatialaudio) | 开启/关闭空间音频功能。
| | [getRangeAudio](70095#IRTCRoom-getrangeaudio) | 获取范围语音接口实例。 | | [enableRangeAudio](70095#IRangeAudio-enablerangeaudio) | 开启/关闭范围语音功能。

范围语音是指，在同一 RTC 房间中设定的音频接收距离范围内，本地用户收听到的远端用户音频音量会随着远端用户的靠近/远离而放大/衰减；若远端用户在房间内的位置超出设定范围，则本地用户无法接收其音频。音频接收范围设置参看 [updateReceiveRange](70095#IRangeAudio-updatereceiverange)。 | | [setAttenuationModel](70095#IRangeAudio-setattenuationmodel) | 设置范围语音的音量衰减模式。
| | [setNoAttenuationFlags](70095#IRangeAudio-setnoattenuationflags) | 添加标签组，用于标记相互之间通话不衰减的用户组。

在同一个 RTC 房间中，如果多个用户的标签组之间有交集，那么，他们之间互相通话时，通话不衰减。

比如，用户身处多个队伍，队伍成员间通话不衰减。那么，可以为每个队伍绑定专属标签，每个用户的标签组包含用户所属各个队伍的标签。 | | [updatePosition](70095#IRangeAudio-updateposition) | 更新本地用户在房间内空间直角坐标系中的位置坐标。 | | [updateReceiveRange](70095#IRangeAudio-updatereceiverange) | 更新本地用户的音频收听范围。 | | [createStreamingRTCEngine](70095#createstreamingrtcengine) | 创建 IStreamingRTCEngine 实例。

如果当前线程中未创建引擎实例，那么你必须先使用此方法，以使用 IStreamingRTCEngine 提供的各种音视频能力。

如果当前线程中已创建了引擎实例，再次调用此方法时，会创建另一个独立的引擎实例。 | | [destroyStreamingRTCEngine](70095#destroystreamingrtcengine) | 销毁由 [createStreamingRTCEngine](70095#createstreamingrtcengine) 创建的 IStreamingRTCEngine 实例，并释放所有相关资源。 | | [setVideoEncoderConfig](70095#IStreamingRTCEngine-setvideoencoderconfig) | 设置推送多路流时的各路视频参数，包括分辨率、帧率、码率、缩放模式、网络不佳时的回退策略等。 | | [startup](70095#IStreamingRTCEngine-startup) | 启动串流引擎

通过 [EngineConfig](70098#engineconfig) 设置引擎类型服务端或客户端和端口号范围
| | [shutdown](70095#IStreamingRTCEngine-shutdown) | 关闭串流引擎 | | [sendP2PMessage](70095#IStreamingRTCEngine-sendp2pmessage) | 发送点对点文本消息 | | [sendP2PBinaryMessage](70095#IStreamingRTCEngine-sendp2pbinarymessage) | 发送点对点二进制消息 | | [pullAudioFrame](70095#IStreamingRTCEngine-pullaudioframe) | 拉取音频数据 | | [pushAudioFrame](70095#IStreamingRTCEngine-pushaudioframe) | 推送自定义音频数据 | | [setVideoDecoderConfig](70095#IStreamingRTCEngine-setvideodecoderconfig) | 设置远端视频数据解码方式。

需要在 [startup](70095#IStreamingRTCEngine-startup) 之前调用本接口。
| | [setVideoSourceType](70095#IStreamingRTCEngine-setvideosourcetype) | 设置输入到串流引擎的视频源

默认使用内部采集。内部采集指：使用 SDK 内置的视频采集机制进行视频采集。
| | [pushVideoFrame](70095#IStreamingRTCEngine-pushvideoframe) | 发送外部源视频数据 | | [pushEncodedVideoFrame](70095#IStreamingRTCEngine-pushencodedvideoframe) | 推送自定义编码后的视频流 | | [requestRemoteVideoKeyFrame](70095#IStreamingRTCEngine-requestremotevideokeyframe) | 在订阅远端视频流之后，向远端请求关键帧 | | [setReportExtraInfo](70095#IStreamingRTCEngine-setreportextrainfo) | 设置上报的 trace 的 extra_info | | [takeLocalSnapshot](70095#IRTCVideo-takelocalsnapshot) | 截取本地视频画面 | | [takeRemoteSnapshot](70095#IRTCVideo-takeremotesnapshot) | 截取远端视频画面 | | [setAnsMode](70095#IRTCVideo-setansmode) | 支持根据业务场景，设置通话中的音频降噪模式。 | | [updateSelfPosition](70095#ISpatialAudio-updateselfposition) | 设置本地用户在自建空间直角坐标系中的收听坐标和收听朝向，以实现本地用户预期的空间音频收听效果。 | | [updateRemotePosition](70095#ISpatialAudio-updateremoteposition) | 设置房间内某一远端用户在本地用户自建的空间音频坐标系中的发声位置和发声朝向，以实现本地用户预期的空间音频收听效果。 | | [removeRemotePosition](70095#ISpatialAudio-removeremoteposition) | 移除调用 [updateRemotePosition](70095#ISpatialAudio-updateremoteposition) 为某一远端用户设置的空间音频效果。 | | [removeAllRemotePosition](70095#ISpatialAudio-removeallremoteposition) | 移除调用 [updateRemotePosition](70095#ISpatialAudio-updateremoteposition) 为所有远端用户设置的空间音频效果。 | ## 字幕翻译服务 | 方法 | 描述 | | --- | --- | | [startSubtitle](70095#IRTCRoom-startsubtitle) | 识别或翻译房间内所有用户的语音，形成字幕。

调用该方法时，可以在 [SubtitleMode](70098#subtitlemode) 中选择语音识别或翻译模式。如果选择识别模式，语音识别文本会通过 [onSubtitleMessageReceived](70096#IRTCRoomEventHandler-onsubtitlemessagereceived) 事件回调给你；

如果选择翻译模式，你会同时收到两个 [onSubtitleMessageReceived](70096#IRTCRoomEventHandler-onsubtitlemessagereceived) 回调，分别包含字幕原文及字幕译文。

调用该方法后，用户会收到 [onSubtitleStateChanged](70096#IRTCRoomEventHandler-onsubtitlestatechanged) 回调，通知字幕是否开启。 | | [stopSubtitle](70095#IRTCRoom-stopsubtitle) | 关闭字幕。

调用该方法后，用户会收到 [onSubtitleStateChanged](70096#IRTCRoomEventHandler-onsubtitlestatechanged) 回调，通知字幕是否关闭。 | ## 在线 KTV | 方法 | 描述 | | --- | --- | | [getKTVManager](70095#IRTCVideo-getktvmanager) | 创建 KTV 管理接口。 | | [setMaxCacheSize](70095#IKTVManager-setmaxcachesize) | 设置歌曲文件最大占用的本地缓存。 | | [getMusicList](70095#IKTVManager-getmusiclist) | 获取歌曲列表。 | | [searchMusic](70095#IKTVManager-searchmusic) | 根据关键词搜索歌曲。 | | [getHotMusic](70095#IKTVManager-gethotmusic) | 根据榜单类别获取每个榜单的歌曲列表。 | | [getMusicDetail](70095#IKTVManager-getmusicdetail) | 获取音乐详细信息。 | | [downloadMusic](70095#IKTVManager-downloadmusic) | 下载音乐。 | | [downloadLyric](70095#IKTVManager-downloadlyric) | 下载歌词。 | | [downloadMidi](70095#IKTVManager-downloadmidi) | 下载 MIDI 文件。 | | [cancelDownload](70095#IKTVManager-canceldownload) | 取消下载任务。 | | [clearCache](70095#IKTVManager-clearcache) | 清除当前音乐缓存文件，包括音乐音频和歌词。 | | [setPlayerEventHandler](70095#IKTVPlayer-setplayereventhandler) | 设置 KTV 播放器进度及状态回调接口。 | | [playMusic](70095#IKTVPlayer-playmusic) | 播放歌曲。 | | [pauseMusic](70095#IKTVPlayer-pausemusic) | 暂停播放歌曲。 | | [resumeMusic](70095#IKTVPlayer-resumemusic) | 继续播放歌曲。 | | [stopMusic](70095#IKTVPlayer-stopmusic) | 停止播放歌曲。 | | [seekMusic](70095#IKTVPlayer-seekmusic) | 设置音乐文件的起始播放位置。 | | [setMusicVolume](70095#IKTVPlayer-setmusicvolume) | 设置歌曲播放音量，只能在开始播放后进行设置。 | | [switchAudioTrackType](70095#IKTVPlayer-switchaudiotracktype) | 切换歌曲原唱伴唱。 | | [setMusicPitch](70095#IKTVPlayer-setmusicpitch) | 对播放中的音乐设置升降调信息。 | | [getSingScoringManager](70095#IRTCVideo-getsingscoringmanager) | 创建 K 歌评分管理接口。 | | [getCount](70095#IStandardPitchCollection-getcount) | 获取歌词句子总数 | | [getStandardPitchInfo](70095#IStandardPitchCollection-getstandardpitchinfo) | 获取每句歌词的标准音高信息 | | [release](70095#IStandardPitchCollection-release) | 销毁 IStandardPitchCollection 类，释放资源 | | [initSingScoring](70095#ISingScoringManager-initsingscoring) | 初始化 K 歌评分。 | | [setSingScoringConfig](70095#ISingScoringManager-setsingscoringconfig) | 设置 K 歌评分参数。 | | [getStandardPitchInfoCollection](70095#ISingScoringManager-getstandardpitchinfocollection) | 获取标准音高数据。 | | [startSingScoring](70095#ISingScoringManager-startsingscoring) | 开始 K 歌评分。 | | [stopSingScoring](70095#ISingScoringManager-stopsingscoring) | 停止 K 歌评分。 | | [getLastSentenceScore](70095#ISingScoringManager-getlastsentencescore) | 获取上一句的演唱评分。调用 [startSingScoring](70095#ISingScoringManager-startsingscoring) 开始评分后可以调用该接口。 | | [getTotalScore](70095#ISingScoringManager-gettotalscore) | 获取当前演唱总分。调用 [startSingScoring](70095#ISingScoringManager-startsingscoring) 开始评分后可以调用该接口。 | | [getAverageScore](70095#ISingScoringManager-getaveragescore) | 获取当前演唱歌曲的平均分。 | | [setAudioAlignmentProperty](70095#IRTCVideo-setaudioalignmentproperty) | 在听众端，设置订阅的所有远端音频流精准对齐后播放。 | # 回调 ## 引擎管理 | 回调 | 描述 | | --- | --- | | [onLogReport](70096#IRTCVideoEventHandler-onlogreport) | 上报日志时回调该事件。 | | [onSysStats](70096#IRTCVideoEventHandler-onsysstats) | 周期性（2s）发出回调，报告当前 CPU 与内存的相关信息。 | | [onWarning](70096#IRTCVideoEventHandler-onwarning) | 发生警告回调。

SDK 运行时出现了警告。SDK 通常会自动恢复，警告信息可以忽略。

你可能需要干预. | | [onError](70096#IRTCVideoEventHandler-onerror) | 发生错误回调。

SDK 运行时出现了网络或媒体相关的错误，且无法自动恢复时触发此回调。 | | [onTokenWillExpire](70096#IRTCRoomEventHandler-ontokenwillexpire) | 当 SDK 检测到 Token 的进房权限将在 30 秒内过期时，触发该回调。

收到该回调后，你需调用 [updateToken](70095#IRTCRoom-updatetoken) 更新 Token 进房权限。 | | [onPublishPrivilegeTokenWillExpire](70096#IRTCRoomEventHandler-onpublishprivilegetokenwillexpire) | Token 发布权限过期前 30 秒将触发该回调。

收到该回调后，你需调用 [updateToken](70095#IRTCRoom-updatetoken) 更新 Token 发布权限。 | | [onSubscribePrivilegeTokenWillExpire](70096#IRTCRoomEventHandler-onsubscribeprivilegetokenwillexpire) | Token 订阅权限过期前 30 秒将触发该回调。

收到该回调后，你需调用 [updateToken](70095#IRTCRoom-updatetoken) 更新 Token 订阅权限有效期。 | ## 房间管理 | 回调 | 描述 | | --- | --- | | [onRoomStateChanged](70096#IRTCRoomEventHandler-onroomstatechanged) | 房间状态改变回调，加入房间、异常退出房间、发生房间相关的警告或错误时会收到此回调。 | | [onCreateRoomStateChanged](70096#IRTCVideoEventHandler-oncreateroomstatechanged) | 创建房间失败回调。 | | [onLeaveRoom](70096#IRTCRoomEventHandler-onleaveroom) | 离开房间成功回调。

用户调用 [leaveRoom](70095#IRTCRoom-leaveroom) 方法后，SDK 会停止所有的发布订阅流，并在释放所有与通话相关的音视频资源后，通过此回调通知用户离开房间成功。
| | [onUserJoined](70096#IRTCRoomEventHandler-onuserjoined) | 远端可见用户加入房间，或房内不可见用户切换为可见的回调。

1. 远端用户调用 [setUserVisibility](70095#IRTCRoom-setuservisibility) 方法将自身设为可见后加入房间时，房间内其他用户将收到该事件。

2. 远端可见用户断网后重新连入房间时，房间内其他用户将收到该事件。

3. 房间内隐身远端用户调用 [setUserVisibility](70095#IRTCRoom-setuservisibility) 方法切换至可见时，房间内其他用户将收到该事件。

4. 新进房用户会收到进房前已在房内的可见用户的进房回调通知。
| | [onUserLeave](70096#IRTCRoomEventHandler-onuserleave) | 远端用户离开房间，或切至不可见时，本地用户会收到此事件 | | [onUserVisibilityChanged](70096#IRTCRoomEventHandler-onuservisibilitychanged) | 用户调用 [setUserVisibility](70095#IRTCRoom-setuservisibility) 设置用户可见性的回调。 | | [onRoomStats](70096#IRTCRoomEventHandler-onroomstats) | 房间内通话统计信息回调。

用户进房开始通话后，每 2s 收到一次本回调。 | | [onSetRoomExtraInfoResult](70096#IRTCRoomEventHandler-onsetroomextrainforesult) | 调用 [setRoomExtraInfo](70095#IRTCRoom-setroomextrainfo) 设置房间附加信息结果的回调。 | | [onRoomExtraInfoUpdate](70096#IRTCRoomEventHandler-onroomextrainfoupdate) | 接收同一房间内，其他用户调用 [setRoomExtraInfo](70095#IRTCRoom-setroomextrainfo) 设置的房间附加信息的回调。 | ## 音频管理 | 回调 | 描述 | | --- | --- | | [onAudioDeviceWarning](70096#IRTCVideoEventHandler-onaudiodevicewarning) | 音频设备警告回调。音频设备包括音频采集设备和音频渲染设备。 | | [onAudioDeviceStateChanged](70096#IRTCVideoEventHandler-onaudiodevicestatechanged) | 音频设备状态回调。提示音频采集、音频播放等设备设备的状态。 | | [onLocalAudioPropertiesReport](70096#IRTCVideoEventHandler-onlocalaudiopropertiesreport) | 调用 [enableAudioPropertiesReport](70095#IRTCVideo-enableaudiopropertiesreport) 后，根据设置的 interval 值，你会周期性地收到此回调，了解本地音频的相关信息。

本地音频包括使用 RTC SDK 内部机制采集的麦克风音频，屏幕音频和本地混音音频信息。 | | [onRemoteAudioPropertiesReport](70096#IRTCVideoEventHandler-onremoteaudiopropertiesreport) | 远端用户进房后，本地调用 [enableAudioPropertiesReport](70095#IRTCVideo-enableaudiopropertiesreport)，根据设置的 interval 值，本地会周期性地收到此回调，了解订阅的远端用户的瞬时音频信息。

远端用户的音频包括使用 RTC SDK 内部机制/自定义机制采集的麦克风音频和屏幕音频。 | | [onUserStartAudioCapture](70096#IRTCVideoEventHandler-onuserstartaudiocapture) | 房间内的用户调用 [startAudioCapture](70095#IRTCVideo-startaudiocapture) 开启音频采集时，房间内其他用户会收到此回调。 | | [onUserStopAudioCapture](70096#IRTCVideoEventHandler-onuserstopaudiocapture) | 房间内的用户调用 [stopAudioCapture](70095#IRTCVideo-stopaudiocapture) 关闭音频采集时，房间内其他用户会收到此回调。 | | [onActiveSpeaker](70096#IRTCVideoEventHandler-onactivespeaker) | 调用 [enableAudioPropertiesReport](70095#IRTCVideo-enableaudiopropertiesreport) 后，根据设置的 `config.interval`，你会周期性地收到此回调，获取房间内的最活跃用户信息。 | | [onStreamSyncInfoReceived](70096#IRTCVideoEventHandler-onstreamsyncinforeceived) | 音频流同步信息回调。可以通过此回调，在远端用户调用 [sendStreamSyncInfo](70095#IRTCVideo-sendstreamsyncinfo) 发送音频流同步消息后，收到远端发送的音频流同步信息。
| | [onAudioStreamBanned](70096#IRTCRoomEventHandler-onaudiostreambanned) | 通过调用服务端 BanUserStream/UnbanUserStream 方法禁用/解禁指定房间内指定用户音频流的发送时，触发此回调。 | | [onAudioPlaybackDeviceTestVolume](70096#IRTCVideoEventHandler-onaudioplaybackdevicetestvolume) | 回调音频设备测试时的播放音量 | | [onAudioDeviceVolumeChanged](70096#IRTCVideoEventHandler-onaudiodevicevolumechanged) | 音频设备音量改变回调。当通过系统设置，改变音频设备音量或静音状态时，触发本回调。本回调无需手动开启。 | | [onHardwareEchoDetectionResult](70096#IRTCVideoEventHandler-onhardwareechodetectionresult) | 通话前回声检测结果回调。 | | [onLocalAudioStateChanged](70096#IRTCVideoEventHandler-onlocalaudiostatechanged) | 本地音频流的状态发生改变时，收到此回调。 | ## 视频管理 | 回调 | 描述 | | --- | --- | | [onUserStartVideoCapture](70096#IRTCVideoEventHandler-onuserstartvideocapture) | 房间内的可见用户调用 [startVideoCapture](70095#IRTCVideo-startvideocapture) 开启内部视频采集时，房间内其他用户会收到此回调。 | | [onUserStopVideoCapture](70096#IRTCVideoEventHandler-onuserstopvideocapture) | 房间内的可见用户调用 [stopVideoCapture](70095#IRTCVideo-stopvideocapture) 关闭内部视频采集时，房间内其他用户会收到此回调。
若发布视频数据前未开启采集，房间内所有可见用户会收到此回调。 | | [onVideoDeviceStateChanged](70096#IRTCVideoEventHandler-onvideodevicestatechanged) | 视频设备状态回调。提示摄像头视频采集、屏幕视频采集等设备的状态。 | | [onVideoDeviceWarning](70096#IRTCVideoEventHandler-onvideodevicewarning) | 视频设备警告回调，包括视频采集设备等。 | | [onFaceDetectResult](70096#IFaceDetectionObserver-onfacedetectresult) | 特效 SDK 进行人脸检测结果的回调。

调用 [enableFaceDetection](70095#IVideoEffect-enablefacedetection) 注册了 [IFaceDetectionObserver](70096#ifacedetectionobserver)，并使用 RTC SDK 中包含的特效 SDK 进行视频特效处理时，你会收到此回调。 | | [onLocalVideoStateChanged](70096#IRTCVideoEventHandler-onlocalvideostatechanged) | 本地视频流的状态发生改变时，收到该事件。 | ## 音视频传输 | 回调 | 描述 | | --- | --- | | [onStreamStateChanged](70096#IRTCRoomEventHandler-onstreamstatechanged) | 流状态改变回调，发生流相关的警告或错误时会收到此回调。 | | [onAVSyncStateChange](70096#IRTCRoomEventHandler-onavsyncstatechange) | 发布端调用 [setMultiDeviceAVSync](70095#IRTCRoom-setmultideviceavsync) 后音视频同步状态发生改变时，会收到此回调。 | | [onUserPublishStream](70096#IRTCRoomEventHandler-onuserpublishstream) | 房间内新增远端摄像头/麦克风采集的媒体流的回调。 | | [onUserUnpublishStream](70096#IRTCRoomEventHandler-onuserunpublishstream) | 房间内远端摄像头/麦克风采集的媒体流移除的回调。 | | [onStreamSubscribed](70096#IRTCRoomEventHandler-onstreamsubscribed) | 关于订阅媒体流状态改变的回调 | | [onAudioFrameSendStateChanged](70096#IRTCVideoEventHandler-onaudioframesendstatechanged) | 本地音频首帧发送状态发生改变时，收到此回调。 | | [onVideoFrameSendStateChanged](70096#IRTCVideoEventHandler-onvideoframesendstatechanged) | 本地视频首帧发送状态发生改变时，收到此回调。 | | [onAudioFramePlayStateChanged](70096#IRTCVideoEventHandler-onaudioframeplaystatechanged) | 音频首帧播放状态发生改变时，收到此回调。 | | [onVideoFramePlayStateChanged](70096#IRTCVideoEventHandler-onvideoframeplaystatechanged) | 视频首帧播放状态改变回调 | | [onLocalStreamStats](70096#IRTCRoomEventHandler-onlocalstreamstats) | 本地流数据统计以及网络质量回调。

本地用户发布流成功后，SDK 会周期性（2s）的通过此回调事件通知用户发布的流在此次统计周期内的质量统计信息。

统计信息通过 [LocalStreamStats](70098#localstreamstats) 类型的回调参数传递给用户，其中包括发送音视频比特率、发送帧率、编码帧率，网络质量等。 | | [onRemoteStreamStats](70096#IRTCRoomEventHandler-onremotestreamstats) | 本地订阅的远端音/视频流数据统计以及网络质量回调。

本地用户订阅流成功后，SDK 会周期性（2s）的通过此回调事件通知用户订阅的流在此次统计周期内的质量统计信息，包括：发送音视频比特率、发送帧率、编码帧率，网络质量等。 | | [onNetworkQuality](70096#IRTCRoomEventHandler-onnetworkquality) | 加入房间并发布或订阅流后，以每 2 秒一次的频率，报告本地用户和已订阅的远端用户的上下行网络质量信息。 | | [onForwardStreamStateChanged](70096#IRTCRoomEventHandler-onforwardstreamstatechanged) | 跨房间媒体流转发状态和错误回调 | | [onForwardStreamEvent](70096#IRTCRoomEventHandler-onforwardstreamevent) | 跨房间媒体流转发事件回调 | | [onRemoteAudioStateChanged](70096#IRTCVideoEventHandler-onremoteaudiostatechanged) | 用户订阅来自远端的音频流状态发生改变时，会收到此回调，了解当前的远端音频流状态。 | | [onFirstLocalAudioFrame](70096#IRTCVideoEventHandler-onfirstlocalaudioframe) | 发布音频流时，采集到第一帧音频帧，收到该回调。 | | [onFirstRemoteAudioFrame](70096#IRTCVideoEventHandler-onfirstremoteaudioframe) | 接收到来自远端某音频流的第一帧时，收到该回调。 | | [onFirstLocalVideoFrameCaptured](70096#IRTCVideoEventHandler-onfirstlocalvideoframecaptured) | RTC SDK 在本地完成第一帧视频帧或屏幕视频帧采集时，收到此回调。 | | [onLocalVideoSizeChanged](70096#IRTCVideoEventHandler-onlocalvideosizechanged) | 本地视频大小或旋转信息发生改变时，收到此回调。 | | [onRemoteVideoSizeChanged](70096#IRTCVideoEventHandler-onremotevideosizechanged) | 远端视频大小或旋转信息发生改变时，房间内订阅此视频流的用户会收到此回调。 | | [onRemoteVideoStateChanged](70096#IRTCVideoEventHandler-onremotevideostatechanged) | 远端视频流的状态发生改变时，房间内订阅此流的用户会收到该事件。 | | [onFirstRemoteVideoFrameRendered](70096#IRTCVideoEventHandler-onfirstremotevideoframerendered) | SDK 内部渲染成功远端视频流首帧后，收到此回调。 | | [onVideoStreamBanned](70096#IRTCRoomEventHandler-onvideostreambanned) | 通过调用服务端 BanUserStream/UnbanUserStream 方法禁用/解禁指定房间内指定用户视频流的发送时，触发此回调。 | | [onFirstRemoteVideoFrameDecoded](70096#IRTCVideoEventHandler-onfirstremotevideoframedecoded) | SDK 接收并解码远端视频流首帧后，收到此回调。 | | [onPushPublicStreamResult](70096#IRTCVideoEventHandler-onpushpublicstreamresult) | 公共流发布结果回调。

调用 [startPushPublicStream](70095#IRTCVideo-startpushpublicstream) 接口发布公共流后，启动结果通过此回调方法通知用户。 | | [onPlayPublicStreamResult](70096#IRTCVideoEventHandler-onplaypublicstreamresult) | 订阅公共流的结果回调

通过 [startPlayPublicStream](70095#IRTCVideo-startplaypublicstream) 订阅公共流后，可以通过本回调获取订阅结果。 | | [onPublicStreamSEIMessageReceived](70096#IRTCVideoEventHandler-onpublicstreamseimessagereceived) | 回调公共流中包含的 SEI 信息。
调用 [startPlayPublicStream](70095#IRTCVideo-startplaypublicstream) 接口启动拉公共流功能后，通过此回调收到公共流中的 SEI 消息。 | | [onFirstPublicStreamVideoFrameDecoded](70096#IRTCVideoEventHandler-onfirstpublicstreamvideoframedecoded) | 公共流的首帧视频解码成功

关于订阅公共流，详见 [startPlayPublicStream](70095#IRTCVideo-startplaypublicstream)。 | | [onFirstPublicStreamAudioFrame](70096#IRTCVideoEventHandler-onfirstpublicstreamaudioframe) | 公共流的音频首帧解码成功

关于订阅公共流，详见 [startPlayPublicStream](70095#IRTCVideo-startplaypublicstream)。 | ## 自定义流处理 | 回调 | 描述 | | --- | --- | | [onStart](70096#IExternalVideoEncoderEventHandler-onstart) | 提示自定义编码帧可以开始推送的回调。

收到该回调后，你即可调用 [pushExternalEncodedVideoFrame](70095#IRTCVideo-pushexternalencodedvideoframe) 向 SDK 推送自定义编码视频帧 | | [onStop](70096#IExternalVideoEncoderEventHandler-onstop) | 当收到该回调时，你需停止向 SDK 推送自定义编码视频帧 | | [onRateUpdate](70096#IExternalVideoEncoderEventHandler-onrateupdate) | 当自定义编码流的帧率或码率发生变化时，触发该回调 | | [onRequestKeyFrame](70096#IExternalVideoEncoderEventHandler-onrequestkeyframe) | 提示流发布端需重新生成关键帧的回调 | | [onActiveVideoLayer](70096#IExternalVideoEncoderEventHandler-onactivevideolayer) | 作为自定义编码视频流的发送端，你会在视频流可发送状态发生变化时，收到此回调。
你可以根据此回调的提示，仅对可发送的视频流进行编码，以降低本端视频编码性能消耗。此回调会根据多个因素综合判断触发，包括：本端设备性能和本端网络性能，以及按需订阅场景下，远端用户是否订阅。 | | [onLocalEncodedVideoFrame](70096#ILocalEncodedVideoFrameObserver-onlocalencodedvideoframe) | 调用 [registerLocalEncodedVideoFrameObserver](70095#IRTCVideo-registerlocalencodedvideoframeobserver) 后，SDK 每次使用内部采集，采集到一帧视频帧，或收到一帧外部视频帧时，都会回调该事件。 | | [onRemoteEncodedVideoFrame](70096#IRemoteEncodedVideoFrameObserver-onremoteencodedvideoframe) | 调用 [registerRemoteEncodedVideoFrameObserver](70095#IRTCVideo-registerremoteencodedvideoframeobserver) 后，SDK 监测到远端编码后视频数据时，触发该回调 | | [onProcessPlayBackAudioFrame](70096#IAudioFrameProcessor-onprocessplaybackaudioframe) | 回调远端音频混音的音频帧地址，供自定义音频处理。 | | [onProcessRecordAudioFrame](70096#IAudioFrameProcessor-onprocessrecordaudioframe) | 回调本地采集的音频帧地址，供自定义音频处理。 | | [onProcessRemoteUserAudioFrame](70096#IAudioFrameProcessor-onprocessremoteuseraudioframe) | 回调单个远端用户的音频帧地址，供自定义音频处理。 | | [onProcessScreenAudioFrame](70096#IAudioFrameProcessor-onprocessscreenaudioframe) | 屏幕共享的音频帧地址回调。你可根据此回调自定义处理音频。 | | [onRecordAudioFrame](70096#IAudioFrameObserver-onrecordaudioframe) | 返回麦克风录制的音频数据 | | [onPlaybackAudioFrame](70096#IAudioFrameObserver-onplaybackaudioframe) | 返回订阅的所有远端用户混音后的音频数据。 | | [onRemoteUserAudioFrame](70096#IAudioFrameObserver-onremoteuseraudioframe) | 返回远端单个用户的音频数据 | | [onMixedAudioFrame](70096#IAudioFrameObserver-onmixedaudioframe) | 返回本地麦克风录制和订阅的所有远端用户混音后的音频数据 | | [onRecordScreenAudioFrame](70096#IAudioFrameObserver-onrecordscreenaudioframe) | 返回本地屏幕录制的音频数据 | ## 网络管理 | 回调 | 描述 | | --- | --- | | [onPerformanceAlarms](70096#IRTCVideoEventHandler-onperformancealarms) | 本地未通过 [setPublishFallbackOption](70095#IRTCVideo-setpublishfallbackoption) 开启发布性能回退，检测到设备性能不足时，收到此回调。

本地通过 [setPublishFallbackOption](70095#IRTCVideo-setpublishfallbackoption) 开启发布性能回退，因设备性能/网络原因，造成发布性能回退/恢复时，收到此回调。 | | [onSimulcastSubscribeFallback](70096#IRTCVideoEventHandler-onsimulcastsubscribefallback) | 音视频流因网络环境变化等原因发生回退，或从回退中恢复时，触发该回调。 | | [onNetworkDetectionResult](70096#IRTCVideoEventHandler-onnetworkdetectionresult) | 通话前网络探测结果。

成功调用 [startNetworkDetection](70095#IRTCVideo-startnetworkdetection) 接口开始探测后，会在 3s 内首次收到该回调，之后每 2s 收到一次该回调。 | | [onNetworkDetectionStopped](70096#IRTCVideoEventHandler-onnetworkdetectionstopped) | 通话前网络探测结束
以下情况将停止探测并收到本一次本回调：

1. 当调用 [stopNetworkDetection](70095#IRTCVideo-stopnetworkdetection) 接口停止探测后，会收到一次该回调；
2. 当收到远端/本端音频首帧后，停止探测；
3. 当探测超过3分钟后，停止探测；
4. 当探测链路断开一定时间之后，停止探测。 | | [onConnectionStateChanged](70096#IRTCVideoEventHandler-onconnectionstatechanged) | SDK 与信令服务器连接状态改变回调。连接状态改变时触发。 | | [onNetworkTypeChanged](70096#IRTCVideoEventHandler-onnetworktypechanged) | SDK 当前网络连接类型改变回调。当 SDK 的当前网络连接类型发生改变时回调该事件。 | | [onSEIMessageReceived](70096#IRTCVideoEventHandler-onseimessagereceived) | 收到通过调用 [sendSEIMessage](70095#IRTCVideo-sendseimessage) 发送带有 SEI 消息的视频帧时，收到此回调。 | | [onEchoTestResult](70096#IRTCVideoEventHandler-onechotestresult) | 关于音视频回路测试结果的回调。 | | [onNetworkTimeSynchronized](70096#IRTCVideoEventHandler-onnetworktimesynchronized) | 首次调用 [getNetworkTimeInfo](70095#IRTCVideo-getnetworktimeinfo) 后，SDK 内部启动网络时间同步，同步完成时会触发此回调。 | ## 消息 | 回调 | 描述 | | --- | --- | | [onLoginResult](70096#IRTCVideoEventHandler-onloginresult) | 登录结果回调 | | [onLogout](70096#IRTCVideoEventHandler-onlogout) | 登出结果回调 | | [onServerParamsSetResult](70096#IRTCVideoEventHandler-onserverparamssetresult) | 设置应用服务器参数的返回结果 | | [onGetPeerOnlineStatus](70096#IRTCVideoEventHandler-ongetpeeronlinestatus) | 查询对端或本端用户登录状态的返回结果 | | [onUserMessageReceivedOutsideRoom](70096#IRTCVideoEventHandler-onusermessagereceivedoutsideroom) | 收到房间外用户调用 [sendUserMessageOutsideRoom](70095#IRTCVideo-sendusermessageoutsideroom) 发来的文本消息时，会收到此回调 | | [onUserBinaryMessageReceivedOutsideRoom](70096#IRTCVideoEventHandler-onuserbinarymessagereceivedoutsideroom) | 收到房间外用户调用 [sendUserBinaryMessageOutsideRoom](70095#IRTCVideo-senduserbinarymessageoutsideroom) 发来的二进制消息时，会收到此回调 | | [onUserMessageSendResultOutsideRoom](70096#IRTCVideoEventHandler-onusermessagesendresultoutsideroom) | 给房间外指定的用户发送消息的回调 | | [onServerMessageSendResult](70096#IRTCVideoEventHandler-onservermessagesendresult) | 给应用服务器发送消息的回调。 | | [onRoomMessageReceived](70096#IRTCRoomEventHandler-onroommessagereceived) | 接收到房间内广播消息的回调。 | | [onRoomBinaryMessageReceived](70096#IRTCRoomEventHandler-onroombinarymessagereceived) | 收到房间内广播二进制消息的回调。

房间内其他用户调用 [sendRoomBinaryMessage](70095#IRTCRoom-sendroombinarymessage) 发送广播二进制消息时，收到此回调。 | | [onUserMessageReceived](70096#IRTCRoomEventHandler-onusermessagereceived) | 收到来自房间中其他用户通过 [sendUserMessage](70095#IRTCRoom-sendusermessage) 发来的点对点文本消息时，会收到此回调。 | | [onUserBinaryMessageReceived](70096#IRTCRoomEventHandler-onuserbinarymessagereceived) | 收到来自房间中其他用户通过 [sendUserBinaryMessage](70095#IRTCRoom-senduserbinarymessage) 发来的点对点二进制消息时，会收到此回调。 | | [onUserMessageSendResult](70096#IRTCRoomEventHandler-onusermessagesendresult) | 向房间内单个用户发送文本或二进制消息后（P2P），消息发送方会收到该消息发送结果回调。 | | [onRoomMessageSendResult](70096#IRTCRoomEventHandler-onroommessagesendresult) | 调用 [sendRoomMessage](70095#IRTCRoom-sendroommessage) 或 [sendRoomBinaryMessage](70095#IRTCRoom-sendroombinarymessage) 向房间内群发文本或二进制消息后，消息发送方会收到该消息发送结果回调。 | | [onSEIStreamUpdate](70096#IRTCVideoEventHandler-onseistreamupdate) | 黑帧视频流发布状态回调。

在语音通话场景下，本地用户调用 [sendSEIMessage](70095#IRTCVideo-sendseimessage) 通过黑帧视频流发送 SEI 数据时，流的发送状态会通过该回调通知远端用户。

你可以通过此回调判断携带 SEI 数据的视频帧为黑帧，从而不对该视频帧进行渲染。 | ## CDN 推流 | 回调 | 描述 | | --- | --- | | [onStreamPushEvent](70096#IPushSingleStreamToCDNObserver-onstreampushevent) | 单流转推直播状态回调 | ## 混音 | 回调 | 描述 | | --- | --- | | [onAudioEffectPlayerStateChanged](70096#IAudioEffectPlayerEventHandler-onaudioeffectplayerstatechanged) | 播放状态改变时回调。 | | [onFrame](70096#IMediaPlayerAudioFrameObserver-onframe) | 当本地音频文件混音时，回调播放的音频帧。 | | [onMediaPlayerStateChanged](70096#IMediaPlayerEventHandler-onmediaplayerstatechanged) | 播放状态改变时回调。 | | [onMediaPlayerPlayingProgress](70096#IMediaPlayerEventHandler-onmediaplayerplayingprogress) | 播放进度周期性回调。回调周期通过 [setProgressInterval](70095#IMediaPlayer-setprogressinterval) 设置。 | | [onReadData](70096#IMediaPlayerCustomSourceProvider-onreaddata) | 调用 [openWithCustomSource](70095#IMediaPlayer-openwithcustomsource) 接口播放用户传入的内存音频数据时，会触发此回调，用户需要写入音频数据。 | | [onSeek](70096#IMediaPlayerCustomSourceProvider-onseek) | 根据设置好的内存音频数据的读取位置和读取偏移量对音频数据进行偏移，以便 SDK 读取和分析音频数据。

在调用 [openWithCustomSource](70095#IMediaPlayer-openwithcustomsource) 接口传入内存音频数据，或者调用 [setPosition](70095#IMediaPlayer-setposition) 设置了音频数据的起始播放位置后，SDK 会对音频数据进行读取和分析，此时会触发该回调，你需要根据参数中设置的起始读取位置和偏移量进行操作。 | ## 屏幕分享 | 回调 | 描述 | | --- | --- | | [onUserPublishScreen](70096#IRTCRoomEventHandler-onuserpublishscreen) | 房间内新增远端屏幕共享音视频流的回调。 | | [onUserUnpublishScreen](70096#IRTCRoomEventHandler-onuserunpublishscreen) | 房间内远端屏幕共享音视频流移除的回调。 | | [onScreenVideoFrameSendStateChanged](70096#IRTCVideoEventHandler-onscreenvideoframesendstatechanged) | 屏幕共享流的视频首帧发送状态发生改变时，收到此回调。 | | [onScreenVideoFramePlayStateChanged](70096#IRTCVideoEventHandler-onscreenvideoframeplaystatechanged) | 屏幕共享流视频首帧播放状态发生改变时，收到此回调。 | | [onExternalScreenFrameUpdate](70096#IRTCVideoEventHandler-onexternalscreenframeupdate) | 外部采集时，调用 [setOriginalScreenVideoInfo](70095#IRTCVideo-setoriginalscreenvideoinfo)设置屏幕或窗口大小改变前的分辨率后，若屏幕采集模式为智能模式，你将收到此回调，根据 RTC 智能决策合适的帧率和分辨率积（宽*高）重新采集。 | | [onScreenAudioFrameSendStateChanged](70096#IRTCVideoEventHandler-onscreenaudioframesendstatechanged) | 屏幕音频首帧发送状态改变回调 | | [onScreenAudioFramePlayStateChanged](70096#IRTCVideoEventHandler-onscreenaudioframeplaystatechanged) | 屏幕音频首帧播放状态改变回调 | ## 安全与加密 | 回调 | 描述 | | --- | --- | | [onCloudProxyConnected](70096#IRTCVideoEventHandler-oncloudproxyconnected) | 调用 [startCloudProxy](70095#IRTCVideo-startcloudproxy) 开启云代理，SDK 首次成功连接云代理服务器时，回调此事件。 | | [onEncryptData](70096#IEncryptHandler-onencryptdata) | 自定义加密。

使用设定的自定义加密方式，对编码后传输前的音视频帧数据进行加密。

暂不支持对原始音视频帧进行加密。 | | [onDecryptData](70096#IEncryptHandler-ondecryptdata) | 自定义解密。

对自定义加密后的音视频帧数据进行解密。关于自定义加密，参看 [onEncryptData](70096#IEncryptHandler-onencryptdata)。 | | [onLocalProxyStateChanged](70096#IRTCVideoEventHandler-onlocalproxystatechanged) | 本地代理状态发生改变回调。调用 [setLocalProxy](70095#IRTCVideo-setlocalproxy) 设置本地代理后，SDK 会触发此回调，返回代理连接的状态。 | ## 高级功能 | 回调 | 描述 | | --- | --- | | [onExtensionAccessError](70096#IRTCVideoEventHandler-onextensionaccesserror) | 当访问插件失败时，收到此回调。
RTC SDK 将一些功能封装成插件。当使用这些功能时，如果插件不存在，功能将无法使用。 | | [onRecordingStateUpdate](70096#IRTCVideoEventHandler-onrecordingstateupdate) | 获取本地录制状态回调。

该回调由 [startFileRecording](70095#IRTCVideo-startfilerecording) 或 [stopFileRecording](70095#IRTCVideo-stopfilerecording) 触发。 | | [onRecordingProgressUpdate](70096#IRTCVideoEventHandler-onrecordingprogressupdate) | 本地录制进度回调。

该回调由 [startFileRecording](70095#IRTCVideo-startfilerecording) 触发，录制状态正常时，系统每秒钟都会通过该回调提示录制进度。 | | [onAudioRecordingStateUpdate](70096#IRTCVideoEventHandler-onaudiorecordingstateupdate) | 调用 [startAudioRecording](70095#IRTCVideo-startaudiorecording) 或 [stopAudioRecording](70095#IRTCVideo-stopaudiorecording) 改变音频文件录制状态时，收到此回调。 | | [onLogReport](70096#IStreamingRTCEventHandler-onlogreport) | 端监控日志回调。当产生一个端监控事件时触发该回调。 | | [onWarning](70096#IStreamingRTCEventHandler-onwarning) | 当内部发生警告事件时触发该回调 | | [onError](70096#IStreamingRTCEventHandler-onerror) | 当 SDK 内部发生不可逆转错误时触发该回调。 | | [onP2PConnectionStateChanged](70096#IStreamingRTCEventHandler-onp2pconnectionstatechanged) | 串流引擎连接状态改变回调。连接状态改变时触发。 | | [onP2PConnectionStats](70096#IStreamingRTCEventHandler-onp2pconnectionstats) | P2P 通话统计信息回调。

串流引擎启动后，每 2s 收到一次本回调。 | | [onP2PLocalStreamStats](70096#IStreamingRTCEventHandler-onp2plocalstreamstats) | 串流引擎启动后，每隔 2s 收到此回调，了解本端发布的流在此周期内的网络质量信息。 | | [onP2PRemoteStreamStats](70096#IStreamingRTCEventHandler-onp2premotestreamstats) | 每隔 2s 收到此回调，了解远端用户发布的流在此周期内的网络质量信息。 | | [onP2PMessageSendResult](70096#IStreamingRTCEventHandler-onp2pmessagesendresult) | 调用 [sendP2PMessage](70095#IStreamingRTCEngine-sendp2pmessage) 或 [sendP2PBinaryMessage](70095#IStreamingRTCEngine-sendp2pbinarymessage) ，向远端用户发送文本或二进制消息后，消息发送方会收到本次发送的结果回调。 | | [onP2PMessageReceived](70096#IStreamingRTCEventHandler-onp2pmessagereceived) | 收到远端用户发来的文本消息时，会收到此回调。 | | [onP2PBinaryMessageReceived](70096#IStreamingRTCEventHandler-onp2pbinarymessagereceived) | 收到远端用户发来的二进制消息时，会收到此回调。 | | [onP2PRemoteVideoFrame](70096#IStreamingRTCEventHandler-onp2premotevideoframe) | 获取远端用户发送的视频帧。

关于推送视频帧，参看 [pushVideoFrame](70095#IStreamingRTCEngine-pushvideoframe)

关于推送已编码的视频流，参看 [pushEncodedVideoFrame](70095#IStreamingRTCEngine-pushencodedvideoframe)

关于编码设置，参看 [setVideoDecoderConfig](70095#IStreamingRTCEngine-setvideodecoderconfig)
| | [onP2PRemoteEncodedVideoFrame](70096#IStreamingRTCEventHandler-onp2premoteencodedvideoframe) | 获取远端用户解码前的视频数据。获取数据后传入自定义解码器进行解码。

关于推送视频帧，参看 [pushVideoFrame](70095#IStreamingRTCEngine-pushvideoframe)

关于推送已编码的视频流，参看 [pushEncodedVideoFrame](70095#IStreamingRTCEngine-pushencodedvideoframe)

关于编码设置，参看 [setVideoDecoderConfig](70095#IStreamingRTCEngine-setvideodecoderconfig)
| | [onP2PLocalExternalEncoderStart](70096#IStreamingRTCEventHandler-onp2plocalexternalencoderstart) | 提醒外部视频编码器开始工作。

关于编码设置，参看 [setVideoSourceType](70095#IStreamingRTCEngine-setvideosourcetype)
| | [onP2PLocalExternalEncoderStop](70096#IStreamingRTCEventHandler-onp2plocalexternalencoderstop) | 提醒外部视频编码器停止工作。

关于编码设置，参看 [setVideoSourceType](70095#IStreamingRTCEngine-setvideosourcetype)
| | [onP2PSuggestLocalExternalEncoderRateUpdate](70096#IStreamingRTCEventHandler-onp2psuggestlocalexternalencoderrateupdate) | 提醒外部视频编码器调整编码码率。

关于编码设置，参看 [setVideoSourceType](70095#IStreamingRTCEngine-setvideosourcetype)
| | [onP2PRequestLocalExternalEncoderKeyFrame](70096#IStreamingRTCEventHandler-onp2prequestlocalexternalencoderkeyframe) | 提醒外部视频编码器发送关键帧。

关于编码设置，参看 [setVideoSourceType](70095#IStreamingRTCEngine-setvideosourcetype)
| | [onTakeLocalSnapshotResult](70096#ISnapshotResultCallback-ontakelocalsnapshotresult) | 调用 [takeLocalSnapshot](70095#IRTCVideo-takelocalsnapshot) 截取视频画面时，收到此回调。 | | [onTakeRemoteSnapshotResult](70096#ISnapshotResultCallback-ontakeremotesnapshotresult) | 调用 [takeRemoteSnapshot](70095#IRTCVideo-takeremotesnapshot) 截取视频画面时，收到此回调。 | ## 字幕翻译服务 | 回调 | 描述 | | --- | --- | | [onSubtitleStateChanged](70096#IRTCRoomEventHandler-onsubtitlestatechanged) | 字幕状态发生改变回调。

当用户调用 [startSubtitle](70095#IRTCRoom-startsubtitle) 和 [stopSubtitle](70095#IRTCRoom-stopsubtitle) 使字幕状态发生改变或出现错误时，触发该回调。 | | [onSubtitleMessageReceived](70096#IRTCRoomEventHandler-onsubtitlemessagereceived) | 字幕相关内容回调。

当用户调用 [startSubtitle](70095#IRTCRoom-startsubtitle) 后会收到此回调，通知字幕的相关信息。 | ## 在线 KTV | 回调 | 描述 | | --- | --- | | [onMusicListResult](70096#IKTVManagerEventHandler-onmusiclistresult) | 歌曲列表回调。 | | [onSearchMusicResult](70096#IKTVManagerEventHandler-onsearchmusicresult) | 搜索歌曲结果回调。 | | [onHotMusicResult](70096#IKTVManagerEventHandler-onhotmusicresult) | 热榜歌曲结果回调。 | | [onMusicDetailResult](70096#IKTVManagerEventHandler-onmusicdetailresult) | 歌曲详细信息回调。 | | [onDownloadSuccess](70096#IKTVManagerEventHandler-ondownloadsuccess) | 下载成功回调。 | | [onDownloadFailed](70096#IKTVManagerEventHandler-ondownloadfailed) | 下载失败回调。 | | [onDownloadMusicProgress](70096#IKTVManagerEventHandler-ondownloadmusicprogress) | 歌曲文件下载进度回调。 | | [onPlayProgress](70096#IKTVPlayerEventHandler-onplayprogress) | 音乐播放进度回调。 | | [onCurrentScoringInfo](70096#ISingScoringEventHandler-oncurrentscoringinfo) | 实时评分信息回调。调用 [startSingScoring](70095#ISingScoringManager-startsingscoring) 后，会收到该回调。 |

实时音视频