## 引擎管理 | 方法 | 描述 | | --- | --- | | [createRTCEngine](70080#RTCEngine-creatertcengine) | 创建引擎对象

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

如果当前进程中已创建了引擎实例，再次调用此方法时，会返回已创建的引擎实例。 | | [setVideoCaptureRotation](70080#RTCEngine-setvideocapturerotation) | 设置本端采集的视频帧的旋转角度。

当摄像头倒置或者倾斜安装时，可调用本接口进行调整。对于手机等普通设备，可调用 [setVideoRotationMode](70080#RTCEngine-setvideorotationmode) 实现旋转。 | | [getNativeHandle](70080#RTCEngine-getnativehandle) | 获取 C++ 层 [IRTCEngine 句柄](https://www.volcengine.com/docs/6348/70095#irtcengine)。 | | [feedback](70080#RTCEngine-feedback) | 将用户反馈的问题上报到 RTC。 | | [setRuntimeParameters](70080#RTCEngine-setruntimeparameters) | 设置运行时的参数 | | [setBusinessId](70080#RTCEngine-setbusinessid) | 设置业务标识参数

可通过 businessId 区分不同的业务场景。businessId 由客户自定义，相当于一个“标签”，可以分担和细化现在 AppId 的逻辑划分的功能，但不需要鉴权。 | | [setLogConfig](70080#RTCEngine-setlogconfig) | 配置 SDK 本地日志参数，包括日志级别、存储路径、日志文件最大占用的总空间、日志文件名前缀。 | | [getSDKVersion](70080#RTCEngine-getsdkversion) | 获取 SDK 当前的版本号。 | | [destroyRTCEngine](70080#RTCEngine-destroyrtcengine) | 销毁由 [createRTCEngine](70080#RTCEngine-creatertcengine) 所创建的引擎实例，并释放所有相关资源。 | | 回调 | 描述 | | --- | --- | | [onTokenWillExpire](70081#IRTCRoomEventHandler-ontokenwillexpire) | 当 SDK 检测到 Token 的进房权限将在 30 秒内过期时，触发该回调。
收到该回调后，你需调用 [updateToken](70080#RTSRoom-updatetoken) 更新 Token 进房权限。 | | [onLogReport](70081#IRTCEngineEventHandler-onlogreport) | 上报日志时回调该事件。 | | [onSysStats](70081#IRTCEngineEventHandler-onsysstats) | 每 2 秒发生回调，通知当前 cpu，内存使用的信息。 | | [onError](70081#IRTCEngineEventHandler-onerror) | 发生错误回调。

SDK 运行时出现了网络或媒体相关的错误，且无法自动恢复时触发此回调。

你可能需要干预. | | [onWarning](70081#IRTCEngineEventHandler-onwarning) | 发生警告回调。

SDK 运行时出现了警告。SDK 通常会自动恢复，警告信息可以忽略。 | | [onSubscribePrivilegeTokenWillExpire](70081#IRTCRoomEventHandler-onsubscribeprivilegetokenwillexpire) | Token 订阅权限过期前 30 秒将触发该回调。

收到该回调后，你需调用 [updateToken](70080#RTSRoom-updatetoken) 更新 Token 订阅权限有效期。 | | [onPublishPrivilegeTokenWillExpire](70081#IRTCRoomEventHandler-onpublishprivilegetokenwillexpire) | Token 发布权限过期前 30 秒将触发该回调。

收到该回调后，你需调用 [updateToken](70080#RTSRoom-updatetoken) 更新 Token 发布权限。 | ## 房间管理 ### RTC 房间方法 | 方法 | 描述 | | --- | --- | | [createRTCRoom](70080#RTCEngine-creatertcroom) | 创建 RTC 房间实例。

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

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

多房间模式下，用户可以同时订阅各房间的音视频流。 | | [joinRoom](70080#RTCRoom-joinroom) | 加入 RTC 房间。

调用 [createRTCRoom](70080#RTCEngine-creatertcroom) 创建房间后，调用此方法加入房间，同房间内其他用户进行音视频通话。 | | [leaveRoom](70080#RTSRoom-leaveroom) | 离开 RTC 房间。

调用此方法结束通话过程，并释放所有通话相关的资源。 | | [updateToken](70080#RTSRoom-updatetoken) | 更新 RTC 房间的 Token。

收到 [onTokenWillExpire](70081#IRTCRoomEventHandler-ontokenwillexpire)、[onPublishPrivilegeTokenWillExpire](70081#IRTCRoomEventHandler-onpublishprivilegetokenwillexpire) 或 [onSubscribePrivilegeTokenWillExpire](70081#IRTCRoomEventHandler-onsubscribeprivilegetokenwillexpire) 时，你必须重新获取 Token，并调用此方法更新 Token，以保证通话的正常进行。 | | [setUserVisibility](70080#RTCRoom-setuservisibility) | 设置用户可见性。未调用该接口前，本地用户默认对他人可见。

默认情况下，一个 RTC 房间最多同时容纳 50 名可见用户，最多 30 人可同时上麦。更多信息参看[用户和媒体流上限](https://www.volcengine.com/docs/6348/257549)。 | | [setRoomExtraInfo](70080#RTCRoom-setroomextrainfo) | 设置/更新 RTC 房间附加信息，可用于标识房间状态或属性，或灵活实现各种业务逻辑。 | | [getRoomId](70080#RTCRoom-getroomid) | 获取 RTC 房间 ID。 | | [getCallId](70080#RTCRoom-getcallid) | 获取通话 ID。

该方法需要在加入 RTC 房间后调用。当创建一个房间开启音视频通话后，系统会为该房间生成一个对应的通话 ID，标识此房间的通话。 | | [setRTCRoomEventHandler](70080#RTCRoom-setrtcroomeventhandler) | 通过设置 [RTCRoom](70080#RTCRoom) 对象的事件句柄，监听此对象对应的回调事件。 | | [destroy](70080#RTCRoom-destroy) | 退出并销毁调用 [createRTCRoom](70080#RTCEngine-creatertcroom) 所创建的房间实例。 | ### RTS 房间方法 | 方法 | 描述 | | --- | --- | | [createRTSRoom](70080#RTCEngine-creatertsroom) | 创建 [RTSRoom](70080#RTSRoom) 实例。

调用此方法仅返回一个房间实例，你仍需调用 [joinRTSRoom](70080#RTSRoom-joinrtsroom) 才能真正地创建/加入房间。 | | [joinRTSRoom](70080#RTSRoom-joinrtsroom) | 加入 RTS 房间。

调用 [createRTSRoom](70080#RTCEngine-creatertsroom) 创建房间后，调用此方法加入房间，同房间内其他用户进行音视频通话。 | | [leaveRoom](70080#RTSRoom-leaveroom) | 离开 RTS 房间。

调用此方法结束通话过程，并释放所有通话相关的资源。 | | [updateToken](70080#RTSRoom-updatetoken) | 更新 RTS 房间的 Token。

收到 [onTokenWillExpire](70081#IRTCRoomEventHandler-ontokenwillexpire)、[onPublishPrivilegeTokenWillExpire](70081#IRTCRoomEventHandler-onpublishprivilegetokenwillexpire) 或 [onSubscribePrivilegeTokenWillExpire](70081#IRTCRoomEventHandler-onsubscribeprivilegetokenwillexpire) 时，你必须重新获取 Token，并调用此方法更新 Token，以保证通话的正常进行。 | | [setRTSRoomEventHandler](70080#RTSRoom-setrtsroomeventhandler) | 通过设置 [RTSRoom](70080#RTSRoom) 对象的事件句柄，监听此对象对应的回调事件。 | | [destroy](70080#RTSRoom-destroy) | 退出并销毁调用 [createRTSRoom](70080#RTCEngine-creatertsroom) 所创建的房间实例。 | ### 游戏房间方法 | 方法 | 描述 | | --- | --- | | [createGameRoom](70080#RTCEngine-creategameroom) | 创建游戏语音房间实例。

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

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

多房间模式下，用户可以同时订阅各房间的音视频流。 | | [joinRoom](70080#IGameRoom-joinroom) | 加入游戏房间。

调用 [createGameRoom](70080#RTCEngine-creategameroom) 创建游戏房间实例后，调用此方法加入游戏房间，同房间内其他用户进行音频通话。 | | [leaveRoom](70080#IGameRoom-leaveroom) | 离开游戏房间。

调用此方法结束通话过程，并释放所有通话相关的资源。 | | [updateToken](70080#IGameRoom-updatetoken) | 更新游戏房间的 Token。

收到 [onTokenWillExpire](70081#IRTCRoomEventHandler-ontokenwillexpire)，[onPublishPrivilegeTokenWillExpire](70081#IRTCRoomEventHandler-onpublishprivilegetokenwillexpire)，或 [onSubscribePrivilegeTokenWillExpire](70081#IRTCRoomEventHandler-onsubscribeprivilegetokenwillexpire) 时，你必须重新获取 Token，并调用此方法更新 Token，以保证通话的正常进行。 | | [setRTCRoomEventHandler](70080#IGameRoom-setrtcroomeventhandler) | 通过设置 [IGameRoom](70080#IGameRoom) 对象的事件句柄，监听此对象对应的回调事件。 | | [destroy](70080#IGameRoom-destroy) | 退出并销毁调用 [createGameRoom](70080#RTCEngine-creategameroom) 所创建的游戏房间实例。 | ### RTC/游戏房间回调 | 回调 | 描述 | | --- | --- | | [onRoomStateChanged](70081#IRTCRoomEventHandler-onroomstatechanged) | RTC 房间状态改变回调，加入房间、异常退出房间、发生房间相关的警告或错误时会收到此回调。 | | [onUserJoined](70081#IRTCRoomEventHandler-onuserjoined) | 远端可见用户加入房间，或房内不可见用户切换为可见的回调。 | | [onUserLeave](70081#IRTCRoomEventHandler-onuserleave) | 远端用户离开房间，或切至不可见时，房间内其他用户会收到此事件。 | | [onUserVisibilityChanged](70081#IRTCRoomEventHandler-onuservisibilitychanged) | 用户调用 [setUserVisibility](70080#RTCRoom-setuservisibility) 设置用户可见性的回调。 | | [onRoomStats](70081#IRTCRoomEventHandler-onroomstats) | 房间内通话统计信息回调。用户进房开始通话后，每 2s 收到一次本回调。 | | [onSetRoomExtraInfoResult](70081#IRTCRoomEventHandler-onsetroomextrainforesult) | 调用 [setRoomExtraInfo](70080#RTCRoom-setroomextrainfo) 设置房间附加信息结果的回调。 | | [onRoomExtraInfoUpdate](70081#IRTCRoomEventHandler-onroomextrainfoupdate) | 接收同一房间内，其他用户调用 [setRoomExtraInfo](70080#RTCRoom-setroomextrainfo) 设置的房间附加信息的回调。 | | [onRoomStreamExtraInfoUpdate](70081#IRTCRoomEventHandler-onroomstreamextrainfoupdate) | 接收同一房间内，其他用户调用 [setStreamExtraInfo](70080#RTCRoom-setstreamextrainfo) 设置的流附加信息的回调。 | ### RTS 房间回调 | 回调 | 描述 | | --- | --- | | [onRoomStateChanged](70081#IRTSRoomEventHandler-onroomstatechanged) | RTS 房间状态改变回调，加入房间、异常退出房间、发生房间相关的警告或错误时会收到此回调。 | | [onLeaveRoom](70081#IRTSRoomEventHandler-onleaveroom) | 离开 RTS 房间成功回调。 | | [onUserJoined](70081#IRTSRoomEventHandler-onuserjoined) | 远端可见用户加入 RTS 房间的回调。 | | [onUserLeave](70081#IRTSRoomEventHandler-onuserleave) | 远端用户离开 RTS 房间的回调。 | ## 音频管理 | 方法 | 描述 | | --- | --- | | [startAudioPlaybackDeviceTest](70080#IRTCAudioDeviceManager-startaudioplaybackdevicetest) | 启动音频播放设备检测。测试启动后，循环播放指定的音频文件，同时将通过 `onAudioPlaybackDeviceTestVolume` 回调播放时的音量信息。 | | [stopHardwareEchoDetection](70080#RTCEngine-stophardwareechodetection) | 停止通话前回声检测 | | [startHardwareEchoDetection](70080#RTCEngine-starthardwareechodetection) | 开启通话前回声检测 | | [setRemoteAudioPlaybackVolume](70080#RTCEngine-setremoteaudioplaybackvolume) | 调节本端播放收到的远端流时的音量。你必须在进房后进行设置。流的发布状态改变不影响设置生效。 | | [enableAudioPropertiesReport](70080#RTCEngine-enableaudiopropertiesreport) | 启用音频信息提示。开启提示后，你可以收到 [onLocalAudioPropertiesReport](70081#IRTCEngineEventHandler-onlocalaudiopropertiesreport)，[onRemoteAudioPropertiesReport](70081#IRTCEngineEventHandler-onremoteaudiopropertiesreport) 和 [onActiveSpeaker](70081#IRTCEngineEventHandler-onactivespeaker)。 | | [enablePlaybackDucking](70080#RTCEngine-enableplaybackducking) | 打开/关闭音量闪避功能，适用于在 RTC 通话过程中会同时播放短视频或音乐的场景，如“一起看”等。

开启该功能后，当检测到远端人声时，RTC 的本地的媒体播放音量会自动减弱，从而保证远端人声的清晰可辨；当远端人声消失时，RTC 的本地媒体音量会恢复到闪避前的音量水平。 | | [enableVocalInstrumentBalance](70080#RTCEngine-enablevocalinstrumentbalance) | 开启/关闭音量均衡功能。

开启音量均衡功能后，人声的响度会调整为 -16lufs。如果已调用 setAudioMixingLoudness 传入了混音音乐的原始响度，此音乐播放时，响度会调整为 -20lufs。 | | [setPlaybackVolume](70080#RTCEngine-setplaybackvolume) | 调节本地播放的所有远端用户音频混音后的音量，混音内容包括远端人声、音乐、音效等。

播放音频前或播放音频时，你都可以使用此接口设定播放音量。 | | [setScreenCaptureVolume](70080#RTCEngine-setscreencapturevolume) | 调节屏幕共享时采集的音频音量。

只改变音频数据的音量信息，不影响麦克风采集的音量，也不会改变本端音频设备本身的音量。 | | [setCaptureVolume](70080#RTCEngine-setcapturevolume) | 调节音频采集音量 | | [muteScreenAudioCapture](70080#RTCEngine-mutescreenaudiocapture) | 静音/取消静音屏幕共享时采集的音频。

调用此方法后，SDK 将发送静音数据来代替真实的屏幕音频数据，不影响本端音频设备的采集状态和 SDK 音频流的采集发布状态。 | | [muteAudioCapture](70080#RTCEngine-muteaudiocapture) | 设置是否将采集到的音频信号静音，而不影响改变本端硬件采集状态。 | | [enableExternalSoundCard](70080#RTCEngine-enableexternalsoundcard) | 启用匹配外置声卡的音频处理模式 | | [setDefaultAudioRoute](70080#RTCEngine-setdefaultaudioroute) | 将默认的音频播放设备设置为听筒或扬声器。 | | [getAudioRoute](70080#RTCEngine-getaudioroute) | 获取当前使用的音频播放路由。 | | [setAudioRoute](70080#RTCEngine-setaudioroute) | 强制切换当前的音频播放路由。默认使用 [setDefaultAudioRoute](70080#RTCEngine-setdefaultaudioroute) 中设置的音频路由。

音频播放路由发生变化时，会收到 [onAudioRouteChanged](70081#IRTCEngineEventHandler-onaudioroutechanged) 回调。 | | [setAudioProfile](70080#RTCEngine-setaudioprofile) | 设置音质档位。

当所选的 [ChannelProfile](70083#ChannelProfile) 中的音频参数无法满足你的场景需求时，调用本接口切换的音质档位。 | | [setAudioScenario](70080#RTCEngine-setaudioscenario) | 设置音频场景类型。

选择音频场景后，SDK 会自动根据场景切换对应的音量模式（通话音量/媒体音量）和改场景下的最佳音频配置。
| | [stopAudioCapture](70080#RTCEngine-stopaudiocapture) | 立即关闭内部音频采集。默认为关闭状态。

内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。

调用该方法，本地用户会收到 [onAudioDeviceStateChanged](70081#IRTCEngineEventHandler-onaudiodevicestatechanged) 的回调。

非隐身用户进房后调用该方法，房间中的其他用户会收到 [onUserStopAudioCapture](70081#IRTCEngineEventHandler-onuserstopaudiocapture) 的回调。 | | [startAudioCapture](70080#RTCEngine-startaudiocapture) | 开启内部音频采集。默认为关闭状态。

内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。

调用该方法开启后，本地用户会收到 [onAudioDeviceStateChanged](70081#IRTCEngineEventHandler-onaudiodevicestatechanged) 的回调。

非隐身用户进房后调用该方法，房间中的其他用户会收到 [onUserStartAudioCapture](70081#IRTCEngineEventHandler-onuserstartaudiocapture) 的回调。 | | [getAudioDeviceManager](70080#RTCEngine-getaudiodevicemanager) | 获取音频设备管理接口 | | [setRemoteRoomAudioPlaybackVolume](70080#IGameRoom-setremoteroomaudioplaybackvolume) | 调节某个游戏房间内所有远端用户的音频播放音量（非系统硬件音量）。 | | [enableAudioReceive](70080#IGameRoom-enableaudioreceive) | 是否接收某个特定用户的音频流。关闭声音接收不会影响扬声器或其他音频输出设备的状态。 | | [enableAudioSend](70080#IGameRoom-enableaudiosend) | 加入游戏房间后，开始或停止发送音频流。调用此接口不影响音频采集。同房间其他用户会收到相应的回调。 | | [enableSpeakerphone](70080#IGameRoom-enablespeakerphone) | 加入游戏房间后，开启或关闭扬声器。 | | [enableMicrophone](70080#IGameRoom-enablemicrophone) | 加入游戏房间后，调用该接口开启或关闭麦克风。同房间其他用户会收到回调 [OnAudioDeviceStateChanged](70081#IRTCEngineEventHandler-onaudiodevicestatechanged)。 | | [setAudioSelectionConfig](70080#RTCRoom-setaudioselectionconfig) | 设置本端发布流在音频选路中的优先级。 | | [setRemoteRoomAudioPlaybackVolume](70080#RTCRoom-setremoteroomaudioplaybackvolume) | 调节某个房间内所有远端用户的音频播放音量。 | | [stopAudioDevicePlayTest](70080#IRTCAudioDeviceManager-stopaudiodeviceplaytest) | 停止由调用 [startAudioDeviceRecordTest](70080#IRTCAudioDeviceManager-startaudiodevicerecordtest) 开始的音频播放设备测试。

在音频播放设备测试自动结束前，可调用本接口停止音频采集与播放测试。 | | [stopAudioDeviceRecordAndPlayTest](70080#IRTCAudioDeviceManager-stopaudiodevicerecordandplaytest) | 停止采集本地音频，并开始播放采集到的声音。录音播放完毕后，设备测试流程结束。

调用 [startAudioDeviceRecordTest](70080#IRTCAudioDeviceManager-startaudiodevicerecordtest) 30 s 内调用本接口来停止采集并开始播放此前采集到的声音。 | | [startAudioDeviceRecordTest](70080#IRTCAudioDeviceManager-startaudiodevicerecordtest) | 开始音频采集设备和音频播放设备测试。 | | [stopAudioPlaybackDeviceTest](70080#IRTCAudioDeviceManager-stopaudioplaybackdevicetest) | 停止音频播放测试。 | | 回调 | 描述 | | --- | --- | | [onAudioStreamBanned](70081#IRTCRoomEventHandler-onaudiostreambanned) | 通过调用服务端 BanUserStream/UnbanUserStream 方法禁用/解禁指定房间内指定用户音频流的发送时，触发此回调。 | | [onStreamSyncInfoReceived](70081#IRTCEngineEventHandler-onstreamsyncinforeceived) | 音频流同步信息回调。可以通过此回调，在远端用户调用 [sendStreamSyncInfo](70080#RTCEngine-sendstreamsyncinfo) 发送音频流同步消息后，收到远端发送的音频流同步信息。 | | [onHardwareEchoDetectionResult](70081#IRTCEngineEventHandler-onhardwareechodetectionresult) | 通话前回声检测结果回调。 | | [onActiveSpeaker](70081#IRTCEngineEventHandler-onactivespeaker) | 调用 [enableAudioPropertiesReport](70080#RTCEngine-enableaudiopropertiesreport) 后，根据设置的 `AudioPropertiesConfig.interval`，你会周期性地收到此回调，获取房间内的最活跃用户信息。 | | [onRemoteAudioPropertiesReport](70081#IRTCEngineEventHandler-onremoteaudiopropertiesreport) | 远端用户进房后，本地调用 [enableAudioPropertiesReport](70080#RTCEngine-enableaudiopropertiesreport) ，根据设置的 interval 值，本地会周期性地收到此回调，了解订阅的远端用户的瞬时音频信息。

远端用户的音频包括使用 RTC SDK 内部机制/自定义机制采集的麦克风音频和屏幕音频。 | | [onAudioPlaybackDeviceTestVolume](70081#IRTCEngineEventHandler-onaudioplaybackdevicetestvolume) | 回调音频设备测试时的播放音量 | | [onLocalAudioPropertiesReport](70081#IRTCEngineEventHandler-onlocalaudiopropertiesreport) | 调用 [enableAudioPropertiesReport](70080#RTCEngine-enableaudiopropertiesreport) 后，你会周期性地收到此回调，了解本地音频的瞬时相关信息。

本地音频包括使用 RTC SDK 内部机制采集的麦克风音频，屏幕音频和本地混音音频信息。 | | [onAudioDeviceWarning](70081#IRTCEngineEventHandler-onaudiodevicewarning) | 音频设备警告回调。音频设备包括音频采集设备、音频渲染设备等。 | | [onAudioDeviceStateChanged](70081#IRTCEngineEventHandler-onaudiodevicestatechanged) | 音频设备状态回调。提示音频采集、音频播放等媒体设备的状态。 | | [onAudioRouteChanged](70081#IRTCEngineEventHandler-onaudioroutechanged) | 音频播放路由变化时，收到该回调。 | | [onLocalAudioStateChanged](70081#IRTCEngineEventHandler-onlocalaudiostatechanged) | 本地音频流的状态发生改变时，收到此回调。 | | [onUserStopAudioCapture](70081#IRTCEngineEventHandler-onuserstopaudiocapture) | 房间内的用户调用 [stopAudioCapture](70080#RTCEngine-stopaudiocapture) 关闭音频采集时，房间内其他用户会收到此回调。 | | [onUserStartAudioCapture](70081#IRTCEngineEventHandler-onuserstartaudiocapture) | 房间内的用户调用 [startAudioCapture](70080#RTCEngine-startaudiocapture) 开启音频采集时，房间内其他用户会收到此回调。 | ## 视频管理 | 方法 | 描述 | | --- | --- | | [enumerateVideoCaptureDevices](70080#IVideoDeviceManager-enumeratevideocapturedevices) | 获取当前系统内视频采集设备列表。 | | [updateRemoteStreamVideoCanvas](70080#RTCEngine-updateremotestreamvideocanvas) | 修改远端视频帧的渲染设置，包括渲染模式和背景颜色。 | | [getVideoDeviceManager](70080#RTCEngine-getvideodevicemanager) | 创建视频设备管理实例 | | [setRemoteVideoCanvas](70080#RTCEngine-setremotevideocanvas) | 渲染来自指定远端用户的视频流时，设置使用的视图和渲染模式。

要解除绑定，将 `videoCanvas` 设置为空。 | | [updateRemoteStreamVideoCanvas](70080#RTCEngine-updateremotestreamvideocanvas-2) | 使用 SDK 内部渲染时，修改远端视频帧的渲染设置，包括渲染模式、背景颜色和旋转角度。 | | [disableAlphaChannelVideoEncode](70080#RTCEngine-disablealphachannelvideoencode) | 关闭外部采集视频帧的 Alpha 通道编码功能。 | | [enableAlphaChannelVideoEncode](70080#RTCEngine-enablealphachannelvideoencode) | 开启自定义采集视频帧的 Alpha 通道编码功能。

适用于需要分离推流端视频主体与背景，且在拉流端可自定义渲染背景的场景。 | | [setCameraAdaptiveMinimumFrameRate](70080#RTCEngine-setcameraadaptiveminimumframerate) | 设置内部采集适用动态帧率时，帧率的最小值。 | | [enableCameraAutoExposureFaceMode](70080#RTCEngine-enablecameraautoexposurefacemode) | 启用或禁用内部采集时人脸自动曝光模式。此模式会改善强逆光下，脸部过暗的问题；但也会导致 ROI 以外区域过亮/过暗的问题。 | | [setCameraExposureCompensation](70080#RTCEngine-setcameraexposurecompensation) | 设置当前使用的摄像头的曝光补偿。 | | [setCameraExposurePosition](70080#RTCEngine-setcameraexposureposition) | 设置当前使用的摄像头的曝光点 | | [isCameraExposurePositionSupported](70080#RTCEngine-iscameraexposurepositionsupported) | 检查当前使用的摄像头是否支持手动设置曝光点。 | | [setCameraFocusPosition](70080#RTCEngine-setcamerafocusposition) | 设置当前使用的摄像头的对焦点。 | | [isCameraFocusPositionSupported](70080#RTCEngine-iscamerafocuspositionsupported) | 检查当前使用的摄像头是否支持手动对焦。 | | [setCameraTorch](70080#RTCEngine-setcameratorch) | 打开/关闭当前使用的摄像头（前置/后置）的闪光灯 | | [getCameraZoomMaxRatio](70080#RTCEngine-getcamerazoommaxratio) | 获取当前使用的摄像头（前置/后置）的最大变焦倍数 | | [setCameraZoomRatio](70080#RTCEngine-setcamerazoomratio) | 设置当前使用的摄像头（前置/后置）的光学变焦倍数 | | [isCameraZoomSupported](70080#RTCEngine-iscamerazoomsupported) | 检测当前使用的摄像头（前置/后置），是否支持变焦（数码/光学变焦）。 | | [isCameraTorchSupported](70080#RTCEngine-iscameratorchsupported) | 检测当前使用的摄像头（前置/后置），是否支持闪光灯。 | | [setVideoEncoderConfig](70080#RTCEngine-setvideoencoderconfig) | 视频发布端设置期望发布的最大分辨率视频流参数，包括分辨率、帧率、码率、网络不佳时的回退策略等（包含摄像头和屏幕的编码配置）。 | | [setVideoCaptureConfig](70080#RTCEngine-setvideocaptureconfig) | 设置 RTC SDK 内部采集时的视频采集参数。

如果你的项目使用了 SDK 内部采集模块，可以通过本接口指定视频采集参数包括模式、分辨率、帧率。 | | [switchCamera](70080#RTCEngine-switchcamera) | 切换视频内部采集时使用的前置/后置摄像头

调用此接口后，在本地会触发 [onVideoDeviceStateChanged](70081#IRTCEngineEventHandler-onvideodevicestatechanged) 回调。 | | [setVideoRotationMode](70080#RTCEngine-setvideorotationmode) | 设置采集视频的旋转模式。默认以 App 方向为旋转参考系。

接收端渲染视频时，将按照和发送端相同的方式进行旋转。 | | [updateLocalVideoCanvas](70080#RTCEngine-updatelocalvideocanvas) | 修改本地视频渲染模式和背景色。 | | [setLocalVideoCanvas](70080#RTCEngine-setlocalvideocanvas) | 设置本地视频渲染时使用的视图，并设置渲染模式。 | | [stopVideoCapture](70080#RTCEngine-stopvideocapture) | 立即关闭内部视频采集。默认为关闭状态。

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

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

非隐身用户进房后调用该方法，房间中的其他用户会收到 [onUserStopVideoCapture](70081#IRTCEngineEventHandler-onuserstopvideocapture) 的回调。 | | [startVideoCapture](70080#RTCEngine-startvideocapture) | 立即开启内部视频采集。默认为关闭状态。

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

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

本地用户在非隐身状态下调用该方法后，房间中的其他用户会收到 [onUserStartVideoCapture](70081#IRTCEngineEventHandler-onuserstartvideocapture) 的回调。 | | [setRemoteVideoConfig](70080#RTCRoom-setremotevideoconfig) | 设置期望订阅的远端视频流的参数。 | | [setRemoteSimulcastStreamType](70080#RTCRoom-setremotesimulcaststreamtype) | 设置期望订阅的远端视频流类型。比如大流、中流、小流等。 | | [setVideoCaptureDevice](70080#IVideoDeviceManager-setvideocapturedevice) | 设置当前视频采集设备 | | 回调 | 描述 | | --- | --- | | [onUserStartVideoCapture](70081#IRTCEngineEventHandler-onuserstartvideocapture) | 房间内的可见用户调用 [startVideoCapture](70080#RTCEngine-startvideocapture) 开启内部视频采集时，房间内其他用户会收到此回调。 | | [onFaceDetectResult](70081#IFaceDetectionObserver-onfacedetectresult) | 特效 SDK 进行人脸检测结果的回调。

调用 [enableFaceDetection](70080#IVideoEffect-enablefacedetection) 注册了 [IFaceDetectionObserver](70081#IFaceDetectionObserver)，并使用 RTC SDK 中包含的特效 SDK 进行视频特效处理时，你会收到此回调。 | | [onVideoDeviceWarning](70081#IRTCEngineEventHandler-onvideodevicewarning) | 视频设备警告回调，包括视频采集等设备。 | | [onVideoDeviceStateChanged](70081#IRTCEngineEventHandler-onvideodevicestatechanged) | 视频设备状态回调。提示摄像头视频采集、屏幕视频采集等媒体设备的状态。 | | [onLocalVideoStateChanged](70081#IRTCEngineEventHandler-onlocalvideostatechanged) | 本地视频流的状态发生改变时，收到该事件。 | | [onUserStopVideoCapture](70081#IRTCEngineEventHandler-onuserstopvideocapture) | 房间内的可见用户调用 [stopVideoCapture](70080#RTCEngine-stopvideocapture) 关闭内部视频采集时，房间内其他用户会收到此回调。

若发布视频数据前未开启采集，房间内所有可见用户会收到此回调。 | ## 音视频传输 | 方法 | 描述 | | --- | --- | | [publishStreamAudio](70080#RTCRoom-publishstreamaudio) | 发布/取消发布音频流。 | | [setMultiDeviceAVSync](70080#RTCRoom-setmultideviceavsync) | 设置发流端音画同步。

当同一用户同时使用两个通话设备分别采集发送音频和视频时，有可能会因两个设备所处的网络环境不一致而导致发布的流不同步，此时你可以在视频发送端调用该接口，SDK 会根据音频流的时间戳自动校准视频流，以保证接收端听到音频和看到视频在时间上的同步性。 | | [requestRemoteVideoKeyFrame](70080#RTCEngine-requestremotevideokeyframe) | 在订阅远端视频流之后，向远端请求关键帧 | | [setDummyCaptureImagePath](70080#RTCEngine-setdummycaptureimagepath) | 摄像头处于关闭状态时，使用静态图片填充本地推送的视频流。

调用 `stopVideoCapture` 接口时，会开始推静态图片。若要停止发送图片，可传入空字符串或启用内部摄像头采集。

可重复调用该接口来更新图片。 | | [setStreamExtraInfo](70080#RTCRoom-setstreamextrainfo) | 设置当前推流的流附加信息。 | | [resumeForwardStreamToAllRooms](70080#RTCRoom-resumeforwardstreamtoallrooms) | 恢复跨房间媒体流转发。

调用 [pauseForwardStreamToAllRooms](70080#RTCRoom-pauseforwardstreamtoallrooms) 暂停转发之后，调用本方法恢复向所有目标房间转发媒体流。 | | [pauseForwardStreamToAllRooms](70080#RTCRoom-pauseforwardstreamtoallrooms) | 暂停跨房间媒体流转发。

通过 [startForwardStreamToRooms](70080#RTCRoom-startforwardstreamtorooms) 发起媒体流转发后，可调用本方法暂停向所有目标房间转发媒体流。

调用本方法暂停向所有目标房间转发后，你可以随时调用 [resumeForwardStreamToAllRooms](70080#RTCRoom-resumeforwardstreamtoallrooms) 快速恢复转发。 | | [stopForwardStreamToRooms](70080#RTCRoom-stopforwardstreamtorooms) | 停止跨房间媒体流转发。

通过 [startForwardStreamToRooms](70080#RTCRoom-startforwardstreamtorooms) 发起媒体流转发后，可调用本方法停止向所有目标房间转发媒体流。 | | [updateForwardStreamToRooms](70080#RTCRoom-updateforwardstreamtorooms) | 更新跨房间媒体流转发信息。

通过 [startForwardStreamToRooms](70080#RTCRoom-startforwardstreamtorooms) 发起媒体流转发后，可调用本方法增加或者减少目标房间，或更新房间密钥。

调用本方法增加或删减房间后，将在本端触发 [onForwardStreamStateChanged](70081#IRTCRoomEventHandler-onforwardstreamstatechanged) 回调，包含发生了变动的目标房间中媒体流转发状态。 | | [startForwardStreamToRooms](70080#RTCRoom-startforwardstreamtorooms) | 开始跨房间转发媒体流。

在调用 [joinRoom](70080#RTCRoom-joinroom) 后调用本接口，实现向多个房间转发媒体流，适用于跨房间连麦等场景。 | | [resumeAllSubscribedStreamAudio](70080#RTCRoom-resumeallsubscribedstreamaudio) | 恢复接收所有远端音频流。 | | [resumeAllSubscribedStreamVideo](70080#RTCRoom-resumeallsubscribedstreamvideo) | 恢复接收所有远端视频流。 | | [pauseAllSubscribedStreamAudio](70080#RTCRoom-pauseallsubscribedstreamaudio) | 暂停接收所有远端音频流。 | | [pauseAllSubscribedStreamVideo](70080#RTCRoom-pauseallsubscribedstreamvideo) | 暂停接收所有远端视频流。 | | [subscribeStreamAudio](70080#RTCRoom-subscribestreamaudio) | 订阅/取消订阅房间内指定的远端音频流。 | | [subscribeStreamVideo](70080#RTCRoom-subscribestreamvideo) | 订阅/取消订阅房间内指定的远端视频流。 | | [publishStreamVideo](70080#RTCRoom-publishstreamvideo) | 发布/取消发布视频流。 | | [subscribeAllStreamsVideo](70080#RTCRoom-subscribeallstreamsvideo) | 订阅/取消订阅房间内所有远端视频流（通过摄像头采集的）。 | | [subscribeAllStreamsAudio](70080#RTCRoom-subscribeallstreamsaudio) | 订阅或取消订阅所有远端音频流（通过麦克风采集的）。 | | 回调 | 描述 | | --- | --- | | [onVideoPublishStateChanged](70081#IRTCRoomEventHandler-onvideopublishstatechanged) | 视频发布状态改变回调。 | | [onAudioSubscribeStateChanged](70081#IRTCRoomEventHandler-onaudiosubscribestatechanged) | 音频订阅状态发生改变回调。 | | [onPushPublicStreamResult](70081#IRTCEngineEventHandler-onpushpublicstreamresult) | WTN 流发布结果回调。

调用 [startPushMixedStream](70080#RTCEngine-startpushmixedstream) 接口发布WTN 流后，启动结果通过此回调方法通知用户。 | | [onSimulcastSubscribeFallback](70081#IRTCEngineEventHandler-onsimulcastsubscribefallback) | 音视频流因网络环境变化等原因发生回退，或从回退中恢复时，触发该回调。 | | [onVideoFramePlayStateChanged](70081#IRTCEngineEventHandler-onvideoframeplaystatechanged) | 远端视频流的首帧播放状态改变时，收到此回调。 | | [onAudioFramePlayStateChanged](70081#IRTCEngineEventHandler-onaudioframeplaystatechanged) | 音频首帧播放状态发生改变时，收到此回调。 | | [onVideoFrameSendStateChanged](70081#IRTCEngineEventHandler-onvideoframesendstatechanged) | 视频首帧发送状态发生改变时，收到此回调。 | | [onAudioFrameSendStateChanged](70081#IRTCEngineEventHandler-onaudioframesendstatechanged) | 本地音频首帧发送状态发生改变时，收到此回调。 | | [onFirstRemoteAudioFrame](70081#IRTCEngineEventHandler-onfirstremoteaudioframe) | 订阅端接收并解码远端音频流首帧时，收到此回调。包含以下情况：

发布端发布音频，包含首次发布和取消后再次发布。
发布端关闭音频采集后，再次打开采集。使用外部源时，停止推流后再次推流。
发布端发布音频后，订阅端取消订阅音频后，又再次订阅音频。

| | [onFirstLocalAudioFrame](70081#IRTCEngineEventHandler-onfirstlocalaudioframe) | 发布音频流时，采集到第一帧音频帧，收到该回调。 | | [onRemoteVideoSizeChanged](70081#IRTCEngineEventHandler-onremotevideosizechanged) | 远端视频大小或旋转信息发生改变时，房间内订阅此视频流的用户会收到此回调。 | | [onLocalVideoSizeChanged](70081#IRTCEngineEventHandler-onlocalvideosizechanged) | 本地预览视频大小或旋转信息发生改变时，收到此回调。 | | [onFirstLocalVideoFrameCaptured](70081#IRTCEngineEventHandler-onfirstlocalvideoframecaptured) | RTC SDK 在本地完成第一帧视频帧或屏幕视频帧采集时，收到此回调。 | | [onFirstRemoteVideoFrameDecoded](70081#IRTCEngineEventHandler-onfirstremotevideoframedecoded) | 订阅端接收并解码远端视频流首帧时，收到此回调。包含以下情况：

发布端发布视频，包含首次发布和取消后再次发布。
发布端关闭视频采集后，再次打开采集。使用外部源时，停止推流后再次推流。
发布端发布视频后，订阅端取消订阅视频后，又再次订阅视频。

| | [onFirstRemoteVideoFrameRendered](70081#IRTCEngineEventHandler-onfirstremotevideoframerendered) | SDK 内部渲染成功远端视频流首帧后，收到此回调。包含以下情况：

发布端首次发布视频
在 1 条件下，发布端取消发布视频后，再次发布视频
在 1 条件下，发布端关闭视频采集后，再次打开采集（或使用外部源时，停止推流后再次推流）
在 1 条件下，订阅端取消订阅视频后，再次订阅视频（调用接口包括 [subscribeAllStreamsVideo](70080#RTCRoom-subscribeallstreamsvideo)，[pauseAllSubscribedStreamVideo](70080#RTCRoom-pauseallsubscribedstreamvideo)。

| | [onRemoteVideoStateChanged](70081#IRTCEngineEventHandler-onremotevideostatechanged) | 远端视频流的状态发生改变时，房间内订阅此流的用户会收到该事件。 | | [onRemoteAudioStateChanged](70081#IRTCEngineEventHandler-onremoteaudiostatechanged) | 用户订阅来自远端的音频流状态发生改变时，会收到此回调，了解当前的远端音频流状态。 | | [onNetworkQuality](70081#IRTCRoomEventHandler-onnetworkquality) | 加入房间并发布或订阅流后，以每 2 秒一次的频率，报告本地用户和已订阅的远端用户的上下行网络质量信息。 | | [onForwardStreamEvent](70081#IRTCRoomEventHandler-onforwardstreamevent) | 跨房间媒体流转发事件回调 | | [onForwardStreamStateChanged](70081#IRTCRoomEventHandler-onforwardstreamstatechanged) | 跨房间媒体流转发状态和错误回调 | | [onVideoStreamBanned](70081#IRTCRoomEventHandler-onvideostreambanned) | 通过调用服务端 BanUserStream/UnbanUserStream 方法禁用/解禁指定房间内指定用户视频流的发送时，触发此回调。 | | [onUserPublishStreamAudio](70081#IRTCRoomEventHandler-onuserpublishstreamaudio) | 房间内远端用户发布或取消发布音频流的回调。 | | [onUserPublishStreamVideo](70081#IRTCRoomEventHandler-onuserpublishstreamvideo) | 房间内远端用户发布或取消发布视频流的回调。 | | [onAVSyncEvent](70081#IRTCRoomEventHandler-onavsyncevent) | 发布端调用 [setMultiDeviceAVSync](70080#RTCRoom-setmultideviceavsync) 后音视频同步状态发生错误时，会收到此回调。 | | [onStreamSubscribed](70081#IRTCRoomEventHandler-onstreamsubscribed) | 关于订阅媒体流状态改变的回调 | | [onRemoteStreamStats](70081#IRTCRoomEventHandler-onremotestreamstats) | 本地订阅的远端音/视频流数据统计以及网络质量回调。

本地用户订阅流成功后，SDK 会周期性（2s）的通过此回调事件通知用户订阅的流在此次统计周期内的质量统计信息，包括：发送音视频比特率、发送帧率、编码帧率，网络质量等。 | | [onLocalStreamStats](70081#IRTCRoomEventHandler-onlocalstreamstats) | 本地流数据统计以及网络质量回调。

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

统计信息通过 [LocalStreamStats](70083#LocalStreamStats) 类型的回调参数传递给用户，其中包括发送音视频比特率、发送帧率、编码帧率，网络质量等。 | | [onVideoSubscribeStateChanged](70081#IRTCRoomEventHandler-onvideosubscribestatechanged) | 视频订阅状态发生改变回调。 | | [onAudioPublishStateChanged](70081#IRTCRoomEventHandler-onaudiopublishstatechanged) | 音频发布状态改变回调。 | | [onStreamStateChanged](70081#IRTCRoomEventHandler-onstreamstatechanged) | 流状态改变回调，发生流相关的警告或错误时会收到此回调。 | | [onAVSyncStateChange](70081#IRTCRoomEventHandler-onavsyncstatechange) | 发布端调用 [setMultiDeviceAVSync](70080#RTCRoom-setmultideviceavsync) 后音视频同步状态发生改变时，会收到此回调。 | ## 音频处理 | 方法 | 描述 | | --- | --- | | [setVoiceChangerType](70080#RTCEngine-setvoicechangertype) | 设置变声特效类型 | | [setLocalVoicePitch](70080#RTCEngine-setlocalvoicepitch) | 开启本地语音变调功能，多用于 K 歌场景。

使用该方法，你可以对本地语音的音调进行升调或降调等调整。 | | [enableLocalVoiceReverb](70080#RTCEngine-enablelocalvoicereverb) | 开启本地音效混响效果 | | [setLocalVoiceReverbParam](70080#RTCEngine-setlocalvoicereverbparam) | 设置本地采集音频的混响效果。包含内部采集和外部采集，但不包含混音音频文件。 | | [setLocalVoiceEqualization](70080#RTCEngine-setlocalvoiceequalization) | 设置本地采集语音的均衡效果。包含内部采集和外部采集，但不包含混音音频文件。 | | [setVoiceReverbType](70080#RTCEngine-setvoicereverbtype) | 设置混响特效类型 | ## 视频处理 | 方法 | 描述 | | --- | --- | | [initCVResource](70080#IVideoEffect-initcvresource) | 检查视频特效证书，设置算法模型路径，并初始化特效模块。 | | [clearVideoWatermark](70080#RTCEngine-clearvideowatermark) | 移除指定视频流的水印。 | | [setVideoWatermark](70080#RTCEngine-setvideowatermark) | 在指定视频流上添加水印。 | | [setVideoOrientation](70080#RTCEngine-setvideoorientation) | 在自定义视频前处理及编码前，设置 RTC 链路中的视频帧朝向，默认为 Adaptive 模式。

移动端开启视频特效贴纸，或使用自定义视频前处理时，建议固定视频帧朝向为 Portrait 模式。单流转推场景下，建议根据业务需要固定视频帧朝向为 Portrait 或 Landscape 模式。不同模式的具体显示效果参看[视频帧朝向](https://www.volcengine.com/docs/6348/128787)。 | | [setBeautyIntensity](70080#RTCEngine-setbeautyintensity) | 调整基础美颜强度 | | [enableEffectBeauty](70080#RTCEngine-enableeffectbeauty) | 开启/关闭基础美颜。 | | [getVideoEffectInterface](70080#RTCEngine-getvideoeffectinterface) | 获取视频特效接口。 | | [stopVideoDigitalZoomControl](70080#RTCEngine-stopvideodigitalzoomcontrol) | 停止本地摄像头持续数码变焦。 | | [startVideoDigitalZoomControl](70080#RTCEngine-startvideodigitalzoomcontrol) | 开启本地摄像头持续数码变焦，缩放或移动。设置对本地预览画面和发布到远端的视频都生效。 | | [setVideoDigitalZoomControl](70080#RTCEngine-setvideodigitalzoomcontrol) | 控制本地摄像头数码变焦，缩放或移动一次。设置对本地预览画面和发布到远端的视频都生效。 | | [setVideoDigitalZoomConfig](70080#RTCEngine-setvideodigitalzoomconfig) | 设置本地摄像头数码变焦参数，包括缩放倍数，移动步长。 | | [setRemoteVideoMirrorType](70080#RTCEngine-setremotevideomirrortype) | 使用内部渲染时，为远端流开启镜像。 | | [setLocalVideoMirrorType](70080#RTCEngine-setlocalvideomirrortype) | 为采集到的视频流开启镜像 | | [disableFaceDetection](70080#IVideoEffect-disablefacedetection) | 关闭人脸识别功能。 | | [enableFaceDetection](70080#IVideoEffect-enablefacedetection) | 开启人脸识别功能，并设置人脸检测结果回调观察者。

此观察者后，你会周期性收到 [onFaceDetectResult](70081#IFaceDetectionObserver-onfacedetectresult) 回调。 | | [disableVirtualBackground](70080#IVideoEffect-disablevirtualbackground) | 关闭虚拟背景。 | | [enableVirtualBackground](70080#IVideoEffect-enablevirtualbackground) | 将摄像头采集画面中的人像背景替换为指定图片或纯色背景。 | | [setColorFilterIntensity](70080#IVideoEffect-setcolorfilterintensity) | 设置已启用颜色滤镜的强度。 | | [setColorFilter](70080#IVideoEffect-setcolorfilter) | 设置颜色滤镜。 | | [updateEffectNode](70080#IVideoEffect-updateeffectnode) | 设置特效强度。 | | [setEffectNodes](70080#IVideoEffect-seteffectnodes) | 设置视频特效素材包。 | | [disableVideoEffect](70080#IVideoEffect-disablevideoeffect) | 关闭视频特效。 | | [enableVideoEffect](70080#IVideoEffect-enablevideoeffect) | 开启高级美颜、滤镜等视频特效。 | | [getAuthMessage](70080#IVideoEffect-getauthmessage) | 从特效 SDK 获取授权消息，用于获取在线许可证。 | ## 自定义流处理 | 方法 | 描述 | | --- | --- | | [processVideoFrame](70080#IVideoProcessor-processvideoframe) | 获取 RTC SDK 采集得到的视频帧，根据 [registerLocalVideoProcessor](70080#RTCEngine-registerlocalvideoprocessor) 设置的视频前处理器，进行视频前处理，最终将处理后的视频帧给到 RTC SDK 用于编码传输。 | | [setRemoteVideoSink](70080#RTCEngine-setremotevideosink) | 将远端视频流与自定义渲染器绑定。 | | [setLocalVideoSink](70080#RTCEngine-setlocalvideosink) | 将本地视频流与自定义渲染器绑定。 | | [setVideoDecoderConfig](70080#RTCEngine-setvideodecoderconfig) | 在订阅远端视频流之前，设置远端视频数据解码方式 | | [pushExternalEncodedVideoFrame](70080#RTCEngine-pushexternalencodedvideoframe) | 推送自定义编码后的视频流 | | [setExternalVideoEncoderEventHandler](70080#RTCEngine-setexternalvideoencodereventhandler) | 注册自定义编码帧推送事件回调 | | [setRemoteVideoSink](70080#RTCEngine-setremotevideosink-2) | 将远端视频流与自定义渲染器绑定。你可以通过参数设置返回指定位置和格式的视频帧数据。 | | [pushReferenceAudioPCMData](70080#RTCEngine-pushreferenceaudiopcmdata) | 向 SDK 发送由自定义处理后的 PCM 音频数据，作为回声消除的参考信号 | | [pullExternalAudioFrame](70080#RTCEngine-pullexternalaudioframe) | 拉取下行音频数据用于自定义音频渲染。

调用该方法后，SDK 会主动拉取待播放的音频数据，包括远端已解码和混音后的音频数据，用于外部播放。 | | [pushExternalAudioFrame](70080#RTCEngine-pushexternalaudioframe) | 推送自定义采集的音频数据到 RTC SDK。 | | [setAudioRenderType](70080#RTCEngine-setaudiorendertype) | 切换音频渲染方式 | | [setAudioSourceType](70080#RTCEngine-setaudiosourcetype) | 切换音频采集方式 | | [pushExternalVideoFrame](70080#RTCEngine-pushexternalvideoframe) | 推送外部视频帧。 | | [setVideoSourceType](70080#RTCEngine-setvideosourcetype) | 设置向 SDK 输入的视频源，包括屏幕流

默认使用内部采集。内部采集指：使用 RTC SDK 内置的视频采集机制进行视频采集。 | | [registerRemoteEncodedVideoFrameObserver](70080#RTCEngine-registerremoteencodedvideoframeobserver) | 注册远端编码后视频数据回调。

完成注册后，当 SDK 监测到远端编码后视频帧时，会触发 [onRemoteEncodedVideoFrame](70081#IRemoteEncodedVideoFrameObserver-onremoteencodedvideoframe) 回调 | | [registerLocalEncodedVideoFrameObserver](70080#RTCEngine-registerlocalencodedvideoframeobserver) | 注册本地视频帧监测器。

无论使用内部采集还是自定义采集，调用该方法后，SDK 每监测到一帧本地视频帧时，都会将视频帧信息通过 [onLocalEncodedVideoFrame](70081#ILocalEncodedVideoFrameObserver-onlocalencodedvideoframe) 回调给用户。 | | [registerLocalVideoProcessor](70080#RTCEngine-registerlocalvideoprocessor) | 设置自定义视频前处理器。

使用这个视频前处理器，你能够调用 [processVideoFrame](70080#IVideoProcessor-processvideoframe) 对 RTC SDK 采集得到的视频帧进行前处理，并将处理后的视频帧用于 RTC 音视频通信。 | | [disableAudioProcessor](70080#RTCEngine-disableaudioprocessor) | 关闭自定义音频处理。 | | [enableAudioProcessor](70080#RTCEngine-enableaudioprocessor) | 设置并开启指定的音频帧回调，进行自定义处理。 | | [registerAudioProcessor](70080#RTCEngine-registeraudioprocessor) | 注册自定义音频处理器。

注册完成后，你可以调用 [enableAudioProcessor](70080#RTCEngine-enableaudioprocessor)，对本地采集到的音频进行处理，RTC SDK 将对处理后的音频进行编码和发送。也可以对接收到的远端音频进行自定义处理，RTC SDK 将对处理后的音频进行渲染。 | | [registerAudioFrameObserver](70080#RTCEngine-registeraudioframeobserver) | 注册音频数据回调观察者。 | | [disableAudioFrameCallback](70080#RTCEngine-disableaudioframecallback) | 关闭音频回调 | | [enableAudioFrameCallback](70080#RTCEngine-enableaudioframecallback) | 设置并开启指定的音频数据帧回调 | | [setLocalVideoSink](70080#RTCEngine-setlocalvideosink-2) | 将本地视频流与自定义渲染器绑定。你可以通过参数设置返回指定位置和格式的视频帧数据。 | | 回调 | 描述 | | --- | --- | | [onRemoteEncodedVideoFrame](70081#IRemoteEncodedVideoFrameObserver-onremoteencodedvideoframe) | 调用 [registerRemoteEncodedVideoFrameObserver](70080#RTCEngine-registerremoteencodedvideoframeobserver) 后，SDK 监测到远端编码后视频数据时，触发该回调 | | [onProcessScreenAudioFrame](70081#IAudioFrameProcessor-onprocessscreenaudioframe) | 屏幕共享的音频帧地址回调。你可根据此回调自定义处理音频。 | | [onProcessEarMonitorAudioFrame](70081#IAudioFrameProcessor-onprocessearmonitoraudioframe) | 软件耳返音频数据的回调。你可根据此回调自定义处理音频。

软件耳返音频中包含通过调用 `setVoiceReverbType` 和 `setVoiceChangerType` 设置的音频特效。 | | [onProcessRemoteUserAudioFrame](70081#IAudioFrameProcessor-onprocessremoteuseraudioframe) | 回调单个远端用户的音频帧地址，供自定义音频处理。 | | [onProcessPlayBackAudioFrame](70081#IAudioFrameProcessor-onprocessplaybackaudioframe) | 回调远端音频混音的音频帧地址，供自定义音频处理。 | | [onProcessRecordAudioFrame](70081#IAudioFrameProcessor-onprocessrecordaudioframe) | 回调本地采集的音频帧地址，供自定义音频处理。 | | [onCaptureMixedAudioFrame](70081#IAudioFrameObserver-oncapturemixedaudioframe) | 返回本地麦克风录制的音频数据，本地 `MediaPlayer` / `EffectPlayer` 播放音频文件混音后的音频数据。 | | [onMixedAudioFrame](70081#IAudioFrameObserver-onmixedaudioframe) | 返回本地麦克风录制和订阅的所有远端用户混音后的音频数据 | | [onRemoteUserAudioFrame](70081#IAudioFrameObserver-onremoteuseraudioframe) | 返回远端单个用户的音频数据 | | [onPlaybackAudioFrame](70081#IAudioFrameObserver-onplaybackaudioframe) | 返回订阅的所有远端用户混音后的音频数据。 | | [onRecordAudioFrame](70081#IAudioFrameObserver-onrecordaudioframe) | 返回麦克风录制的音频数据 | | [onActiveVideoLayer](70081#IExternalVideoEncoderEventHandler-onactivevideolayer) | 作为自定义编码视频流的发送端，你会在视频流可发送状态发生变化时，收到此回调。

你可以根据此回调的提示，仅对可发送的视频流进行编码，以降低本端视频编码性能消耗。此回调会根据多个因素综合判断触发，包括：本端设备性能和本端网络性能，以及按需订阅场景下，远端用户是否订阅。 | | [onRequestKeyFrame](70081#IExternalVideoEncoderEventHandler-onrequestkeyframe) | 提示流发布端需重新生成关键帧的回调 | | [onRateUpdate](70081#IExternalVideoEncoderEventHandler-onrateupdate) | 当自定义编码流的帧率或码率发生变化时，触发该回调 | | [onStop](70081#IExternalVideoEncoderEventHandler-onstop) | 当收到该回调时，你需停止向 SDK 推送自定义编码视频帧 | | [onStart](70081#IExternalVideoEncoderEventHandler-onstart) | 提示自定义编码帧可以开始推送的回调。

收到该回调后，你即可调用 [pushExternalEncodedVideoFrame](70080#RTCEngine-pushexternalencodedvideoframe) 向 SDK 推送自定义编码视频帧 | | [onLocalEncodedVideoFrame](70081#ILocalEncodedVideoFrameObserver-onlocalencodedvideoframe) | 调用 [registerLocalEncodedVideoFrameObserver](70080#RTCEngine-registerlocalencodedvideoframeobserver) 后，SDK 每次使用内部采集，采集到一帧视频帧，或收到一帧外部视频帧时，都会回调该事件。 | | [onAudioFileFrame](70081#IAudioFileFrameObserver-onaudiofileframe) | 当本地音频文件混音时，回调播放的音频帧。 | ## 网络管理 | 方法 | 描述 | | --- | --- | | [startNetworkDetection](70080#RTCEngine-startnetworkdetection) | 开启通话前网络探测 | | [setCellularEnhancement](70080#RTCEngine-setcellularenhancement) | 启用蜂窝网络辅助增强，改善通话质量。 | | [getNetworkTimeInfo](70080#RTCEngine-getnetworktimeinfo) | 通过 NTP 协议，获取网络时间。 | | [stopEchoTest](70080#RTCEngine-stopechotest) | 停止音视频回路测试。

调用 [startEchoTest](70080#RTCEngine-startechotest) 开启音视频回路检测后，你必须调用该方法停止检测。 | | [startEchoTest](70080#RTCEngine-startechotest) | 开启音视频回路测试。

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

开始检测后，SDK 会录制你声音或视频。如果你在设置的延时范围内收到了回放，则视为音视频回路测试正常。 | | [setRemoteUserPriority](70080#RTCEngine-setremoteuserpriority) | 设置用户优先级。 | | [setSubscribeFallbackOption](70080#RTCEngine-setsubscribefallbackoption) | 设置订阅的音视频流的回退选项。

你可调用该接口设置网络不佳或设备性能不足时允许订阅流进行降级或只订阅音频流，以保证通话流畅。 | | [setPublishFallbackOption](70080#RTCEngine-setpublishfallbackoption) | 设置发布的音视频流的回退选项。

你可以调用该接口设置网络不佳或设备性能不足时从大流起进行降级处理，以保证通话质量。 | | [setLocalSimulcastMode](70080#RTCEngine-setlocalsimulcastmode-2) | 发布端开启大小流(simulcast)功能。 | | [setLocalSimulcastMode](70080#RTCEngine-setlocalsimulcastmode) | 发布端进行大小流(simulcast)设置。 | | [stopNetworkDetection](70080#RTCEngine-stopnetworkdetection) | 停止通话前网络探测 | | 回调 | 描述 | | --- | --- | | [onNetworkTypeChanged](70081#IRTCEngineEventHandler-onnetworktypechanged) | SDK 当前网络连接类型改变回调。当 SDK 的当前网络连接类型发生改变时回调该事件。 | | [onPerformanceAlarms](70081#IRTCEngineEventHandler-onperformancealarms) | 本地未通过 [setPublishFallbackOption](70080#RTCEngine-setpublishfallbackoption) 开启发布性能回退，检测到设备性能不足时，收到此回调。

本地通过 [setPublishFallbackOption](70080#RTCEngine-setpublishfallbackoption) 开启发布性能回退，因设备性能/网络原因，造成发布性能回退/恢复时，收到此回调。 | | [onNetworkTimeSynchronized](70081#IRTCEngineEventHandler-onnetworktimesynchronized) | 首次调用 [getNetworkTimeInfo](70080#RTCEngine-getnetworktimeinfo) 后，SDK 内部启动网络时间同步，同步完成时会触发此回调。 | | [onEchoTestResult](70081#IRTCEngineEventHandler-onechotestresult) | 关于音视频回路测试结果的回调。 | | [onNetworkDetectionStopped](70081#IRTCEngineEventHandler-onnetworkdetectionstopped) | 通话前网络探测结束

以下情况将停止探测并收到本一次本回调：

当调用 [stopNetworkDetection](70080#RTCEngine-stopnetworkdetection) 接口停止探测后，会收到一次该回调；
当收到远端/本端音频首帧后，停止探测；
当探测超过 3 分钟后，停止探测；
当探测链路断开一定时间之后，停止探测。

| | [onNetworkDetectionResult](70081#IRTCEngineEventHandler-onnetworkdetectionresult) | 通话前网络探测结果。

成功调用 [startNetworkDetection](70080#RTCEngine-startnetworkdetection) 接口开始探测后，会在 3s 内首次收到该回调，之后每 2s 收到一次该回调。 | | [onSEIMessageReceived](70081#IRTCEngineEventHandler-onseimessagereceived) | 收到通过调用 [sendSEIMessage](70080#RTCEngine-sendseimessage) 发送带有 SEI 消息的视频帧时，收到此回调。 | | [onConnectionStateChanged](70081#IRTCEngineEventHandler-onconnectionstatechanged) | 回调 SDK 与信令服务器连接状态相关事件。当 SDK 与信令服务器的网络连接状态改变时回调该事件。 | ## 消息 | 方法 | 描述 | | --- | --- | | [sendUserMessage](70080#RTSRoom-sendusermessage) | 给房间内指定的用户发送点对点文本消息（P2P）。 | | [sendSEIMessage](70080#RTCEngine-sendseimessage) | 通过视频帧发送 SEI 数据。

在视频通话场景下，SEI 数据会随视频帧发送；在语音通话场景下，SDK 会自动生成一路 16px × 16px 的黑帧视频流用来发送 SEI 数据。 | | [sendStreamSyncInfo](70080#RTCEngine-sendstreamsyncinfo) | 发送音频流同步信息。将消息通过音频流发送到远端，并实现与音频流同步，该接口调用成功后，远端用户会收到 [onStreamSyncInfoReceived](70081#IRTCEngineEventHandler-onstreamsyncinforeceived) 回调。 | | [sendServerBinaryMessage](70080#RTCEngine-sendserverbinarymessage) | 客户端给应用服务器发送二进制消息（P2Server） | | [sendServerMessage](70080#RTCEngine-sendservermessage) | 客户端给应用服务器发送文本消息（P2Server） | | [sendUserBinaryMessageOutsideRoom](70080#RTCEngine-senduserbinarymessageoutsideroom) | 给房间外指定的用户发送二进制消息（P2P） | | [sendUserMessageOutsideRoom](70080#RTCEngine-sendusermessageoutsideroom) | 给房间外指定的用户发送文本消息（P2P） | | [getPeerOnlineStatus](70080#RTCEngine-getpeeronlinestatus) | 查询对端用户或本端用户的登录状态 | | [setServerParams](70080#RTCEngine-setserverparams) | 设置应用服务器参数

客户端调用 [sendServerMessage](70080#RTCEngine-sendservermessage) 或 [sendServerBinaryMessage](70080#RTCEngine-sendserverbinarymessage) 发送消息给应用服务器之前，必须需要设置有效签名和应用服务器地址。 | | [updateLoginToken](70080#RTCEngine-updatelogintoken) | 更新用户用于登录的 Token

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

调用 [login](70080#RTCEngine-login) 方法登录时，如果使用了过期的 Token 将导致登录失败，并会收到 [onLoginResult](70081#IRTCEngineEventHandler-onloginresult) 回调通知，错误码为 `LOGIN_ERROR_CODE_INVALID_TOKEN`。此时需要重新获取 Token，并调用此方法更新 Token。 | | [logout](70080#RTCEngine-logout) | 登出 RTS 服务器。

调用本接口登出后，无法调用房间外消息以及端到服务器消息相关的方法或收到相关回调。 | | [login](70080#RTCEngine-login) | 登录 RTS 服务器。

必须先登录，才能调用 [sendUserMessageOutsideRoom](70080#RTCEngine-sendusermessageoutsideroom) 和 [sendServerMessage](70080#RTCEngine-sendservermessage) 发送房间外点对点消息和向应用服务器发送消息

在调用本接口登录后，如果想要登出，需要调用 [logout](70080#RTCEngine-logout)。 | | [sendRoomBinaryMessage](70080#RTSRoom-sendroombinarymessage) | 给房间内的所有其他用户群发二进制消息。 | | [sendRoomMessage](70080#RTSRoom-sendroommessage) | 给房间内的所有其他用户群发文本消息。 | | [sendUserBinaryMessage](70080#RTSRoom-senduserbinarymessage) | 给房间内指定的用户发送点对点二进制消息（P2P）。 | | 回调 | 描述 | | --- | --- | | [onRoomMessageReceived](70081#IRTCRoomEventHandler-onroommessagereceived) | > 该接口将于 3.64 [onRoomMessageReceived](70081#IRTCRoomEventHandler-onroommessagereceived-2) 代替。
接收到房间内广播消息的回调。

房间内其他用户调用 [sendRoomMessage](70080#RTSRoom-sendroommessage) 发送广播消息时，收到此回调。 | | [onRoomMessageSendResult](70081#IRTSRoomEventHandler-onroommessagesendresult) | 调用 [sendRoomMessage](70080#RTSRoom-sendroommessage) 或 [sendRoomBinaryMessage](70080#RTSRoom-sendroombinarymessage) 向房间内群发文本或二进制消息后，消息发送方会收到该消息发送结果回调。 | | [onUserMessageSendResult](70081#IRTSRoomEventHandler-onusermessagesendresult) | 向房间内单个用户发送文本或二进制消息后（P2P），消息发送方会收到该消息发送结果回调。 | | [onUserBinaryMessageReceived](70081#IRTSRoomEventHandler-onuserbinarymessagereceived-2) | 收到来自房间中其他用户通过 [sendUserBinaryMessage](70080#RTSRoom-senduserbinarymessage) 发来的点对点二进制消息时，会收到此回调。 | | [onUserMessageReceived](70081#IRTSRoomEventHandler-onusermessagereceived-2) | 收到来自房间中其他用户通过 [sendUserMessage](70080#RTSRoom-sendusermessage) 发来的点对点文本消息时，会收到此回调。 | | [onRoomBinaryMessageReceived](70081#IRTSRoomEventHandler-onroombinarymessagereceived-2) | 收到房间内广播二进制消息的回调。

房间内其他用户调用 [sendRoomBinaryMessage](70080#RTSRoom-sendroombinarymessage) 发送广播二进制消息时，收到此回调。 | | [onRoomMessageReceived](70081#IRTSRoomEventHandler-onroommessagereceived-2) | 接收到房间内广播消息的回调。

房间内其他用户调用 [sendRoomMessage](70080#RTSRoom-sendroommessage) 发送广播消息时，收到此回调。 | | [onUserBinaryMessageReceived](70081#IRTSRoomEventHandler-onuserbinarymessagereceived) | 收到来自房间中其他用户通过 [sendUserBinaryMessage](70080#RTSRoom-senduserbinarymessage) 发来的点对点二进制消息时，会收到此回调。 | | [onUserMessageReceived](70081#IRTSRoomEventHandler-onusermessagereceived) | 收到来自房间中其他用户通过 [sendUserMessage](70080#RTSRoom-sendusermessage) 发来的点对点文本消息时，会收到此回调。 | | [onRoomBinaryMessageReceived](70081#IRTSRoomEventHandler-onroombinarymessagereceived) | 收到房间内广播二进制消息的回调。

房间内其他用户调用 [sendRoomBinaryMessage](70080#RTSRoom-sendroombinarymessage) 发送广播二进制消息时，收到此回调。 | | [onRoomMessageReceived](70081#IRTSRoomEventHandler-onroommessagereceived) | 接收到房间内广播消息的回调。

房间内其他用户调用 [sendRoomMessage](70080#RTSRoom-sendroommessage) 发送广播消息时，收到此回调。 | | [onServerMessageSendResult](70081#IRTCEngineEventHandler-onservermessagesendresult) | 给应用服务器发送消息的回调。 | | [onUserMessageSendResultOutsideRoom](70081#IRTCEngineEventHandler-onusermessagesendresultoutsideroom) | 给房间外指定的用户发送消息的结果回调。

当调用 [sendUserMessageOutsideRoom](70080#RTCEngine-sendusermessageoutsideroom) 或 [sendUserBinaryMessageOutsideRoom](70080#RTCEngine-senduserbinarymessageoutsideroom) 发送消息后，会收到此回调。 | | [onUserBinaryMessageReceivedOutsideRoom](70081#IRTCEngineEventHandler-onuserbinarymessagereceivedoutsideroom-2) | 收到房间外用户调用 [sendUserBinaryMessageOutsideRoom](70080#RTCEngine-senduserbinarymessageoutsideroom) 发来的二进制消息时，会收到此回调。 | | [onUserMessageReceivedOutsideRoom](70081#IRTCEngineEventHandler-onusermessagereceivedoutsideroom-2) | 收到房间外用户调用 [sendUserMessageOutsideRoom](70080#RTCEngine-sendusermessageoutsideroom) 发来的文本消息时，会收到此回调。 | | [onUserBinaryMessageReceivedOutsideRoom](70081#IRTCEngineEventHandler-onuserbinarymessagereceivedoutsideroom) | > 该接口将于 3.64 [onUserBinaryMessageReceivedOutsideRoom](70081#IRTCEngineEventHandler-onuserbinarymessagereceivedoutsideroom-2) 代替。
收到房间外用户调用 [sendUserBinaryMessageOutsideRoom](70080#RTCEngine-senduserbinarymessageoutsideroom) 发来的二进制消息时，会收到此回调 | | [onUserMessageReceivedOutsideRoom](70081#IRTCEngineEventHandler-onusermessagereceivedoutsideroom) | > 该接口将于 3.64 [onUserMessageReceivedOutsideRoom](70081#IRTCEngineEventHandler-onusermessagereceivedoutsideroom-2) 代替。
收到房间外用户调用 [sendUserMessageOutsideRoom](70080#RTCEngine-sendusermessageoutsideroom) 发来的文本消息时，会收到此回调 | | [onGetPeerOnlineStatus](70081#IRTCEngineEventHandler-ongetpeeronlinestatus) | 查询对端或本端用户登录状态的返回结果 | | [onServerParamsSetResult](70081#IRTCEngineEventHandler-onserverparamssetresult) | 设置应用服务器参数的返回结果 | | [onLogout](70081#IRTCEngineEventHandler-onlogout) | 登出结果回调 | | [onLoginResult](70081#IRTCEngineEventHandler-onloginresult) | 登录结果回调 | | [onSEIStreamUpdate](70081#IRTCEngineEventHandler-onseistreamupdate) | 黑帧视频流发布状态回调。

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

你可以通过此回调判断携带 SEI 数据的视频帧为黑帧，从而不对该视频帧进行渲染。 | | [onRoomMessageSendResult](70081#IRTCRoomEventHandler-onroommessagesendresult) | 调用 [sendRoomMessage](70080#RTSRoom-sendroommessage) 或 [sendRoomBinaryMessage](70080#RTSRoom-sendroombinarymessage) 向房间内群发文本或二进制消息后，消息发送方会收到该消息发送结果回调。 | | [onUserMessageSendResult](70081#IRTCRoomEventHandler-onusermessagesendresult) | 向房间内单个用户发送文本或二进制消息后（P2P），消息发送方会收到该消息发送结果回调。 | | [onUserBinaryMessageReceived](70081#IRTCRoomEventHandler-onuserbinarymessagereceived-2) | 收到来自房间中其他用户通过 [sendUserBinaryMessage](70080#RTSRoom-senduserbinarymessage) 发来的点对点二进制消息时，会收到此回调。 | | [onUserMessageReceived](70081#IRTCRoomEventHandler-onusermessagereceived-2) | 收到来自房间中其他用户通过 [sendUserMessage](70080#RTSRoom-sendusermessage) 发来的点对点文本消息时，会收到此回调。 | | [onRoomBinaryMessageReceived](70081#IRTCRoomEventHandler-onroombinarymessagereceived-2) | 收到房间内广播二进制消息的回调。

房间内其他用户调用 [sendRoomBinaryMessage](70080#RTSRoom-sendroombinarymessage) 发送广播二进制消息时，收到此回调。 | | [onRoomMessageReceived](70081#IRTCRoomEventHandler-onroommessagereceived-2) | 接收到房间内广播消息的回调。

房间内其他用户调用 [sendRoomMessage](70080#RTSRoom-sendroommessage) 发送广播消息时，收到此回调。 | | [onUserBinaryMessageReceived](70081#IRTCRoomEventHandler-onuserbinarymessagereceived) | > 该接口将于 3.64 [onUserBinaryMessageReceived](70081#IRTCRoomEventHandler-onuserbinarymessagereceived-2) 代替。
收到来自房间中其他用户通过 [sendUserBinaryMessage](70080#RTSRoom-senduserbinarymessage) 发来的点对点二进制消息时，会收到此回调。 | | [onUserMessageReceived](70081#IRTCRoomEventHandler-onusermessagereceived) | > 该接口将于 3.64 [onUserMessageReceived](70081#IRTCRoomEventHandler-onusermessagereceived-2) 代替。
收到来自房间中其他用户通过 [sendUserMessage](70080#RTSRoom-sendusermessage) 发来的点对点文本消息时，会收到此回调。 | | [onRoomBinaryMessageReceived](70081#IRTCRoomEventHandler-onroombinarymessagereceived) | > 该接口将于 3.64 [onRoomBinaryMessageReceived](70081#IRTCRoomEventHandler-onroombinarymessagereceived-2) 代替。
收到房间内广播二进制消息的回调。

房间内其他用户调用 [sendRoomBinaryMessage](70080#RTSRoom-sendroombinarymessage) 发送广播二进制消息时，收到此回调。 | ## 推流至 CDN | 方法 | 描述 | | --- | --- | | [startPushMixedStream](70080#RTCEngine-startpushmixedstream) | 指定房间中的媒体流，合成后一路流发布到 CDN 或发布一路 WTN 流。 | | [stopPushSingleStream](70080#RTCEngine-stoppushsinglestream) | 停止通过 [startPushSingleStream](70080#RTCEngine-startpushsinglestream) 发起的单流转推任务。 | | [startPushSingleStream](70080#RTCEngine-startpushsinglestream) | 将房间内某一路音视频流，推送到指定的 RTC 房间或 CDN 地址。此过程不涉及编解码。 | | [stopPushMixedStream](70080#RTCEngine-stoppushmixedstream) | 停止由 [startPushMixedStream](70080#RTCEngine-startpushmixedstream) 启动的任务。 | | [updatePushMixedStream](70080#RTCEngine-updatepushmixedstream) | 更新由 [startPushMixedStream](70080#RTCEngine-startpushmixedstream) 启动的任务参数，会收到 [onMixedStreamEvent](70081#IRTCEngineEventHandler-onmixedstreamevent) 回调。 | | 回调 | 描述 | | --- | --- | | [onMixedStreamEvent](70081#IRTCEngineEventHandler-onmixedstreamevent) | 合流转推 CDN / WTN 流状态回调 | | [onSingleStreamEvent](70081#IRTCEngineEventHandler-onsinglestreamevent) | 单流转推 CDN 状态回调 | ## 推流至 WTN | 方法 | 描述 | | --- | --- | | [getWTNStream](70080#RTCEngine-getwtnstream) | 获取 WTN 管理接口。 | | [subscribeWTNVideoStream](70080#IWTNStream-subscribewtnvideostream) | 订阅/取消订阅指定 WTN 视频流

无论用户是否在房间内，都可以调用本接口订阅/取消订阅指定的 WTN 视频流。 | | [subscribeWTNAudioStream](70080#IWTNStream-subscribewtnaudiostream) | 订阅/取消订阅指定 WTN 音频流

无论用户是否在房间内，都可以调用本接口订阅/取消订阅指定的 WTN 音频流。 | | [setWTNRemoteVideoCanvas](70080#IWTNStream-setwtnremotevideocanvas) | 为指定 WTN 流绑定内部渲染视图 | | [setWTNRemoteVideoSink](70080#IWTNStream-setwtnremotevideosink) | 为指定 WTN 流绑定自定义渲染器。详见[自定义视频渲染](https://www.volcengine.com/docs/6348/81201)。 | | [setWTNRemoteAudioPlaybackVolume](70080#IWTNStream-setwtnremoteaudioplaybackvolume) | 调节 WTN 流的音频播放音量。 | | [setWTNStreamEventHandler](70080#IWTNStream-setwtnstreameventhandler) | 设置 WTN 流回调接口 | | 回调 | 描述 | | --- | --- | | [onWTNRemoteVideoStats](70081#IWTNStreamEventHandler-onwtnremotevideostats) | 通话中本地设备接收订阅的远端 WTN 视频流的流 ID 以及远端 WTN 视频流统计信息。 | | [onWTNRemoteAudioStats](70081#IWTNStreamEventHandler-onwtnremoteaudiostats) | 通话中本地设备接收订阅的远端 WTN 音频流的流 ID 以及远端 WTN 音频流统计信息。 | | [onWTNVideoSubscribeStateChanged](70081#IWTNStreamEventHandler-onwtnvideosubscribestatechanged) | WTN 视频流订阅状态变化回调

通过 [subscribeWTNVideoStream](70080#IWTNStream-subscribewtnvideostream) 订阅 WTN 视频流后，可以通过本回调获取订阅结果。 | | [onWTNAudioSubscribeStateChanged](70081#IWTNStreamEventHandler-onwtnaudiosubscribestatechanged) | WTN 音频流订阅状态变化回调

通过 [subscribeWTNAudioStream](70080#IWTNStream-subscribewtnaudiostream) 订阅 WTN 音频流后，可以通过本回调获取订阅结果。 | | [onWTNFirstRemoteAudioFrame](70081#IWTNStreamEventHandler-onwtnfirstremoteaudioframe) | WTN 流的首帧音频解码成功

关于订阅 WTN 音频流，详见 [subscribeWTNAudioStream](70080#IWTNStream-subscribewtnaudiostream)。 | | [onWTNFirstRemoteVideoFrameDecoded](70081#IWTNStreamEventHandler-onwtnfirstremotevideoframedecoded) | WTN 流的首帧视频解码成功

关于订阅 WTN 流，详见 [subscribeWTNVideoStream](70080#IWTNStream-subscribewtnvideostream)。 | | [onWTNSEIMessageReceived](70081#IWTNStreamEventHandler-onwtnseimessagereceived) | 回调 WTN 流中包含的 SEI 信息。

调用 [subscribeWTNAudioStream](70080#IWTNStream-subscribewtnaudiostream)/[subscribeWTNVideoStream](70080#IWTNStream-subscribewtnvideostream)接口拉 WTN 音频流/视频流后，通过此回调收到 WTN 流中的 SEI 消息。 | | [onWTNDataMessageReceived](70081#IWTNStreamEventHandler-onwtndatamessagereceived) | 回调 WTN 流中包含的数据信息。

通过 [subscribeWTNAudioStream](70080#IWTNStream-subscribewtnaudiostream)/[subscribeWTNVideoStream](70080#IWTNStream-subscribewtnvideostream) 订阅 WTN 流后，通过监听本回调获取 WTN 流中的数据消息，包括调用 Open API 发送的 SEI 消息和音量回调。 | ## 混音 | 方法 | 描述 | | --- | --- | | [getAudioEffectPlayer](70080#RTCEngine-getaudioeffectplayer) | 创建音效播放器实例。 | | [setEventHandler](70080#IAudioEffectPlayer-seteventhandler) | 设置回调句柄。 | | [getDuration](70080#IAudioEffectPlayer-getduration) | 获取音效文件时长。 | | [getVolume](70080#IAudioEffectPlayer-getvolume) | 获取当前音量。 | | [setVolumeAll](70080#IAudioEffectPlayer-setvolumeall) | 设置所有音效的音量大小，包括音效文件和 PCM 音效。 | | [setVolume](70080#IAudioEffectPlayer-setvolume) | 调节指定音效的音量大小，包括音效文件和 PCM 音频。 | | [getPosition](70080#IAudioEffectPlayer-getposition) | 获取音效文件播放进度。 | | [setPosition](70080#IAudioEffectPlayer-setposition) | 设置音效文件的起始播放位置。 | | [resumeAll](70080#IAudioEffectPlayer-resumeall) | 恢复播放所有音效文件。 | | [resume](70080#IAudioEffectPlayer-resume) | 恢复播放音效文件。 | | [pauseAll](70080#IAudioEffectPlayer-pauseall) | 暂停播放所有音效文件。 | | [pause](70080#IAudioEffectPlayer-pause) | 暂停播放音效文件。 | | [unloadAll](70080#IAudioEffectPlayer-unloadall) | 卸载所有音效文件。 | | [unload](70080#IAudioEffectPlayer-unload) | 卸载指定音效文件。 | | [preload](70080#IAudioEffectPlayer-preload) | 预加载指定音乐文件到内存中，以避免频繁播放同一文件时的重复加载，减少 CPU 占用。 | | [stopAll](70080#IAudioEffectPlayer-stopall) | 停止播放所有音效文件。 | | [stop](70080#IAudioEffectPlayer-stop) | 停止播放音效文件。 | | [start](70080#IAudioEffectPlayer-start) | 开始播放音效文件。

可以通过传入不同的 ID 和 filepath 多次调用本方法，以实现同时播放多个音效文件，实现音效叠加。 | | [setEventHandler](70080#IMediaPlayer-seteventhandler) | 设置回调句柄。 | | [pushExternalAudioFrame](70080#IMediaPlayer-pushexternalaudioframe) | 推送用于混音的 PCM 音频帧数据 | | [registerAudioFrameObserver](70080#IMediaPlayer-registeraudioframeobserver) | 注册回调句柄以在本地音乐文件混音时，收到相关回调。 | | [setLoudness](70080#IMediaPlayer-setloudness) | 如果你需要使用 [enableVocalInstrumentBalance](70080#RTCEngine-enablevocalinstrumentbalance) 对音频文件/PCM 音频数据设置音量均衡，你必须通过此接口传入其原始响度。 | | [setProgressInterval](70080#IMediaPlayer-setprogressinterval) | 设置音频文件混音时，收到 [onMediaPlayerPlayingProgress](70081#IMediaPlayerEventHandler-onmediaplayerplayingprogress) 的间隔。 | | [setPlaybackSpeed](70080#IMediaPlayer-setplaybackspeed) | 设置播放速度 | | [selectAudioTrack](70080#IMediaPlayer-selectaudiotrack) | 指定当前音乐文件的播放音轨 | | [getAudioTrackCount](70080#IMediaPlayer-getaudiotrackcount) | 获取当前音乐文件的音轨数 | | [setAudioDualMonoMode](70080#IMediaPlayer-setaudiodualmonomode) | 设置当前音乐文件的声道模式 | | [setPosition](70080#IMediaPlayer-setposition) | 设置音乐文件的起始播放位置。 | | [setAudioPitch](70080#IMediaPlayer-setaudiopitch) | 开启变调功能，多用于 K 歌场景。 | | [getState](70080#IMediaPlayer-getstate) | 获取播放器状态 | | [getPosition](70080#IMediaPlayer-getposition) | 获取音乐文件播放进度。 | | [getPlaybackDuration](70080#IMediaPlayer-getplaybackduration) | 获取混音音乐文件的实际播放时长，单位为毫秒。 | | [getTotalDuration](70080#IMediaPlayer-gettotalduration) | 获取音乐文件时长。 | | [getVolume](70080#IMediaPlayer-getvolume) | 获取当前音量 | | [setVolume](70080#IMediaPlayer-setvolume) | 调节指定混音的音量大小，包括音乐文件混音和 PCM 混音。 | | [resume](70080#IMediaPlayer-resume) | 调用 [pause](70080#IMediaPlayer-pause) 暂停音频播放后，调用本方法恢复播放。 | | [pause](70080#IMediaPlayer-pause) | 调用 [open](70080#IMediaPlayer-open)，或 [start](70080#IMediaPlayer-start) 开始播放音频文件后，调用本方法暂停播放。 | | [stop](70080#IMediaPlayer-stop) | 调用 [open](70080#IMediaPlayer-open), [start](70080#IMediaPlayer-start), 或 [openWithCustomSource](70080#IMediaPlayer-openwithcustomsource) 开始播放后，可以调用本方法停止。 | | [openWithCustomSource](70080#IMediaPlayer-openwithcustomsource) | 启动音频裸数据混音。

要播放音乐文件，参看 [open](70080#IMediaPlayer-open)。`open` 与此 API 互斥。 | | [start](70080#IMediaPlayer-start) | 播放音乐。你仅需要在调用 [open](70080#IMediaPlayer-open)，且未开启自动播放时，调用此方法。 | | [open](70080#IMediaPlayer-open) | 打开音乐文件。

一个播放器实例仅能够同时打开一个音乐文件。如果需要同时打开多个音乐文件，请创建多个音乐播放器实例。

要播放 PCM 格式的音频数据，参看 [openWithCustomSource](70080#IMediaPlayer-openwithcustomsource)。`openWithCustomSource` 和此 API 互斥。 | | [getMediaPlayer](70080#RTCEngine-getmediaplayer) | 创建音乐播放器实例。 | | 回调 | 描述 | | --- | --- | | [onAudioEffectPlayerStateChanged](70081#IAudioEffectPlayerEventHandler-onaudioeffectplayerstatechanged) | 播放状态改变时回调。 | | [onAudioMixingPlayingProgress](70081#IRTCEngineEventHandler-onaudiomixingplayingprogress) | 混音音频文件播放进度回调 | | [onSeek](70081#IMediaPlayerCustomSourceProvider-onseek) | 根据设置好的内存音频数据的读取位置和读取偏移量对音频数据进行偏移，以便 SDK 读取和分析音频数据。

在调用 [openWithCustomSource](70080#IMediaPlayer-openwithcustomsource) 接口传入内存音频数据，或者调用 [setPosition](70080#IMediaPlayer-setposition) 设置了音频数据的起始播放位置后，SDK 会对音频数据进行读取和分析，此时会触发该回调，你需要根据参数中设置的起始读取位置和偏移量进行操作。 | | [onReadData](70081#IMediaPlayerCustomSourceProvider-onreaddata) | 调用 [openWithCustomSource](70080#IMediaPlayer-openwithcustomsource) 接口播放用户传入的内存音频数据时，会触发此回调，用户需要写入音频数据。 | | [onMediaPlayerEvent](70081#IMediaPlayerEventHandler-onmediaplayerevent) | 播放事件回调。调用 [selectAudioTrack](70080#IMediaPlayer-selectaudiotrack) 和 [setPosition](70080#IMediaPlayer-setposition) 后，会触发此回调。 | | [onFrame](70081#IMediaPlayerAudioFrameObserver-onframe) | 当本地音频文件混音时，回调播放的音频帧。 | | [onMediaPlayerStateChanged](70081#IMediaPlayerEventHandler-onmediaplayerstatechanged) | 播放状态改变时回调。 | | [onMediaPlayerPlayingProgress](70081#IMediaPlayerEventHandler-onmediaplayerplayingprogress) | 播放进度周期性回调。回调周期通过 [setProgressInterval](70080#IMediaPlayer-setprogressinterval) 设置。 | ## 屏幕共享 | 方法 | 描述 | | --- | --- | | [startScreenCapture](70080#RTCEngine-startscreencapture) | 使用 RTC SDK 内部采集模块开始采集屏幕音频流和（或）视频流。 | | [stopScreenCapture](70080#RTCEngine-stopscreencapture) | 在屏幕共享时，停止使用 RTC SDK 内部采集方式采集屏幕音视频。 | | [updateScreenCapture](70080#RTCEngine-updatescreencapture) | 使用 RTC SDK 内部屏幕采集后，更新采集的媒体类型。 | | [setScreenAudioSourceType](70080#RTCEngine-setscreenaudiosourcetype) | 在屏幕共享时，设置屏幕音频的采集方式（内部采集/自定义采集） | | [pushScreenAudioFrame](70080#RTCEngine-pushscreenaudioframe) | 使用自定义采集方式，采集屏幕共享时的屏幕音频时，将音频帧推送至 RTC SDK 处进行编码等处理。 | ## 安全与加密 | 方法 | 描述 | | --- | --- | | [setEncryptInfo](70080#RTCEngine-setencryptinfo) | 设置传输时使用内置加密的方式。 | | [setLocalProxy](70080#RTCEngine-setlocalproxy) | 设置本地代理。 | | [stopCloudProxy](70080#RTCEngine-stopcloudproxy) | 关闭云代理 | | [startCloudProxy](70080#RTCEngine-startcloudproxy) | 开启云代理 | | [setCustomizeEncryptHandler](70080#RTCEngine-setcustomizeencrypthandler) | 设置自定义加密和解密方式。 | | 回调 | 描述 | | --- | --- | | [onCloudProxyConnected](70081#IRTCEngineEventHandler-oncloudproxyconnected) | 调用 [startCloudProxy](70080#RTCEngine-startcloudproxy) 开启云代理，SDK 首次成功连接云代理服务器时，回调此事件。 | | [onDecryptData](70081#IRTCEncryptionHandler-ondecryptdata) | 自定义解密。

对自定义加密后的音视频帧数据进行解密。关于自定义加密，参看 [onEncryptData](70081#IRTCEncryptionHandler-onencryptdata)。 | | [onEncryptData](70081#IRTCEncryptionHandler-onencryptdata) | 自定义加密。

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

暂不支持对原始音视频帧进行加密。 | | [onLocalProxyStateChanged](70081#IRTCEngineEventHandler-onlocalproxystatechanged) | 本地代理状态发生改变回调。调用 [setLocalProxy](70080#RTCEngine-setlocalproxy) 设置本地代理后，SDK 会触发此回调，通知代理连接的状态。 | ## 字幕翻译服务 | 方法 | 描述 | | --- | --- | | [startSubtitle](70080#RTCRoom-startsubtitle) | 识别或翻译房间内所有用户的语音，形成字幕。

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

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

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

调用该方法后，用户会收到 [onSubtitleStateChanged](70081#IRTCRoomEventHandler-onsubtitlestatechanged) 回调，通知字幕是否关闭。 | | 回调 | 描述 | | --- | --- | | [onSubtitleStateChanged](70081#IRTCRoomEventHandler-onsubtitlestatechanged) | 字幕状态发生改变回调。

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

当用户成功调用 [startSubtitle](70080#RTCRoom-startsubtitle) 后会收到此回调，通知字幕的相关信息。 | ## 高级功能 | 方法 | 描述 | | --- | --- | | [enableSpatialAudio](70080#ISpatialAudio-enablespatialaudio) | 开启/关闭空间音频功能。 | | [takeLocalSnapshotToFile](70080#RTCEngine-takelocalsnapshottofile) | 截取本地的视频流画面，生成 JPG 文件，并保存到本地指定路径。

调用该方法后，SDK 会触发回调 [onLocalSnapshotTakenToFile](70081#IRTCEngineEventHandler-onlocalsnapshottakentofile) 报告截图是否成功，以及截取的图片信息。 | | [takeRemoteSnapshotToFile](70080#RTCEngine-takeremotesnapshottofile) | 截取远端的视频流画面，生成 JPG 文件，并保存到本地指定路径。

调用该方法后，SDK 会触发回调 [onRemoteSnapshotTakenToFile](70081#IRTCEngineEventHandler-onremotesnapshottakentofile) 报告截图是否成功，以及截取的图片信息。 | | [takeRemoteSnapshot](70080#RTCEngine-takeremotesnapshot) | 截取本地视频画面 | | [takeLocalSnapshot](70080#RTCEngine-takelocalsnapshot) | 截取本地视频画面 | | [stopFileRecording](70080#RTCEngine-stopfilerecording) | 停止本地录制 | | [startFileRecording](70080#RTCEngine-startfilerecording) | 该方法将通话过程中的音视频数据录制到本地的文件中。 | | [setEarMonitorVolume](70080#RTCEngine-setearmonitorvolume) | 设置耳返音量。 | | [setEarMonitorMode](70080#RTCEngine-setearmonitormode-2) | 开启/关闭耳返功能，并控制是否对耳返音频应用本地音频处理。 | | [setEarMonitorMode](70080#RTCEngine-setearmonitormode) | 开启/关闭耳返功能。 | | [stopAudioRecording](70080#RTCEngine-stopaudiorecording) | 停止音频文件录制 | | [startAudioRecording](70080#RTCEngine-startaudiorecording) | 开始音频录制，并生成录音文件保存到本地。 | | [setAnsMode](70080#RTCEngine-setansmode) | 支持根据业务场景，设置通话中的音频降噪模式。 | | [setNoAttenuationFlags](70080#IRangeAudio-setnoattenuationflags) | 添加标签组，用于标记相互之间通话不衰减的用户组。

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

比如，用户身处多个队伍，队伍成员间通话不衰减。那么，可以为每个队伍绑定专属标签，每个用户的标签组包含用户所属各个队伍的标签。 | | [setAttenuationModel](70080#IRangeAudio-setattenuationmodel) | 设置范围语音的音量衰减模式。 | | [updateReceiveRange](70080#IRangeAudio-updatereceiverange) | 更新本地用户的音频收听范围。 | | [updatePosition](70080#IRangeAudio-updateposition) | 更新本地用户在房间内空间直角坐标系中的位置坐标。 | | [enableRangeAudio](70080#IRangeAudio-enablerangeaudio) | 开启/关闭范围语音功能。

范围语音是指，在同一 RTC 房间中设定的音频接收距离范围内，本地用户收听到的远端用户音频音量会随着远端用户的靠近/远离而放大/衰减；若远端用户在房间内的位置超出设定范围，则本地用户无法接收其音频。音频接收范围设置参看 [updateReceiveRange](70080#IRangeAudio-updatereceiverange)。 | | [getRangeAudio](70080#IGameRoom-getrangeaudio) | 获取游戏房间的范围语音接口实例。 | | [getSpatialAudio](70080#RTCRoom-getspatialaudio) | 获取空间音频接口实例。 | | [getRangeAudio](70080#RTCRoom-getrangeaudio) | 获取范围语音接口实例。 | | [removeAllRemotePosition](70080#ISpatialAudio-removeallremoteposition) | 移除调用 [updateRemotePosition](70080#ISpatialAudio-updateremoteposition) 为所有远端用户设置的空间音频效果。 | | [removeRemotePosition](70080#ISpatialAudio-removeremoteposition) | 移除调用 [updateRemotePosition](70080#ISpatialAudio-updateremoteposition) 为某一远端用户设置的空间音频效果。 | | [updateRemotePosition](70080#ISpatialAudio-updateremoteposition) | 设置房间内某一远端用户在本地用户自建的空间音频坐标系中的发声位置和发声朝向，以实现本地用户预期的空间音频收听效果。 | | [updateSelfPosition](70080#ISpatialAudio-updateselfposition) | 设置本地用户在自建空间直角坐标系中的收听坐标和收听朝向，以实现本地用户预期的空间音频收听效果。 | | [disableRemoteOrientation](70080#ISpatialAudio-disableremoteorientation) | 关闭本地用户朝向对本地用户发声效果的影响。

调用此接口后，房间内的其他用户收听本地发声时，声源都在收听者正面。 | | 回调 | 描述 | | --- | --- | | [onExtensionAccessError](70081#IRTCEngineEventHandler-onextensionaccesserror) | 当访问插件失败时，收到此回调。

RTC SDK 将一些功能封装成插件。当使用这些功能时，如果插件不存在，功能将无法使用。 | | [onTakeRemoteSnapshotResult](70081#ISnapshotResultCallback-ontakeremotesnapshotresult) | 调用 [takeRemoteSnapshot](70080#RTCEngine-takeremotesnapshot) 截取视频画面时，收到此回调。 | | [onTakeLocalSnapshotResult](70081#ISnapshotResultCallback-ontakelocalsnapshotresult) | 调用 [takeLocalSnapshot](70080#RTCEngine-takelocalsnapshot) 截取视频画面时，收到此回调。 | | [onLocalSnapshotTakenToFile](70081#IRTCEngineEventHandler-onlocalsnapshottakentofile) | 调用 [takeLocalSnapshotToFile](70080#RTCEngine-takelocalsnapshottofile) 截取视频画面时，会收到此回调报告截图是否成功，以及截取的图片信息。 | | [onRemoteSnapshotTakenToFile](70081#IRTCEngineEventHandler-onremotesnapshottakentofile) | 调用 [takeRemoteSnapshotToFile](70080#RTCEngine-takeremotesnapshottofile) 截取视频画面时，会收到此回调报告截图是否成功，以及截取的图片信息。 | | [onAudioRecordingStateUpdate](70081#IRTCEngineEventHandler-onaudiorecordingstateupdate) | 调用 [startAudioRecording](70080#RTCEngine-startaudiorecording) 或 [stopAudioRecording](70080#RTCEngine-stopaudiorecording) 改变音频文件录制状态时，收到此回调。 | | [onRecordingProgressUpdate](70081#IRTCEngineEventHandler-onrecordingprogressupdate) | 本地录制进度回调。

该回调由 [startFileRecording](70080#RTCEngine-startfilerecording) 触发，录制状态正常时，系统每秒钟都会通过该回调提示录制进度。 | | [onRecordingStateUpdate](70081#IRTCEngineEventHandler-onrecordingstateupdate) | 获取本地录制状态回调。

该回调由 [startFileRecording](70080#RTCEngine-startfilerecording) 或 [stopFileRecording](70080#RTCEngine-stopfilerecording) 触发。 |

实时音视频