## 引擎管理 | 方法 | 描述 | | --- | --- | | [createRTCEngine](85516#IRTCEngine-creatertcengine) | 创建 IRTCEngine 实例。
如果当前进程中未创建引擎实例，那么你必须先使用此方法，以使用 RTC 提供的各种音视频能力。
如果当前进程中已创建了引擎实例，再次调用此方法时，会返回已创建的引擎实例。 | | [getCount](85516#IVideoDeviceCollection-getcount) | 获取当前系统内视频设备数量 | | [getCount](85516#IAudioDeviceCollection-getcount) | 获取当前系统内音频设备数量 | | [getDevice](85516#IVideoDeviceCollection-getdevice) | 获取视频设备信息，仅可根据索引号、设备名称、设备 ID 获取。 | | [getDevice](85516#IVideoDeviceCollection-getdevice-2) | 获取视频设备信息，可根据索引号、设备信息（ID、设备的产品编码等）。 | | [getDevice](85516#IAudioDeviceCollection-getdevice) | 获取音频设备信息，仅可根据索引号、设备名称、设备 ID 获取。 | | [getDevice](85516#IAudioDeviceCollection-getdevice-2) | 获取音频设备信息，可根据索引号、设备信息（ID、设备的产品编码等）。 | | [feedback](85516#IRTCEngine-feedback) | 将用户反馈的问题上报到 RTC。 | | [setRuntimeParameters](85516#IRTCEngine-setruntimeparameters) | 设置运行时的参数 | | [setBusinessId](85516#IRTCEngine-setbusinessid) | 设置业务标识参数
可通过 businessId 区分不同的业务场景。businessId 由客户自定义，相当于一个“标签”，可以分担和细化现在 AppId 的逻辑划分的功能，但不需要鉴权。 | | [setLogConfig](85516#IRTCEngine-setlogconfig) | 配置 SDK 本地日志参数，包括日志级别、存储路径、日志文件最大占用的总空间、日志文件名前缀。 | | [getSDKVersion](85516#IRTCEngine-getsdkversion) | 获取当前 SDK 版本信息。 | | [release](85516#IVideoDeviceCollection-release) | 释放当前 [IVideoDeviceCollection](85516#IVideoDeviceCollection) 对象占用的资源。 | | [release](85516#IAudioDeviceCollection-release) | 释放当前 [IAudioDeviceCollection](85516#IAudioDeviceCollection) 对象占用的资源。 | | [destroyRTCEngine](85516#IRTCEngine-destroyrtcengine) | 销毁由 [createRTCEngine](85516#IRTCEngine-creatertcengine) 所创建的引擎实例，并释放所有相关资源。 | | 回调 | 描述 | | --- | --- | | [onTokenWillExpire](85517#IRTCRoomEventHandler-ontokenwillexpire) | 当 SDK 检测到 Token 的进房权限将在 30 秒内过期时，触发该回调。
收到该回调后，你需调用 [updateToken](85516#IRTSRoom-updatetoken) 更新 Token 进房权限。 | | [onSysStats](85517#IRTCEngineEventHandler-onsysstats) | 周期性（2s）发出回调，报告当前 CPU 与内存的相关信息。 | | [onLogReport](85517#IRTCEngineEventHandler-onlogreport) | 上报日志时回调该事件。 | | [onError](85517#IRTCEngineEventHandler-onerror) | 发生错误回调。
SDK 运行时出现了网络或媒体相关的错误，且无法自动恢复时触发此回调。 | | [onWarning](85517#IRTCEngineEventHandler-onwarning) | 发生警告回调。
SDK 运行时出现了警告。SDK 通常会自动恢复，警告信息可以忽略。
你可能需要干预. | | [onSubscribePrivilegeTokenWillExpire](85517#IRTCRoomEventHandler-onsubscribeprivilegetokenwillexpire) | Token 订阅权限过期前 30 秒将触发该回调。
收到该回调后，你需调用 [updateToken](85516#IRTSRoom-updatetoken) 更新 Token 订阅权限有效期。 | | [onPublishPrivilegeTokenWillExpire](85517#IRTCRoomEventHandler-onpublishprivilegetokenwillexpire) | Token 发布权限过期前 30 秒将触发该回调。
收到该回调后，你需调用 [updateToken](85516#IRTSRoom-updatetoken) 更新 Token 发布权限。 | ## 房间管理 ### RTC 房间方法 | 方法 | 描述 | | --- | --- | | [createRTCRoom](85516#IRTCEngine-creatertcroom) | 创建 RTC 房间实例。
调用此方法仅返回一个 RTC 房间实例，你仍需调用 [joinRoom](85516#IRTCRoom-joinroom) 才能真正地创建/加入房间。
多次调用此方法以创建多个 [IRTCRoom](85516#IRTCRoom) 实例。分别调用各 IRTCRoom 实例中的 [joinRoom](85516#IRTCRoom-joinroom) 方法，同时加入多个房间。
多房间模式下，用户可以同时订阅各房间的音视频流。 | | [joinRoom](85516#IRTCRoom-joinroom) | 加入 RTC 房间。
调用 [createRTCRoom](85516#IRTCEngine-creatertcroom) 创建房间后，调用此方法加入房间，同房间内其他用户进行音视频通话。 | | [setRTCRoomEventHandler](85516#IRTCRoom-setrtcroomeventhandler) | 通过设置 [IRTCRoom](85516#IRTCRoom) 对象的事件句柄，监听此对象对应的回调事件。 | | [setUserVisibility](85516#IRTCRoom-setuservisibility) | 设置用户可见性。未调用该接口前，本地用户默认对他人可见。
默认情况下，一个 RTC 房间最多同时容纳 50 名可见用户，最多 30 人可同时上麦。更多信息参看[用户和媒体流上限](https://www.volcengine.com/docs/6348/257549)。 | | [getCallId](85516#IRTCRoom-getcallid) | 获取通话 ID。
该方法需要在加入房间后调用。当创建一个房间开启音视频通话后，系统会为该房间生成一个对应的通话 ID，标识此房间的通话。 | | [setRoomExtraInfo](85516#IRTCRoom-setroomextrainfo) | 设置/更新房间附加信息，可用于标识房间状态或属性，或灵活实现各种业务逻辑。 | | [leaveRoom](85516#IRTSRoom-leaveroom) | 离开 RTC 房间。
用户调用此方法离开房间，结束通话过程，释放所有通话相关的资源。
| | [destroy](85516#IRTCRoom-destroy) | 退出并销毁调用 [createRTCRoom](85516#IRTCEngine-creatertcroom) 所创建的 RTC 房间实例。 | ### RTS 房间方法 | 方法 | 描述 | | --- | --- | | [createRTSRoom](85516#IRTCEngine-creatertsroom) | 创建 RTS 房间实例。
调用此方法仅返回一个 RTS 房间实例，你仍需调用 [joinRTSRoom](85516#IRTSRoom-joinrtsroom) 才能真正地创建/加入房间。
多次调用此方法以创建多个 [IRTSRoom](85516#IRTSRoom) 实例。分别调用各 IRTSRoom 实例中的 [joinRTSRoom](85516#IRTSRoom-joinrtsroom) 方法，同时加入多个房间。
多房间模式下，用户可以同时收发各房间的消息。 | | [joinRTSRoom](85516#IRTSRoom-joinrtsroom) | 创建/加入 RTS 房间。
同一房间内的用户间可以相互通话。
进房后重复调用无效，用户必须调用 `leaveRoom` 退出当前房间后，才能加入下一个房间。 | | [setRTSRoomEventHandler](85516#IRTSRoom-setrtsroomeventhandler) | 设置 [IRTSRoom](85516#IRTSRoom) 对象的事件句柄。
通过设置事件句柄可以监听此 [IRTSRoom](85516#IRTSRoom) 对象对应的房间的回调事件。 | | [leaveRoom](85516#IRTSRoom-leaveroom) | 离开 RTS 房间。
用户调用此方法离开房间，结束通话过程，释放所有通话相关的资源。
| | [destroy](85516#IRTSRoom-destroy) | 退出并销毁调用 [createRTSRoom](85516#IRTCEngine-creatertsroom) 所创建的 RTS 房间实例。 | ### 游戏房间方法 | 方法 | 描述 | | --- | --- | | [createGameRoom](85516#IRTCEngine-creategameroom) | 创建游戏语音房间实例。
调用此方法仅返回一个房间实例，你仍需调用 [joinRoom](85516#IGameRoom-joinroom) 才能真正地创建/加入游戏房间。
多次调用此方法以创建多个 [IGameRoom](85516#IGameRoom) 实例。分别调用各 IGameRoom 实例中的 [joinRoom](85516#IGameRoom-joinroom) 方法，同时加入多个房间。
多房间模式下，用户可以同时订阅各房间的音视频流。 | | [joinRoom](85516#IGameRoom-joinroom) | 加入游戏房间。
调用 [createGameRoom](85516#IRTCEngine-creategameroom) 创建房间实例后，调用此方法加入房间，同房间内其他用户进行音频通话。 | | [setRTCRoomEventHandler](85516#IGameRoom-setrtcroomeventhandler) | 通过设置 [IGameRoom](85516#IGameRoom) 对象的事件句柄，监听此对象对应的回调事件。 | | [updateToken](85516#IGameRoom-updatetoken) | 更新游戏房间 Token。
收到 [onTokenWillExpire](85517#IRTCRoomEventHandler-ontokenwillexpire)，[onPublishPrivilegeTokenWillExpire](85517#IRTCRoomEventHandler-onpublishprivilegetokenwillexpire)，或 [onSubscribePrivilegeTokenWillExpire](85517#IRTCRoomEventHandler-onsubscribeprivilegetokenwillexpire) 时，你必须重新获取 Token，并调用此方法更新 Token，以保证通话的正常进行。 | | [leaveRoom](85516#IGameRoom-leaveroom) | 离开游戏房间。
调用此方法结束通话过程，并释放所有通话相关的资源。 | | [destroy](85516#IGameRoom-destroy) | 退出并销毁调用 [createGameRoom](85516#IRTCEngine-creategameroom) 所创建的游戏房间实例。 | ### RTC 房间回调 | 回调 | 描述 | | --- | --- | | [onRoomStats](85517#IRTCRoomEventHandler-onroomstats) | 房间内通话统计信息回调。
用户进房开始通话后，每 2s 收到一次本回调。 | | [onUserVisibilityChanged](85517#IRTCRoomEventHandler-onuservisibilitychanged) | 用户调用 [setUserVisibility](85516#IRTCRoom-setuservisibility) 设置用户可见性的回调。 | | [onRoomStreamExtraInfoUpdate](85517#IRTCRoomEventHandler-onroomstreamextrainfoupdate) | 接收同一房间内，其他用户调用 [setStreamExtraInfo](85516#IRTCRoom-setstreamextrainfo) 设置的流附加信息的回调。 | | [onRoomExtraInfoUpdate](85517#IRTCRoomEventHandler-onroomextrainfoupdate) | 接收同一房间内，其他用户调用 [setRoomExtraInfo](85516#IRTCRoom-setroomextrainfo) 设置的房间附加信息的回调。 | | [onSetRoomExtraInfoResult](85517#IRTCRoomEventHandler-onsetroomextrainforesult) | 调用 [setRoomExtraInfo](85516#IRTCRoom-setroomextrainfo) 设置房间附加信息结果的回调。 | | [onUserJoined](85517#IRTCRoomEventHandler-onuserjoined) | 远端可见用户加入房间，或房内不可见用户切换为可见的回调。

远端用户调用 [setUserVisibility](85516#IRTCRoom-setuservisibility) 方法将自身设为可见后加入房间时，房间内其他用户将收到该事件。
远端可见用户断网后重新连入房间时，房间内其他用户将收到该事件。
房间内隐身远端用户调用 [setUserVisibility](85516#IRTCRoom-setuservisibility) 方法切换至可见时，房间内其他用户将收到该事件。
新进房用户会收到进房前已在房内的可见用户的进房回调通知。

| ### RTS 房间回调 | 回调 | 描述 | | --- | --- | | [onLeaveRoom](85517#IRTSRoomEventHandler-onleaveroom) | 离开房间回调。
用户调用 [leaveRoom](85516#IRTSRoom-leaveroom) 方法后，SDK 会停止所有的发布订阅流，并在释放所有与通话相关的音频资源后，通过此回调通知用户离开房间成功。
| ## 音频管理 | 方法 | 描述 | | --- | --- | | [muteAudioCapture](85516#IRTCEngine-muteaudiocapture) | 设置是否将录音信号静音（不改变本端硬件）。 | | [stopAudioPlaybackDeviceTest](85516#IAudioDeviceManager-stopaudioplaybackdevicetest) | 停止音频播放测试。 | | [startAudioPlaybackDeviceTest](85516#IAudioDeviceManager-startaudioplaybackdevicetest) | 启动音频播放设备检测。测试启动后，循环播放指定的音频文件，同时将通过 `onAudioPlaybackDeviceTestVolume` 回调播放时的音量信息。 | | [initAudioCaptureDeviceForTest](85516#IAudioDeviceManager-initaudiocapturedevicefortest) | 尝试初始化音频采集设备，可检测设备不存在、权限被拒绝/禁用等异常问题。 | | [initAudioPlaybackDeviceForTest](85516#IAudioDeviceManager-initaudioplaybackdevicefortest) | 尝试初始化音频播放设备，可检测出设备不存在、权限被拒绝/禁用等异常问题。 | | [getAudioCaptureDevice](85516#IAudioDeviceManager-getaudiocapturedevice) | 获取当前音频采集设备 ID。 | | [getAudioPlaybackDevice](85516#IAudioDeviceManager-getaudioplaybackdevice) | 获取当前音频播放设备 ID。 | | [getAudioCaptureDeviceMute](85516#IAudioDeviceManager-getaudiocapturedevicemute) | 获取当前音频采集设备是否静音的信息。 | | [setAudioCaptureDeviceMute](85516#IAudioDeviceManager-setaudiocapturedevicemute) | 设置当前音频采集设备静音状态，默认为非静音。 | | [getAudioPlaybackDeviceMute](85516#IAudioDeviceManager-getaudioplaybackdevicemute) | 获取当前音频播放设备是否静音的信息。 | | [setAudioPlaybackDeviceMute](85516#IAudioDeviceManager-setaudioplaybackdevicemute) | 设置当前音频播放设备静音状态，默认为非静音。 | | [getAudioCaptureDeviceVolume](85516#IAudioDeviceManager-getaudiocapturedevicevolume) | 获取当前音频采集设备音量 | | [setAudioCaptureDeviceVolume](85516#IAudioDeviceManager-setaudiocapturedevicevolume) | 设置当前音频采集设备音量 | | [getAudioPlaybackDeviceVolume](85516#IAudioDeviceManager-getaudioplaybackdevicevolume) | 获取当前音频播放设备音量 | | [setAudioPlaybackDeviceVolume](85516#IAudioDeviceManager-setaudioplaybackdevicevolume) | 设置当前音频播放设备音量 | | [setAudioCaptureDevice](85516#IAudioDeviceManager-setaudiocapturedevice) | 设置音频采集设备。 | | [setAudioPlaybackDevice](85516#IAudioDeviceManager-setaudioplaybackdevice) | 设置音频播放设备。 | | [followSystemCaptureDevice](85516#IAudioDeviceManager-followsystemcapturedevice) | 设置音频采集路由是否跟随系统。 | | [followSystemPlaybackDevice](85516#IAudioDeviceManager-followsystemplaybackdevice) | 设置音频播放路由是否跟随系统。 | | [enumerateAudioCaptureDevices](85516#IAudioDeviceManager-enumerateaudiocapturedevices) | 获取当前系统内音频采集设备列表。如果后续设备有变更，你需要重新调用本接口以获得新的设备列表。 | | [enumerateAudioPlaybackDevices](85516#IAudioDeviceManager-enumerateaudioplaybackdevices) | 获取当前系统内音频播放设备列表。如果后续设备有变更，你会收到 `onAudioMediaDeviceStateChanged` 回调通知，然后需要重新调用本接口以获得新的设备列表。 | | [setRemoteRoomAudioPlaybackVolume](85516#IGameRoom-setremoteroomaudioplaybackvolume) | 调节某个房间内所有远端用户的音频播放音量。 | | [enableAudioReceive](85516#IGameRoom-enableaudioreceive) | 是否接收某个特定用户的音频流。关闭声音接收不会影响扬声器或其他音频输出设备的状态。 | | [enableAudioSend](85516#IGameRoom-enableaudiosend) | 开始或停止发送音频流。调用此接口不影响音频采集。同房间其他用户会收到相应的回调。 | | [enableSpeakerphone](85516#IGameRoom-enablespeakerphone) | 开启或关闭扬声器。 | | [enableMicrophone](85516#IGameRoom-enablemicrophone) | 开始讲话或者停止讲话时调用，调用该接口启动或停止音频采集。同房间其他用户会收到
回调 [OnAudioDeviceStateChanged](85517#IRTCEngineEventHandler-onaudiodevicestatechanged) | | [buildAudioFrame](85516#buildaudioframe) | 创建 IAudioFrame | | [setAudioSelectionConfig](85516#IRTCRoom-setaudioselectionconfig) | 设置本端发布流在音频选路中的优先级。 | | [setRemoteRoomAudioPlaybackVolume](85516#IRTCRoom-setremoteroomaudioplaybackvolume) | 调节某个房间内所有远端用户的音频播放音量。 | | [startScreenAudioCapture](85516#IRTCEngine-startscreenaudiocapture) | 在屏幕共享时，开始使用 RTC SDK 内部采集方式，采集屏幕音频 | | [enablePlaybackDucking](85516#IRTCEngine-enableplaybackducking) | 打开/关闭音量闪避功能，适用于在 RTC 通话过程中会同时播放短视频或音乐的场景，如“一起看”等。
开启该功能后，当检测到远端人声时，RTC 的本地的媒体播放音量会自动减弱，从而保证远端人声的清晰可辨；当远端人声消失时，RTC 的本地媒体音量会恢复到闪避前的音量水平。 | | [enableVocalInstrumentBalance](85516#IRTCEngine-enablevocalinstrumentbalance) | 开启/关闭音量均衡功能。
开启音量均衡功能后，人声的响度会调整为 -16lufs。如果已调用 setAudioMixingLoudness 传入了混音音乐的原始响度，此音乐播放时，响度会调整为 -20lufs。（Linux 不支持） | | [setRemoteAudioPlaybackVolume](85516#IRTCEngine-setremoteaudioplaybackvolume) | 调节本端播放收到的远端流时的音量。你必须在进房后进行设置。流的发布状态改变不影响设置生效。 | | [enableAudioPropertiesReport](85516#IRTCEngine-enableaudiopropertiesreport) | 启用音频信息提示。开启提示后，你会收到 [onLocalAudioPropertiesReport](85517#IRTCEngineEventHandler-onlocalaudiopropertiesreport)，[onRemoteAudioPropertiesReport](85517#IRTCEngineEventHandler-onremoteaudiopropertiesreport) 和 [onActiveSpeaker](85517#IRTCEngineEventHandler-onactivespeaker)。 | | [stopScreenAudioCapture](85516#IRTCEngine-stopscreenaudiocapture) | 在屏幕共享时，停止使用 RTC SDK 内部采集方式，采集屏幕音频。 | | [enableExternalSoundCard](85516#IRTCEngine-enableexternalsoundcard) | 启用匹配外置声卡的音频处理模式 | | [getAudioDeviceManager](85516#IRTCEngine-getaudiodevicemanager) | 设备音频管理接口创建 | | [enableAGC](85516#IRTCEngine-enableagc) | 打开/关闭 AAGC（Analog Automatic Gain Control）模拟自动增益控制功能。
开启该功能后，SDK 会自动调节麦克风的采集音量，确保音量稳定。 | | [setAudioProfile](85516#IRTCEngine-setaudioprofile) | 设置音质档位。
当所选的 [RoomProfileType](85519#RoomProfileType) 中的音频参数无法满足你的场景需求时，调用本接口切换的音质档位。 | | [stopAudioCapture](85516#IRTCEngine-stopaudiocapture) | 立即关闭内部音频采集。默认为关闭状态。
内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。
调用该方法，本地用户会收到 [onAudioDeviceStateChanged](85517#IRTCEngineEventHandler-onaudiodevicestatechanged) 的回调。
非隐身用户进房后调用该方法后，房间中的其他用户会收到 [onUserStopAudioCapture](85517#IRTCEngineEventHandler-onuserstopaudiocapture) 的回调。 | | [startAudioCapture](85516#IRTCEngine-startaudiocapture) | 开启内部音频采集。默认为关闭状态。
内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。
调用该方法开启后，本地用户会收到 [onAudioDeviceStateChanged](85517#IRTCEngineEventHandler-onaudiodevicestatechanged) 的回调。
非隐身用户进房后调用该方法，房间中的其他用户会收到 [onUserStartAudioCapture](85517#IRTCEngineEventHandler-onuserstartaudiocapture) 的回调。 | | [setPlaybackVolume](85516#IRTCEngine-setplaybackvolume) | 调节本地播放的所有远端用户音频混音后的音量，混音内容包括远端人声、音乐、音效等。
播放音频前或播放音频时，你都可以使用此接口设定播放音量。 | | [setCaptureVolume](85516#IRTCEngine-setcapturevolume) | 调节麦克风音频采集音量。
只改变音频数据的音量信息，不涉及本端硬件的音量调节。 | | [muteScreenAudioCapture](85516#IRTCEngine-mutescreenaudiocapture) | 静音/取消静音屏幕共享时采集的音频。
调用此方法后，SDK 将发送静音数据来代替真实的屏幕音频数据，不影响本端音频设备的采集状态和 SDK 音频流的采集发布状态。 | | 回调 | 描述 | | --- | --- | | [onAudioStreamBanned](85517#IRTCRoomEventHandler-onaudiostreambanned) | 通过调用服务端 BanUserStream/UnbanUserStream 方法禁用/解禁指定房间内指定用户音频流的发送时，触发此回调。 | | [onStreamSyncInfoReceived](85517#IRTCEngineEventHandler-onstreamsyncinforeceived) | 音频流同步信息回调。可以通过此回调，在远端用户调用 [sendStreamSyncInfo](85516#IRTCEngine-sendstreamsyncinfo) 发送音频流同步消息后，收到远端发送的音频流同步信息。 | | [onActiveSpeaker](85517#IRTCEngineEventHandler-onactivespeaker) | 调用 [enableAudioPropertiesReport](85516#IRTCEngine-enableaudiopropertiesreport) 后，根据设置的 `config.interval`，你会周期性地收到此回调，获取房间内的最活跃用户信息。 | | [onUserStopAudioCapture](85517#IRTCEngineEventHandler-onuserstopaudiocapture) | 房间内的用户调用 [stopAudioCapture](85516#IRTCEngine-stopaudiocapture) 关闭音频采集时，房间内其他用户会收到此回调。 | | [onUserStartAudioCapture](85517#IRTCEngineEventHandler-onuserstartaudiocapture) | 房间内的用户调用 [startAudioCapture](85516#IRTCEngine-startaudiocapture) 开启音频采集时，房间内其他用户会收到此回调。 | | [onLocalAudioStateChanged](85517#IRTCEngineEventHandler-onlocalaudiostatechanged) | 本地音频流的状态发生改变时，收到此回调。 | | [onAudioDeviceVolumeChanged](85517#IRTCEngineEventHandler-onaudiodevicevolumechanged) | 音频设备音量改变回调。当通过系统设置，改变音频设备音量或静音状态时，触发本回调。本回调无需手动开启。 | | [onAudioPlaybackDeviceTestVolume](85517#IRTCEngineEventHandler-onaudioplaybackdevicetestvolume) | 回调音频设备测试时的播放音量 | | [onLocalAudioPropertiesReport](85517#IRTCEngineEventHandler-onlocalaudiopropertiesreport) | 调用 [enableAudioPropertiesReport](85516#IRTCEngine-enableaudiopropertiesreport) 后，根据设置的 interval 值，你会周期性地收到此回调，了解本地音频的瞬时相关信息。
本地音频包括使用 RTC SDK 内部机制采集的麦克风音频，屏幕音频和本地混音音频信息。 | | [onRemoteAudioPropertiesReport](85517#IRTCEngineEventHandler-onremoteaudiopropertiesreport) | 远端用户进房后，本地调用 [enableAudioPropertiesReport](85516#IRTCEngine-enableaudiopropertiesreport)，根据设置的 interval 值，本地会周期性地收到此回调，了解订阅的远端用户的瞬时音频信息。
远端用户的音频包括使用 RTC SDK 内部机制/自定义机制采集的麦克风音频和屏幕音频。 | | [onAudioDeviceWarning](85517#IRTCEngineEventHandler-onaudiodevicewarning) | 音频设备警告回调。音频设备包括音频采集设备和音频渲染设备。 | | [onAudioDeviceStateChanged](85517#IRTCEngineEventHandler-onaudiodevicestatechanged) | 音频设备状态回调。提示音频采集、音频播放等设备设备的状态。 | ## 视频管理 | 方法 | 描述 | | --- | --- | | [startVideoCapture](85516#IRTCEngine-startvideocapture) | 立即开启内部视频采集。默认为关闭状态。
内部视频采集指：使用 RTC SDK 内置视频采集模块，进行采集。
调用该方法后，本地用户会收到 [onVideoDeviceStateChanged](85517#IRTCEngineEventHandler-onvideodevicestatechanged) 的回调。
本地用户在非隐身状态下调用该方法后，房间中的其他用户会收到 [onUserStartVideoCapture](85517#IRTCEngineEventHandler-onuserstartvideocapture) 的回调。 | | [getVideoCaptureDevice](85516#IVideoDeviceManager-getvideocapturedevice) | 获取当前 SDK 正在使用的视频采集设备信息 | | [setVideoCaptureDevice](85516#IVideoDeviceManager-setvideocapturedevice) | 设置当前视频采集设备 | | [enumerateVideoCaptureDevices](85516#IVideoDeviceManager-enumeratevideocapturedevices) | 获取当前系统内视频采集设备列表。 | | [buildEncodedVideoFrame](85516#buildencodedvideoframe) | 创建 IEncodedVideoFrame | | [setRemoteVideoConfig](85516#IRTCRoom-setremotevideoconfig) | 设置期望订阅的远端视频流的参数。 | | [setRemoteSimulcastStreamType](85516#IRTCRoom-setremotesimulcaststreamtype) | 设置期望订阅的远端视频流类型。比如大流、中流、小流等。 | | [updateRemoteStreamVideoCanvas](85516#IRTCEngine-updateremotestreamvideocanvas) | 修改远端视频帧的渲染设置，包括渲染模式和背景颜色。 | | [getVideoDeviceManager](85516#IRTCEngine-getvideodevicemanager) | 创建视频设备管理实例 | | [updateRemoteStreamVideoCanvas](85516#IRTCEngine-updateremotestreamvideocanvas-2) | 使用 SDK 内部渲染时，修改远端视频帧的渲染设置，包括渲染模式、背景颜色和旋转角度。 | | [setRemoteVideoCanvas](85516#IRTCEngine-setremotevideocanvas) | 设置渲染指定视频流 `stream_key` 时，使用的视图和渲染模式。
如果需要解除某个用户的绑定视图，你可以把 `canvas` 设置为空。 | | [updateLocalVideoCanvas](85516#IRTCEngine-updatelocalvideocanvas) | 修改本地视频渲染模式和背景色。 | | [setLocalVideoCanvas](85516#IRTCEngine-setlocalvideocanvas) | 设置本地视频渲染时使用的视图，并设置渲染模式。 | | [setVideoEncoderConfig](85516#IRTCEngine-setvideoencoderconfig-2) | 发布端设置全景视频，包括分辨率、高清视野和低清背景分辨率、Tile 大小，以及其他常规编码参数。 | | [setVideoEncoderConfig](85516#IRTCEngine-setvideoencoderconfig) | 发布端设置期望发布的最大分辨率视频流参数，包括分辨率、帧率、码率、网络不佳时的回退策略等（包含摄像头和屏幕的编码配置）。 | | [setVideoCaptureConfig](85516#IRTCEngine-setvideocaptureconfig) | 设置 RTC SDK 内部采集时的视频采集参数。
如果你的项目使用了 SDK 内部采集模块，可以通过本接口指定视频采集参数，包括模式、分辨率、帧率。 | | [stopVideoCapture](85516#IRTCEngine-stopvideocapture) | 立即关闭内部视频采集。默认为关闭状态。
内部视频采集指：使用 RTC SDK 内置视频采集模块，进行采集。
调用该方法后，本地用户会收到 [onVideoDeviceStateChanged](85517#IRTCEngineEventHandler-onvideodevicestatechanged) 的回调。
非隐身用户进房后调用该方法，房间中的其他用户会收到 [onUserStopVideoCapture](85517#IRTCEngineEventHandler-onuserstopvideocapture) 的回调。 | | 回调 | 描述 | | --- | --- | | [onFaceDetectResult](85517#IFaceDetectionObserver-onfacedetectresult) | 特效 SDK 进行人脸检测结果的回调。
调用 [enableFaceDetection](85516#IVideoEffect-enablefacedetection) 注册了 [IFaceDetectionObserver](85517#IFaceDetectionObserver)，并使用 RTC SDK 中包含的特效 SDK 进行视频特效处理时，你会收到此回调。 | | [onLocalVideoStateChanged](85517#IRTCEngineEventHandler-onlocalvideostatechanged) | 本地视频流的状态发生改变时，收到该事件。 | | [onUserStopVideoCapture](85517#IRTCEngineEventHandler-onuserstopvideocapture) | 房间内的可见用户调用 [stopVideoCapture](85516#IRTCEngine-stopvideocapture) 关闭内部视频采集时，房间内其他用户会收到此回调。
若发布视频数据前未开启采集，房间内所有可见用户会收到此回调。 | | [onUserStartVideoCapture](85517#IRTCEngineEventHandler-onuserstartvideocapture) | 房间内的可见用户调用 [startVideoCapture](85516#IRTCEngine-startvideocapture) 开启内部视频采集时，房间内其他用户会收到此回调。 | | [onVideoDeviceWarning](85517#IRTCEngineEventHandler-onvideodevicewarning) | 视频设备警告回调，包括视频采集设备等。 | | [onVideoDeviceStateChanged](85517#IRTCEngineEventHandler-onvideodevicestatechanged) | 视频频设备状态回调。提示摄像头视频采集、屏幕视频采集等设备的状态。 | ## 音视频传输 | 方法 | 描述 | | --- | --- | | [publishStreamAudio](85516#IRTCRoom-publishstreamaudio) | 发布/取消发布音频流。 | | [requestRemoteVideoKeyFrame](85516#IRTCEngine-requestremotevideokeyframe) | 在订阅远端视频流之后，向远端请求关键帧 | | [resumeForwardStreamToAllRooms](85516#IRTCRoom-resumeforwardstreamtoallrooms) | 恢复跨房间媒体流转发。
调用 [pauseForwardStreamToAllRooms](85516#IRTCRoom-pauseforwardstreamtoallrooms) 暂停转发之后，调用本方法恢复向所有目标房间转发媒体流。 | | [pauseForwardStreamToAllRooms](85516#IRTCRoom-pauseforwardstreamtoallrooms) | 暂停跨房间媒体流转发。
通过 [startForwardStreamToRooms](85516#IRTCRoom-startforwardstreamtorooms) 发起媒体流转发后，可调用本方法暂停向所有目标房间转发媒体流。
调用本方法暂停向所有目标房间转发后，你可以随时调用 [resumeForwardStreamToAllRooms](85516#IRTCRoom-resumeforwardstreamtoallrooms) 快速恢复转发。 | | [stopForwardStreamToRooms](85516#IRTCRoom-stopforwardstreamtorooms) | 停止跨房间媒体流转发。
通过 [startForwardStreamToRooms](85516#IRTCRoom-startforwardstreamtorooms) 发起媒体流转发后，可调用本方法停止向所有目标房间转发媒体流。 | | [updateForwardStreamToRooms](85516#IRTCRoom-updateforwardstreamtorooms) | 更新跨房间媒体流转发信息。
通过 [startForwardStreamToRooms](85516#IRTCRoom-startforwardstreamtorooms) 发起媒体流转发后，可调用本方法增加或者减少目标房间，或更新房间密钥。
调用本方法增加或删减房间后，将在本端触发 [onForwardStreamStateChanged](85517#IRTCRoomEventHandler-onforwardstreamstatechanged) 回调，包含发生了变动的目标房间中媒体流转发状态。 | | [startForwardStreamToRooms](85516#IRTCRoom-startforwardstreamtorooms) | 开始跨房间转发媒体流。
在调用 [joinRoom](85516#IRTCRoom-joinroom) 后调用本接口，实现向多个房间转发媒体流，适用于跨房间连麦等场景。 | | [setMultiDeviceAVSync](85516#IRTCRoom-setmultideviceavsync) | 设置发流端音画同步。
当同一用户同时使用两个通话设备分别采集发送音频和视频时，有可能会因两个设备所处的网络环境不一致而导致发布的流不同步，此时你可以在视频发送端调用该接口，SDK 会根据音频流的时间戳自动校准视频流，以保证接收端听到音频和看到视频在时间上的同步性。 | | [resumeAllSubscribedStreamAudio](85516#IRTCRoom-resumeallsubscribedstreamaudio) | 恢复接收所有远端音频流。 | | [resumeAllSubscribedStreamVideo](85516#IRTCRoom-resumeallsubscribedstreamvideo) | 恢复接收所有远端视频流。 | | [pauseAllSubscribedStreamAudio](85516#IRTCRoom-pauseallsubscribedstreamaudio) | 暂停接收所有远端音频流。 | | [pauseAllSubscribedStreamVideo](85516#IRTCRoom-pauseallsubscribedstreamvideo) | 暂停接收所有远端视频流。 | | [subscribeAllStreamsAudio](85516#IRTCRoom-subscribeallstreamsaudio) | 订阅/取消订阅房间内所有远端音频流（通过麦克风采集的）。 | | [subscribeAllStreamsVideo](85516#IRTCRoom-subscribeallstreamsvideo) | 订阅/取消订阅房间内所有远端视频流（通过摄像头采集的）。 | | [setStreamExtraInfo](85516#IRTCRoom-setstreamextrainfo) | 设置当前推流的流附加信息。 | | [subscribeStreamAudio](85516#IRTCRoom-subscribestreamaudio) | 订阅/取消订阅房间内指定的远端音频流。 | | [publishStreamVideo](85516#IRTCRoom-publishstreamvideo) | 发布/取消发布视频流。 | | [setDummyCaptureImagePath](85516#IRTCEngine-setdummycaptureimagepath) | 摄像头处于关闭状态时，使用静态图片填充本地推送的视频流。
调用 `stopVideoCapture` 接口时，会开始推静态图片。若要停止发送图片，可传入空字符串或启用内部摄像头采集。
可重复调用该接口来更新图片。 | | [subscribeStreamVideo](85516#IRTCRoom-subscribestreamvideo) | 订阅/取消订阅房间内指定的远端视频流。 | | 回调 | 描述 | | --- | --- | | [onVideoPublishStateChanged](85517#IRTCRoomEventHandler-onvideopublishstatechanged) | 视频发布状态改变回调。 | | [onFirstLocalAudioFrame](85517#IRTCEngineEventHandler-onfirstlocalaudioframe) | 发布音频流时，采集到第一帧音频帧，收到该回调。 | | [onVideoFramePlayStateChanged](85517#IRTCEngineEventHandler-onvideoframeplaystatechanged) | 远端视频流的首帧播放状态改变时，收到此回调。 | | [onAudioFramePlayStateChanged](85517#IRTCEngineEventHandler-onaudioframeplaystatechanged) | 音频首帧播放状态发生改变时，收到此回调。 | | [onFirstRemoteVideoFrameDecoded](85517#IRTCEngineEventHandler-onfirstremotevideoframedecoded) | 订阅端接收并解码远端视频流首帧时，收到此回调。包含以下情况：

发布端发布视频，包含首次发布和取消后再次发布。取消发布还包括发布端主动退房后或掉线。
发布端关闭视频采集后，再次打开采集。使用外部源时，停止推流后再次推流。
发布端发布视频后，订阅端取消订阅视频后，又再次订阅视频。

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

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

| | [onVideoFrameSendStateChanged](85517#IRTCEngineEventHandler-onvideoframesendstatechanged) | 本地视频首帧发送状态发生改变时，收到此回调。 | | [onAudioFrameSendStateChanged](85517#IRTCEngineEventHandler-onaudioframesendstatechanged) | 本地音频首帧发送状态发生改变时，收到此回调。 | | [onRemoteVideoStateChanged](85517#IRTCEngineEventHandler-onremotevideostatechanged) | 远端视频流的状态发生改变时，房间内订阅此流的用户会收到该事件。 | | [onRemoteAudioStateChanged](85517#IRTCEngineEventHandler-onremoteaudiostatechanged) | 用户订阅来自远端的音频流状态发生改变时，会收到此回调，了解当前的远端音频流状态。 | | [onFirstRemoteAudioFrame](85517#IRTCEngineEventHandler-onfirstremoteaudioframe) | 订阅端接收并解码远端音频流首帧时，收到此回调。包含以下情况：

发布端发布音频，包含首次发布和取消后再次发布。取消发布还包括发布端主动退房后或掉线。
发布端关闭音频采集后，再次打开采集。使用外部源时，停止推流后再次推流。
发布端发布音频后，订阅端取消订阅音频后，又再次订阅音频。

| | [onFirstLocalVideoFrameCaptured](85517#IRTCEngineEventHandler-onfirstlocalvideoframecaptured) | RTC SDK 在本地完成第一帧视频帧或屏幕视频帧采集时，收到此回调。 | | [onRemoteVideoSizeChanged](85517#IRTCEngineEventHandler-onremotevideosizechanged) | 远端视频大小或旋转信息发生改变时，房间内订阅此视频流的用户会收到此回调。 | | [onLocalVideoSizeChanged](85517#IRTCEngineEventHandler-onlocalvideosizechanged) | 本地视频大小或旋转信息发生改变时，收到此回调。 | | [onAVSyncEvent](85517#IRTCRoomEventHandler-onavsyncevent) | 发布端调用 [setMultiDeviceAVSync](85516#IRTCRoom-setmultideviceavsync) 后音视频同步状态发生错误时，会收到此回调。 | | [onNetworkQuality](85517#IRTCRoomEventHandler-onnetworkquality) | 加入房间并发布或订阅流后，以每 2 秒一次的频率，报告本地用户和已订阅的远端用户的上下行网络质量信息。 | | [onForwardStreamEvent](85517#IRTCRoomEventHandler-onforwardstreamevent) | 跨房间媒体流转发事件回调 | | [onForwardStreamStateChanged](85517#IRTCRoomEventHandler-onforwardstreamstatechanged) | 跨房间媒体流转发状态和错误回调 | | [onAVSyncStateChange](85517#IRTCRoomEventHandler-onavsyncstatechange) | 发布端调用 [setMultiDeviceAVSync](85516#IRTCRoom-setmultideviceavsync) 后音视频同步状态发生改变时，会收到此回调。 | | [onVideoStreamBanned](85517#IRTCRoomEventHandler-onvideostreambanned) | 通过调用服务端 BanUserStream/UnbanUserStream 方法禁用/解禁指定房间内指定用户视频流的发送时，触发此回调。 | | [onUserPublishStreamVideo](85517#IRTCRoomEventHandler-onuserpublishstreamvideo) | 房间内远端用户发布或取消发布视频流的回调。 | | [onUserPublishStreamAudio](85517#IRTCRoomEventHandler-onuserpublishstreamaudio) | 房间内远端用户发布或取消发布音频流的回调。 | | [onRemoteStreamStats](85517#IRTCRoomEventHandler-onremotestreamstats) | 本地订阅的远端音/视频流数据统计以及网络质量回调。
本地用户订阅流成功后，SDK 会周期性（2s）的通过此回调事件通知用户订阅的流在此次统计周期内的质量统计信息，包括：发送音视频比特率、发送帧率、编码帧率，网络质量等。 | | [onAudioSubscribeStateChanged](85517#IRTCRoomEventHandler-onaudiosubscribestatechanged) | 音频订阅状态发生改变回调。 | | [onVideoSubscribeStateChanged](85517#IRTCRoomEventHandler-onvideosubscribestatechanged) | 视频订阅状态发生改变回调。 | | [onAudioPublishStateChanged](85517#IRTCRoomEventHandler-onaudiopublishstatechanged) | 音频发布状态改变回调。 | ## 音频处理 | 方法 | 描述 | | --- | --- | | [setLocalVoicePitch](85516#IRTCEngine-setlocalvoicepitch) | 开启本地语音变调功能，多用于 K 歌场景。
使用该方法，你可以对本地语音的音调进行升调或降调等调整。 | ## 视频处理 | 方法 | 描述 | | --- | --- | | [initCVResource](85516#IVideoEffect-initcvresource) | 检查视频特效证书，设置算法模型路径，并初始化特效模块。 | | [setLowLightAdjusted](85516#IRTCEngine-setlowlightadjusted) | 设置视频暗光增强模式。
对于光线不足、照明不均匀或背光等场景下推荐开启，可有效改善画面质量。 | | [clearVideoWatermark](85516#IRTCEngine-clearvideowatermark) | 移除指定视频流的水印。 | | [setVideoWatermark](85516#IRTCEngine-setvideowatermark) | 在指定视频流上添加水印。 | | [stopVideoDigitalZoomControl](85516#IRTCEngine-stopvideodigitalzoomcontrol) | 停止本地摄像头持续数码变焦。 | | [startVideoDigitalZoomControl](85516#IRTCEngine-startvideodigitalzoomcontrol) | 开启本地摄像头持续数码变焦，缩放或移动。设置对本地预览画面和发布到远端的视频都生效。 | | [setVideoDigitalZoomControl](85516#IRTCEngine-setvideodigitalzoomcontrol) | 控制本地摄像头数码变焦，缩放或移动一次。设置对本地预览画面和发布到远端的视频都生效。 | | [setVideoDigitalZoomConfig](85516#IRTCEngine-setvideodigitalzoomconfig) | 设置本地摄像头数码变焦参数，包括缩放倍数，移动步长。 | | [getVideoEffectInterface](85516#IRTCEngine-getvideoeffectinterface) | 获取视频特效接口。 | | [setRemoteVideoMirrorType](85516#IRTCEngine-setremotevideomirrortype) | 使用内部渲染时，为远端流开启镜像。 | | [setVideoCaptureRotation](85516#IRTCEngine-setvideocapturerotation) | 设置本端采集的视频帧的旋转角度。
当摄像头倒置或者倾斜安装时，可调用本接口进行调整。 | | [disableFaceDetection](85516#IVideoEffect-disablefacedetection) | 关闭人脸识别功能。 | | [enableFaceDetection](85516#IVideoEffect-enablefacedetection) | 开启人脸识别功能，并设置人脸检测结果回调观察者。
此观察者后，你会周期性收到 [onFaceDetectResult](85517#IFaceDetectionObserver-onfacedetectresult) 回调。 | | [setColorFilterIntensity](85516#IVideoEffect-setcolorfilterintensity) | 设置已启用颜色滤镜的强度。 | | [setColorFilter](85516#IVideoEffect-setcolorfilter) | 设置颜色滤镜。 | | [updateEffectNode](85516#IVideoEffect-updateeffectnode) | 设置特效强度。 | | [setEffectNodes](85516#IVideoEffect-seteffectnodes) | 设置视频特效素材包。 | | [disableVideoEffect](85516#IVideoEffect-disablevideoeffect) | 关闭视频特效。 | | [enableVideoEffect](85516#IVideoEffect-enablevideoeffect) | 开启高级美颜、滤镜等视频特效。 | | [freeAuthMessage](85516#IVideoEffect-freeauthmessage) | 使用完授权消息字符串后，释放内存。 | | [getAuthMessage](85516#IVideoEffect-getauthmessage) | 从特效 SDK 获取授权消息，用于获取在线许可证。 | ## 自定义流处理 | 方法 | 描述 | | --- | --- | | [setAudioSourceType](85516#IRTCEngine-setaudiosourcetype) | 切换音频采集方式 | | [processVideoFrame](85516#IVideoProcessor-processvideoframe) | 获取 RTC SDK 采集得到的视频帧，根据 [registerLocalVideoProcessor](85516#IRTCEngine-registerlocalvideoprocessor) 设置的视频前处理器，进行视频前处理，最终将处理后的视频帧给到 RTC SDK 用于编码传输。 | | [setRemoteVideoSink](85516#IRTCEngine-setremotevideosink) | 将远端视频流与自定义渲染器绑定。 | | [setLocalVideoSink](85516#IRTCEngine-setlocalvideosink) | 将本地视频流与自定义渲染器绑定。 | | [setVideoDecoderConfig](85516#IRTCEngine-setvideodecoderconfig) | 在订阅远端视频流之前，设置远端视频数据解码方式 | | [pushExternalEncodedVideoFrame](85516#IRTCEngine-pushexternalencodedvideoframe) | 推送自定义编码后的视频流 | | [setExternalVideoEncoderEventHandler](85516#IRTCEngine-setexternalvideoencodereventhandler) | 注册自定义编码帧推送事件回调 | | [registerRemoteEncodedVideoFrameObserver](85516#IRTCEngine-registerremoteencodedvideoframeobserver) | 注册远端编码后视频数据回调。
完成注册后，当 SDK 监测到远端编码后视频帧时，会触发 [onRemoteEncodedVideoFrame](85517#IRemoteEncodedVideoFrameObserver-onremoteencodedvideoframe) 回调 | | [registerLocalEncodedVideoFrameObserver](85516#IRTCEngine-registerlocalencodedvideoframeobserver) | 注册本地视频帧监测器。
无论使用内部采集还是自定义采集，调用该方法后，SDK 每监测到一帧本地视频帧时，都会将视频帧信息通过 [onLocalEncodedVideoFrame](85517#ILocalEncodedVideoFrameObserver-onlocalencodedvideoframe) 回调给用户 | | [registerLocalVideoProcessor](85516#IRTCEngine-registerlocalvideoprocessor) | 设置自定义视频前处理器。
使用这个视频前处理器，你可以调用 [processVideoFrame](85516#IVideoProcessor-processvideoframe) 对 RTC SDK 采集得到的视频帧进行前处理，并将处理后的视频帧用于 RTC 音视频通信。 | | [disableAudioProcessor](85516#IRTCEngine-disableaudioprocessor) | 关闭自定义音频处理。 | | [enableAudioProcessor](85516#IRTCEngine-enableaudioprocessor) | 设置并开启指定的音频帧回调，进行自定义处理。 | | [registerAudioProcessor](85516#IRTCEngine-registeraudioprocessor) | 注册自定义音频处理器。
注册完成后，你可以调用 [enableAudioProcessor](85516#IRTCEngine-enableaudioprocessor)，对本地采集到的音频进行处理，RTC SDK 将对处理后的音频进行编码和发送。也可以对接收到的远端音频进行自定义处理，RTC SDK 将对处理后的音频进行渲染。 | | [registerAudioFrameObserver](85516#IRTCEngine-registeraudioframeobserver) | 注册音频数据回调观察者。 | | [disableAudioFrameCallback](85516#IRTCEngine-disableaudioframecallback) | 关闭音频回调 | | [enableAudioFrameCallback](85516#IRTCEngine-enableaudioframecallback) | 设置并开启指定的音频数据帧回调 | | [pushExternalVideoFrame](85516#IRTCEngine-pushexternalvideoframe) | 推送外部视频帧。 | | [setVideoSourceType](85516#IRTCEngine-setvideosourcetype) | 设置向 SDK 输入的视频源，包括屏幕流
默认使用内部采集。内部采集指：使用 RTC SDK 内置的视频采集机制进行视频采集。 | | [setLocalVideoSink](85516#IRTCEngine-setlocalvideosink-2) | 将本地视频流与自定义渲染器绑定。你可以通过参数设置返回指定位置和格式的视频帧数据。 | | [pushExternalAudioFrame](85516#IRTCEngine-pushexternalaudioframe) | 推送自定义采集的音频数据到 RTC SDK。 | | [setRemoteVideoSink](85516#IRTCEngine-setremotevideosink-2) | 将远端视频流与自定义渲染器绑定。你可以通过参数设置返回指定位置和格式的视频帧数据。 | | [setAudioRenderType](85516#IRTCEngine-setaudiorendertype) | 切换音频渲染方式 | | [pullExternalAudioFrame](85516#IRTCEngine-pullexternalaudioframe) | 拉取下行音频数据用于自定义音频渲染。
调用该方法后，SDK 会主动拉取待播放的音频数据，包括远端已解码和混音后的音频数据，用于外部播放。 | | 回调 | 描述 | | --- | --- | | [onRemoteEncodedVideoFrame](85517#IRemoteEncodedVideoFrameObserver-onremoteencodedvideoframe) | 调用 [registerRemoteEncodedVideoFrameObserver](85516#IRTCEngine-registerremoteencodedvideoframeobserver) 后，SDK 监测到远端编码后视频数据时，触发该回调 | | [onLocalEncodedVideoFrame](85517#ILocalEncodedVideoFrameObserver-onlocalencodedvideoframe) | 调用 [registerLocalEncodedVideoFrameObserver](85516#IRTCEngine-registerlocalencodedvideoframeobserver) 后，SDK 每次使用内部采集，采集到一帧视频帧，或收到一帧外部视频帧时，都会回调该事件。 | | [onProcessScreenAudioFrame](85517#IAudioFrameProcessor-onprocessscreenaudioframe) | 屏幕共享的音频帧地址回调。你可根据此回调自定义处理音频。 | | [onProcessRemoteUserAudioFrame](85517#IAudioFrameProcessor-onprocessremoteuseraudioframe) | 回调单个远端用户的音频帧地址，供自定义音频处理。 | | [onProcessPlayBackAudioFrame](85517#IAudioFrameProcessor-onprocessplaybackaudioframe) | 回调远端音频混音的音频帧地址，供自定义音频处理。 | | [onProcessRecordAudioFrame](85517#IAudioFrameProcessor-onprocessrecordaudioframe) | 回调本地采集的音频帧地址，供自定义音频处理。 | | [onCaptureMixedAudioFrame](85517#IAudioFrameObserver-oncapturemixedaudioframe) | 返回本地麦克风录制的音频数据，本地 `MediaPlayer` / `EffectPlayer` 播放音频文件混音后的音频数据 | | [onRecordScreenAudioFrame](85517#IAudioFrameObserver-onrecordscreenaudioframe) | 返回本地屏幕录制的音频数据 | | [onMixedAudioFrame](85517#IAudioFrameObserver-onmixedaudioframe) | 返回本地麦克风录制和订阅的所有远端用户混音后的音频数据 | | [onRemoteUserAudioFrame](85517#IAudioFrameObserver-onremoteuseraudioframe) | 返回远端单个用户的音频数据 | | [onPlaybackAudioFrame](85517#IAudioFrameObserver-onplaybackaudioframe) | 返回订阅的所有远端用户混音后的音频数据。 | | [onRecordAudioFrame](85517#IAudioFrameObserver-onrecordaudioframe) | 返回麦克风录制的音频数据 | | [onActiveVideoLayer](85517#IExternalVideoEncoderEventHandler-onactivevideolayer) | 作为自定义编码视频流的发送端，你会在视频流可发送状态发生变化时，收到此回调。
你可以根据此回调的提示，仅对可发送的视频流进行编码，以降低本端视频编码性能消耗。此回调会根据多个因素综合判断触发，包括：本端设备性能和本端网络性能，以及按需订阅场景下，远端用户是否订阅。 | | [onRequestKeyFrame](85517#IExternalVideoEncoderEventHandler-onrequestkeyframe) | 提示流发布端需重新生成关键帧的回调 | | [onRateUpdate](85517#IExternalVideoEncoderEventHandler-onrateupdate) | 当自定义编码流的帧率或码率发生变化时，触发该回调 | | [onStop](85517#IExternalVideoEncoderEventHandler-onstop) | 当收到该回调时，你需停止向 SDK 推送自定义编码视频帧 | | [onStart](85517#IExternalVideoEncoderEventHandler-onstart) | 提示自定义编码帧可以开始推送的回调。
收到该回调后，你即可调用 [pushExternalEncodedVideoFrame](85516#IRTCEngine-pushexternalencodedvideoframe) 向 SDK 推送自定义编码视频帧 | ## 网络管理 | 方法 | 描述 | | --- | --- | | [setLocalSimulcastMode](85516#IRTCEngine-setlocalsimulcastmode) | 发布端进行大小流(simulcast)设置。 | | [stopNetworkDetection](85516#IRTCEngine-stopnetworkdetection) | 停止通话前网络探测 | | [startNetworkDetection](85516#IRTCEngine-startnetworkdetection) | 开启通话前网络探测 | | [setRemoteUserPriority](85516#IRTCEngine-setremoteuserpriority) | 设置用户优先级。 | | [setSubscribeFallbackOption](85516#IRTCEngine-setsubscribefallbackoption) | 设置订阅的音视频流的回退选项。
你可调用该接口设置网络不佳或设备性能不足时允许订阅流进行降级或只订阅音频流，以保证通话流畅。 | | [setPublishFallbackOption](85516#IRTCEngine-setpublishfallbackoption) | 设置发布的音视频流的回退选项。
你可以调用该接口设置网络不佳或设备性能不足时从大流起进行降级处理，以保证通话质量。 | | [setLocalSimulcastMode](85516#IRTCEngine-setlocalsimulcastmode-2) | 发布端开启大小流(simulcast)功能。 | | 回调 | 描述 | | --- | --- | | [onConnectionStateChanged](85517#IRTCEngineEventHandler-onconnectionstatechanged) | SDK 与信令服务器连接状态改变回调。连接状态改变时触发。 | | [onNetworkDetectionStopped](85517#IRTCEngineEventHandler-onnetworkdetectionstopped) | 通话前网络探测结束
以下情况将停止探测并收到本一次本回调：

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

| | [onNetworkDetectionResult](85517#IRTCEngineEventHandler-onnetworkdetectionresult) | 通话前网络探测结果。
成功调用 [startNetworkDetection](85516#IRTCEngine-startnetworkdetection) 接口开始探测后，会在 3s 内首次收到该回调，之后每 2s 收到一次该回调。 | | [onSEIMessageReceived](85517#IRTCEngineEventHandler-onseimessagereceived) | 收到通过调用 [sendSEIMessage](85516#IRTCEngine-sendseimessage) 发送带有 SEI 消息的视频帧时，收到此回调。 | | [onPerformanceAlarms](85517#IRTCEngineEventHandler-onperformancealarms) | 本地未通过 [setPublishFallbackOption](85516#IRTCEngine-setpublishfallbackoption) 开启发布性能回退，检测到设备性能不足时，收到此回调。
本地通过 [setPublishFallbackOption](85516#IRTCEngine-setpublishfallbackoption) 开启发布性能回退，因设备性能/网络原因，造成发布性能回退/恢复时，收到此回调。 | | [onSimulcastSubscribeFallback](85517#IRTCEngineEventHandler-onsimulcastsubscribefallback) | 音视频流因网络环境变化等原因发生回退，或从回退中恢复时，触发该回调。 | | [onNetworkTypeChanged](85517#IRTCEngineEventHandler-onnetworktypechanged) | SDK 当前网络连接类型改变回调。当 SDK 的当前网络连接类型发生改变时回调该事件。 | ## 消息 | 方法 | 描述 | | --- | --- | | [sendSEIMessage](85516#IRTCEngine-sendseimessage) | 通过视频帧发送 SEI 数据。
在视频通话场景下，SEI 数据会随视频帧发送；在语音通话场景下，SDK 会自动生成一路 16px × 16px 的黑帧视频流用来发送 SEI 数据。
语音通话场景下，该值需设为 `kStreamIndexMain`，否则 SEI 数据会被丢弃从而无法送达远端。 | | [sendUserBinaryMessage](85516#IRTSRoom-senduserbinarymessage) | 给房间内指定的用户发送点对点二进制消息（P2P）。 | | [sendUserMessage](85516#IRTSRoom-sendusermessage) | 给房间内指定的用户发送点对点文本消息（P2P）。 | | [sendRoomBinaryMessage](85516#IRTSRoom-sendroombinarymessage) | 给房间内的所有其他用户发送广播消息。 | | [sendRoomMessage](85516#IRTSRoom-sendroommessage) | 给房间内的所有其他用户发送广播消息。 | | [sendStreamSyncInfo](85516#IRTCEngine-sendstreamsyncinfo) | 发送音频流同步信息。将消息通过音频流发送到远端，并实现与音频流同步，该接口调用成功后，远端用户会收到 [onStreamSyncInfoReceived](85517#IRTCEngineEventHandler-onstreamsyncinforeceived) 回调。 | | [sendServerBinaryMessage](85516#IRTCEngine-sendserverbinarymessage) | 客户端给应用服务器发送二进制消息（P2Server） | | [sendServerMessage](85516#IRTCEngine-sendservermessage) | 客户端给应用服务器发送文本消息（P2Server） | | [sendUserBinaryMessageOutsideRoom](85516#IRTCEngine-senduserbinarymessageoutsideroom) | 给房间外指定的用户发送二进制消息（P2P） | | [sendUserMessageOutsideRoom](85516#IRTCEngine-sendusermessageoutsideroom) | 给房间外指定的用户发送文本消息（P2P） | | [getPeerOnlineStatus](85516#IRTCEngine-getpeeronlinestatus) | 查询对端用户或本端用户的登录状态 | | [setServerParams](85516#IRTCEngine-setserverparams) | 设置应用服务器参数
客户端调用 [sendServerMessage](85516#IRTCEngine-sendservermessage) 或 [sendServerBinaryMessage](85516#IRTCEngine-sendserverbinarymessage) 发送消息给应用服务器之前，必须设置有效签名和应用服务器地址。 | | [updateLoginToken](85516#IRTCEngine-updatelogintoken) | 更新用户用于登录的 Token
Token 有一定的有效期，当 Token 过期时，需调用此方法更新登录的 Token 信息。
调用 [login](85516#IRTCEngine-login) 方法登录时，如果使用了过期的 Token 将导致登录失败，并会收到 [onLoginResult](85517#IRTCEngineEventHandler-onloginresult) 回调通知，错误码为 kLoginErrorCodeInvalidToken。此时需要重新获取 Token，并调用此方法更新 Token。 | | [logout](85516#IRTCEngine-logout) | 登出 RTS 服务器。
调用本接口登出后，无法调用房间外消息以及端到服务器消息相关的方法或收到相关回调。 | | [login](85516#IRTCEngine-login) | 登录 RTS 服务器。
必须先登录，才能调用 [sendUserMessageOutsideRoom](85516#IRTCEngine-sendusermessageoutsideroom) 和 [sendServerMessage](85516#IRTCEngine-sendservermessage) 发送房间外点对点消息和向应用服务器发送消息
在调用本接口登录后，如果想要登出，需要调用 [logout](85516#IRTCEngine-logout)。 | | 回调 | 描述 | | --- | --- | | [onRoomMessageReceived](85517#IRTSRoomEventHandler-onroommessagereceived) | 接收到房间内广播消息的回调。 | | [onSEIStreamUpdate](85517#IRTCEngineEventHandler-onseistreamupdate) | 黑帧视频流发布状态回调。
在语音通话场景下，本地用户调用 [sendSEIMessage](85516#IRTCEngine-sendseimessage) 通过黑帧视频流发送 SEI 数据时，流的发送状态会通过该回调通知远端用户。
你可以通过此回调判断携带 SEI 数据的视频帧为黑帧，从而不对该视频帧进行渲染。 | | [onServerMessageSendResult](85517#IRTCEngineEventHandler-onservermessagesendresult) | 给应用服务器发送消息的回调。 | | [onUserBinaryMessageReceivedOutsideRoom](85517#IRTCEngineEventHandler-onuserbinarymessagereceivedoutsideroom-2) | 当收到来自房间外用户通过 [sendUserBinaryMessageOutsideRoom](85516#IRTCEngine-senduserbinarymessageoutsideroom) 发送的二进制消息时，触发此回调。 | | [onUserMessageReceivedOutsideRoom](85517#IRTCEngineEventHandler-onusermessagereceivedoutsideroom-2) | 收到房间外用户调用 [sendUserMessageOutsideRoom](85516#IRTCEngine-sendusermessageoutsideroom) 发来的文本消息时，会收到此回调。 | | [onUserMessageSendResultOutsideRoom](85517#IRTCEngineEventHandler-onusermessagesendresultoutsideroom) | 给房间外指定的用户发送消息的结果回调。
当调用 [sendUserMessageOutsideRoom](85516#IRTCEngine-sendusermessageoutsideroom) 或 [sendUserBinaryMessageOutsideRoom](85516#IRTCEngine-senduserbinarymessageoutsideroom) 发送消息后，会收到此回调。 | | [onUserBinaryMessageReceivedOutsideRoom](85517#IRTCEngineEventHandler-onuserbinarymessagereceivedoutsideroom) | > 该接口将于 3.64 [onUserBinaryMessageReceivedOutsideRoom](85517#IRTCEngineEventHandler-onuserbinarymessagereceivedoutsideroom-2) 代替。
收到房间外用户调用 [sendUserBinaryMessageOutsideRoom](85516#IRTCEngine-senduserbinarymessageoutsideroom) 发来的二进制消息时，会收到此回调 | | [onUserMessageReceivedOutsideRoom](85517#IRTCEngineEventHandler-onusermessagereceivedoutsideroom) | > 该接口将于 3.64 版本废弃，请使用 [onUserMessageReceivedOutsideRoom](85517#IRTCEngineEventHandler-onusermessagereceivedoutsideroom-2) 代替。
收到房间外用户调用 [sendUserMessageOutsideRoom](85516#IRTCEngine-sendusermessageoutsideroom) 发来的文本消息时，会收到此回调。 | | [onGetPeerOnlineStatus](85517#IRTCEngineEventHandler-ongetpeeronlinestatus) | 查询对端或本端用户登录状态的返回结果 | | [onServerParamsSetResult](85517#IRTCEngineEventHandler-onserverparamssetresult) | 设置应用服务器参数的返回结果 | | [onLogout](85517#IRTCEngineEventHandler-onlogout) | 登出结果回调 | | [onLoginResult](85517#IRTCEngineEventHandler-onloginresult) | 登录结果回调 | | [onUserBinaryMessageReceived](85517#IRTSRoomEventHandler-onuserbinarymessagereceived-2) | 收到来自房间中其他用户通过 [sendUserBinaryMessage](85516#IRTSRoom-senduserbinarymessage) 发来的点对点二进制消息时，会收到此回调。 | | [onUserMessageReceived](85517#IRTSRoomEventHandler-onusermessagereceived-2) | 收到来自房间中其他用户通过 [sendUserMessage](85516#IRTSRoom-sendusermessage) 发来的点对点文本消息时，会收到此回调。 | | [onRoomBinaryMessageReceived](85517#IRTSRoomEventHandler-onroombinarymessagereceived-2) | 收到房间内广播二进制消息的回调。
房间内其他用户调用 [sendRoomBinaryMessage](85516#IRTSRoom-sendroombinarymessage) 发送广播二进制消息时，收到此回调。 | | [onRoomMessageReceived](85517#IRTSRoomEventHandler-onroommessagereceived-2) | 接收到房间内广播消息的回调。
同一房间内其他用户调用 [sendUserMessage](85516#IRTSRoom-sendusermessage) 发送广播消息时会收到该回调。 | | [onUserMessageSendResult](85517#IRTSRoomEventHandler-onusermessagesendresult) | 向房间内单个用户发送文本或二进制消息后（P2P），消息发送方会收到该消息发送结果回调。 | | [onUserBinaryMessageReceived](85517#IRTSRoomEventHandler-onuserbinarymessagereceived) | 收到来自房间中其他用户通过 [sendUserBinaryMessage](85516#IRTSRoom-senduserbinarymessage) 发来的点对点二进制消息时，会收到此回调。
> 该接口将于 3.64 [onUserBinaryMessageReceived](85517#IRTSRoomEventHandler-onuserbinarymessagereceived-2) 代替。 | | [onUserMessageReceived](85517#IRTSRoomEventHandler-onusermessagereceived) | > 该接口将于 3.64 [onUserMessageReceived](85517#IRTSRoomEventHandler-onusermessagereceived-2) 代替。
收到来自房间中其他用户通过 [sendUserMessage](85516#IRTSRoom-sendusermessage) 发来的点对点文本消息时，会收到此回调。 | | [onRoomMessageSendResult](85517#IRTSRoomEventHandler-onroommessagesendresult) | 当调用 [sendRoomMessage](85516#IRTSRoom-sendroommessage) 函数发送消息后，回调此条消息的发送结果（反馈）。 | | [onRoomBinaryMessageReceived](85517#IRTSRoomEventHandler-onroombinarymessagereceived) | 接收到房间内二进制广播消息的回调。 | ## 推流至 WTN | 方法 | 描述 | | --- | --- | | [subscribeWTNVideoStream](85516#IWTNStream-subscribewtnvideostream) | 订阅/取消订阅指定 WTN 视频流
无论用户是否在房间内，都可以调用本接口订阅/取消订阅指定的 WTN 视频流。 | | [getWTNStream](85516#IRTCEngine-getwtnstream) | 获取 WTN 流对象。
你可以通过此方法获取 WTN 流对象，以实现自定义的视频渲染和处理。
调用此方法前，需先调用 enableWTNStream 开启 WTN 流。 | | [subscribeWTNAudioStream](85516#IWTNStream-subscribewtnaudiostream) | 订阅/取消订阅指定 WTN 音频流
无论用户是否在房间内，都可以调用本接口订阅/取消订阅指定的 WTN 音频流。 | | [setWTNRemoteVideoCanvas](85516#IWTNStream-setwtnremotevideocanvas) | 为指定 WTN 流绑定内部渲染视图 | | [setWTNRemoteVideoSink](85516#IWTNStream-setwtnremotevideosink) | 为指定 WTN 流绑定自定义渲染器。详见[自定义视频渲染](https://www.volcengine.com/docs/6348/81201)。 | | [setWTNRemoteAudioPlaybackVolume](85516#IWTNStream-setwtnremoteaudioplaybackvolume) | 调节 WTN 流的音频播放音量。 | | [setWTNStreamEventHandler](85516#IWTNStream-setwtnstreameventhandler) | 设置 WTN 流回调接口 | | 回调 | 描述 | | --- | --- | | [onWTNRemoteVideoStats](85517#IWTNStreamEventHandler-onwtnremotevideostats) | 通话中本地设备接收订阅的远端 WTN 视频流的流 ID 以及远端 WTN 视频流统计信息。 | | [onWTNRemoteAudioStats](85517#IWTNStreamEventHandler-onwtnremoteaudiostats) | 通话中本地设备接收订阅的远端 WTN 音频流的流 ID 以及远端 WTN 音频流统计信息。 | | [onWTNVideoSubscribeStateChanged](85517#IWTNStreamEventHandler-onwtnvideosubscribestatechanged) | WTN 视频流订阅状态变化回调
通过 [subscribeWTNVideoStream](85516#IWTNStream-subscribewtnvideostream) 订阅 WTN 视频流后，可以通过本回调获取订阅结果。 | | [onWTNAudioSubscribeStateChanged](85517#IWTNStreamEventHandler-onwtnaudiosubscribestatechanged) | WTN 音频流订阅状态变化回调
通过 [subscribeWTNAudioStream](85516#IWTNStream-subscribewtnaudiostream) 订阅 WTN 音频流后，可以通过本回调获取订阅结果。 | | [onWTNFirstRemoteAudioFrame](85517#IWTNStreamEventHandler-onwtnfirstremoteaudioframe) | WTN 流的首帧音频解码成功
关于订阅 WTN 音频流，详见 [subscribeWTNAudioStream](85516#IWTNStream-subscribewtnaudiostream)。 | | [onWTNFirstRemoteVideoFrameDecoded](85517#IWTNStreamEventHandler-onwtnfirstremotevideoframedecoded) | WTN 流的首帧视频解码成功
关于订阅 WTN 流，详见 [subscribeWTNVideoStream](85516#IWTNStream-subscribewtnvideostream)。 | | [onWTNSEIMessageReceived](85517#IWTNStreamEventHandler-onwtnseimessagereceived) | 回调 WTN 流中包含的 SEI 信息。
调用 [subscribeWTNAudioStream](85516#IWTNStream-subscribewtnaudiostream)/[subscribeWTNVideoStream](85516#IWTNStream-subscribewtnvideostream)接口拉 WTN 音频流/视频流后，通过此回调收到 WTN 流中的 SEI 消息。 | | [onWTNDataMessageReceived](85517#IWTNStreamEventHandler-onwtndatamessagereceived) | 回调 WTN 流中包含的数据信息。
通过 [subscribeWTNAudioStream](85516#IWTNStream-subscribewtnaudiostream)/[subscribeWTNVideoStream](85516#IWTNStream-subscribewtnvideostream) 订阅 WTN 流后，通过监听本回调获取 WTN 流中的数据消息，包括调用 Open API 发送的 SEI 消息和音量回调。 | ## 混音 | 方法 | 描述 | | --- | --- | | [getAudioEffectPlayer](85516#IRTCEngine-getaudioeffectplayer) | 创建音效播放器实例。 | | [setEventHandler](85516#IAudioEffectPlayer-seteventhandler) | 设置回调句柄。 | | [getDuration](85516#IAudioEffectPlayer-getduration) | 获取音效文件时长。 | | [getVolume](85516#IAudioEffectPlayer-getvolume) | 获取当前音量。 | | [setVolumeAll](85516#IAudioEffectPlayer-setvolumeall) | 设置所有音效的音量大小，包括音效文件和 PCM 音效。 | | [setVolume](85516#IAudioEffectPlayer-setvolume) | 调节指定音效的音量大小，包括音效文件和 PCM 音频。 | | [getPosition](85516#IAudioEffectPlayer-getposition) | 获取音效文件播放进度。 | | [setPosition](85516#IAudioEffectPlayer-setposition) | 设置音效文件的起始播放位置。 | | [resumeAll](85516#IAudioEffectPlayer-resumeall) | 恢复播放所有音效文件。 | | [resume](85516#IAudioEffectPlayer-resume) | 恢复播放音效文件。 | | [pauseAll](85516#IAudioEffectPlayer-pauseall) | 暂停播放所有音效文件。 | | [pause](85516#IAudioEffectPlayer-pause) | 暂停播放音效文件。 | | [unloadAll](85516#IAudioEffectPlayer-unloadall) | 卸载所有音效文件。 | | [unload](85516#IAudioEffectPlayer-unload) | 卸载指定音效文件。 | | [preload](85516#IAudioEffectPlayer-preload) | 预加载指定音乐文件到内存中，以避免频繁播放同一文件时的重复加载，减少 CPU 占用。 | | [stopAll](85516#IAudioEffectPlayer-stopall) | 停止播放所有音效文件。 | | [stop](85516#IAudioEffectPlayer-stop) | 停止播放音效文件。 | | [start](85516#IAudioEffectPlayer-start) | 开始播放音效文件。
可以通过传入不同的 ID 和 filepath 多次调用本方法，以实现同时播放多个音效文件，实现音效叠加。 | | [setEventHandler](85516#IMediaPlayer-seteventhandler) | 设置回调句柄。 | | [pushExternalAudioFrame](85516#IMediaPlayer-pushexternalaudioframe) | 推送用于混音的 PCM 音频帧数据 | | [registerAudioFrameObserver](85516#IMediaPlayer-registeraudioframeobserver) | 注册回调句柄以在本地音乐文件混音时，收到相关回调。 | | [setLoudness](85516#IMediaPlayer-setloudness) | 如果你需要使用 [enableVocalInstrumentBalance](85516#IRTCEngine-enablevocalinstrumentbalance) 对音频文件/PCM 音频数据设置音量均衡，你必须通过此接口传入其原始响度。 | | [setProgressInterval](85516#IMediaPlayer-setprogressinterval) | 设置音频文件混音时，收到 [onMediaPlayerPlayingProgress](85517#IMediaPlayerEventHandler-onmediaplayerplayingprogress) 的间隔。 | | [setPlaybackSpeed](85516#IMediaPlayer-setplaybackspeed) | 设置播放速度 | | [selectAudioTrack](85516#IMediaPlayer-selectaudiotrack) | 指定当前音乐文件的播放音轨 | | [getAudioTrackCount](85516#IMediaPlayer-getaudiotrackcount) | 获取当前音乐文件的音轨数 | | [setAudioDualMonoMode](85516#IMediaPlayer-setaudiodualmonomode) | 设置当前音乐文件的声道模式 | | [setPosition](85516#IMediaPlayer-setposition) | 设置音乐文件的起始播放位置。 | | [setAudioPitch](85516#IMediaPlayer-setaudiopitch) | 开启变调功能，多用于 K 歌场景。 | | [getState](85516#IMediaPlayer-getstate) | 获取播放器状态 | | [getPosition](85516#IMediaPlayer-getposition) | 获取音乐文件播放进度。 | | [getPlaybackDuration](85516#IMediaPlayer-getplaybackduration) | 获取混音音乐文件的实际播放时长，单位为毫秒。 | | [getTotalDuration](85516#IMediaPlayer-gettotalduration) | 获取音乐文件时长。 | | [getVolume](85516#IMediaPlayer-getvolume) | 获取当前音量 | | [setVolume](85516#IMediaPlayer-setvolume) | 调节指定混音的音量大小，包括音乐文件混音和 PCM 混音。 | | [resume](85516#IMediaPlayer-resume) | 调用 [pause](85516#IMediaPlayer-pause) 暂停音频播放后，调用本方法恢复播放。 | | [pause](85516#IMediaPlayer-pause) | 调用 [open](85516#IMediaPlayer-open)，或 [start](85516#IMediaPlayer-start) 开始播放音频文件后，调用本方法暂停播放。 | | [stop](85516#IMediaPlayer-stop) | 调用 [open](85516#IMediaPlayer-open), [start](85516#IMediaPlayer-start), 或 [openWithCustomSource](85516#IMediaPlayer-openwithcustomsource) 开始播放后，可以调用本方法停止。 | | [openWithCustomSource](85516#IMediaPlayer-openwithcustomsource) | 启动音频裸数据混音。
要播放音乐文件，参看 [open](85516#IMediaPlayer-open)。`open` 与此 API 互斥。 | | [start](85516#IMediaPlayer-start) | 播放音乐。你仅需要在调用 [open](85516#IMediaPlayer-open)，且未开启自动播放时，调用此方法。 | | [open](85516#IMediaPlayer-open) | 打开音乐文件。
一个播放器实例仅能够同时打开一个音乐文件。如果需要同时打开多个音乐文件，请创建多个音乐播放器实例。
要播放 PCM 格式的音频数据，参看 [openWithCustomSource](85516#IMediaPlayer-openwithcustomsource)。`openWithCustomSource` 和此 API 互斥。 | | [getMediaPlayer](85516#IRTCEngine-getmediaplayer) | 创建音乐播放器实例。 | | 回调 | 描述 | | --- | --- | | [onAudioEffectPlayerStateChanged](85517#IAudioEffectPlayerEventHandler-onaudioeffectplayerstatechanged) | 播放状态改变时回调。 | | [onAudioMixingPlayingProgress](85517#IRTCEngineEventHandler-onaudiomixingplayingprogress) | 混音音频文件播放进度回调 | | [onMediaPlayerEvent](85517#IMediaPlayerEventHandler-onmediaplayerevent) | 播放事件回调。调用 [selectAudioTrack](85516#IMediaPlayer-selectaudiotrack) 和 [setPosition](85516#IMediaPlayer-setposition) 后，会触发此回调。 | | [onMediaPlayerPlayingProgress](85517#IMediaPlayerEventHandler-onmediaplayerplayingprogress) | 播放进度周期性回调。回调周期通过 [setProgressInterval](85516#IMediaPlayer-setprogressinterval) 设置。 | | [onMediaPlayerStateChanged](85517#IMediaPlayerEventHandler-onmediaplayerstatechanged) | 播放状态改变时回调。 | | [onSeek](85517#IMediaPlayerCustomSourceProvider-onseek) | 根据设置好的内存音频数据的读取位置和读取偏移量对音频数据进行偏移，以便 SDK 读取和分析音频数据。
在调用 [openWithCustomSource](85516#IMediaPlayer-openwithcustomsource) 接口传入内存音频数据，或者调用 [setPosition](85516#IMediaPlayer-setposition) 设置了音频数据的起始播放位置后，SDK 会对音频数据进行读取和分析，此时会触发该回调，你需要根据参数中设置的起始读取位置和偏移量进行操作。 | | [onReadData](85517#IMediaPlayerCustomSourceProvider-onreaddata) | 调用 [openWithCustomSource](85516#IMediaPlayer-openwithcustomsource) 接口播放用户传入的内存音频数据时，会触发此回调，用户需要写入音频数据。 | | [onFrame](85517#IMediaPlayerAudioFrameObserver-onframe) | 当本地音频文件混音时，回调播放的音频帧。 | ## 屏幕共享 | 方法 | 描述 | | --- | --- | | [getScreenCaptureSourceList](85516#IRTCEngine-getscreencapturesourcelist) | 获取共享对象列表。 | | [setScreenCaptureVolume](85516#IRTCEngine-setscreencapturevolume) | 调节屏幕共享时采集的音频音量。
只改变音频数据的音量信息，不影响麦克风采集的音量，也不会改变本端音频设备本身的音量。 | | [release](85516#IScreenCaptureSourceList-release) | [IScreenCaptureSourceList](85516#IScreenCaptureSourceList) 使用结束后，调用本接口删除对象，清空和释放内存。 | | [getSourceInfo](85516#IScreenCaptureSourceList-getsourceinfo) | 根据索引号，获取屏幕共享列表中的元素 | | [getCount](85516#IScreenCaptureSourceList-getcount) | 获取列表长度 | | [startScreenVideoCapture](85516#IRTCEngine-startscreenvideocapture) | 采集屏幕视频流，用于共享。屏幕视频流包括：应用窗口中显示的内容，或虚拟屏幕中显示的内容。 | | [updateScreenCaptureHighlightConfig](85516#IRTCEngine-updatescreencapturehighlightconfig) | 通过 RTC SDK 提供的采集模块采集屏幕视频流时，更新边框高亮设置。默认展示边框。 | | [updateScreenCaptureMouseCursor](85516#IRTCEngine-updatescreencapturemousecursor) | 通过 RTC SDK 提供的采集模块采集屏幕视频流时，更新对鼠标的处理设置。默认采集鼠标。 | | [updateScreenCaptureRegion](85516#IRTCEngine-updatescreencaptureregion) | 通过 RTC SDK 提供的采集模块采集屏幕视频流时，更新采集区域。仅用于采集源为显示器屏幕时。 | | [stopScreenVideoCapture](85516#IRTCEngine-stopscreenvideocapture) | 停止屏幕视频流采集。 | | [getThumbnail](85516#IRTCEngine-getthumbnail) | 获取共享对象缩略图 | | [getWindowAppIcon](85516#IRTCEngine-getwindowappicon) | 获取应用窗体所属应用的图标。 | ## 安全与加密 | 方法 | 描述 | | --- | --- | | [setEncryptInfo](85516#IRTCEngine-setencryptinfo) | 设置传输时使用内置加密的方式。 | | [setLocalProxy](85516#IRTCEngine-setlocalproxy) | 设置本地代理。 | | [stopCloudProxy](85516#IRTCEngine-stopcloudproxy) | 关闭云代理 | | [startCloudProxy](85516#IRTCEngine-startcloudproxy) | 开启云代理 | | [setCustomizeEncryptHandler](85516#IRTCEngine-setcustomizeencrypthandler) | 设置自定义加密和解密方式。 | | 回调 | 描述 | | --- | --- | | [onEncryptData](85517#IEncryptHandler-onencryptdata) | 自定义加密。
使用设定的自定义加密方式，对编码后传输前的音视频帧数据进行加密。
暂不支持对原始音视频帧进行加密。 | | [onLocalProxyStateChanged](85517#IRTCEngineEventHandler-onlocalproxystatechanged) | 本地代理状态发生改变回调。调用 [setLocalProxy](85516#IRTCEngine-setlocalproxy) 设置本地代理后，SDK 会触发此回调，返回代理连接的状态。 | | [onCloudProxyConnected](85517#IRTCEngineEventHandler-oncloudproxyconnected) | 调用 [startCloudProxy](85516#IRTCEngine-startcloudproxy) 开启云代理，SDK 首次成功连接云代理服务器时，回调此事件。 | | [onDecryptData](85517#IEncryptHandler-ondecryptdata) | 自定义解密。
对自定义加密后的音视频帧数据进行解密。关于自定义加密，参看 [onEncryptData](85517#IEncryptHandler-onencryptdata)。 | ## 字幕翻译服务 | 方法 | 描述 | | --- | --- | | [startSubtitle](85516#IRTCRoom-startsubtitle) | 识别或翻译房间内所有用户的语音，形成字幕。
调用该方法时，可以在 [SubtitleMode](85519#SubtitleMode) 中选择语音识别或翻译模式。如果选择识别模式，语音识别文本会通过 [onSubtitleMessageReceived](85517#IRTCRoomEventHandler-onsubtitlemessagereceived) 事件回调给你；
如果选择翻译模式，你会同时收到两个 [onSubtitleMessageReceived](85517#IRTCRoomEventHandler-onsubtitlemessagereceived) 回调，分别包含字幕原文及字幕译文。
调用该方法后，用户会收到 [onSubtitleStateChanged](85517#IRTCRoomEventHandler-onsubtitlestatechanged) 回调，通知字幕是否开启。 | | [getRoomId](85516#IRTCRoom-getroomid) | 获取房间 ID。 | | [stopSubtitle](85516#IRTCRoom-stopsubtitle) | 关闭字幕。
调用该方法后，用户会收到 [onSubtitleStateChanged](85517#IRTCRoomEventHandler-onsubtitlestatechanged) 回调，通知字幕是否关闭。 | | 回调 | 描述 | | --- | --- | | [onSubtitleStateChanged](85517#IRTCRoomEventHandler-onsubtitlestatechanged) | 字幕状态发生改变回调。
当用户调用 [startSubtitle](85516#IRTCRoom-startsubtitle) 和 [stopSubtitle](85516#IRTCRoom-stopsubtitle) 使字幕状态发生改变或出现错误时，触发该回调。 | | [onSubtitleMessageReceived](85517#IRTCRoomEventHandler-onsubtitlemessagereceived) | 字幕相关内容回调。
当用户调用 [startSubtitle](85516#IRTCRoom-startsubtitle) 后会收到此回调，通知字幕的相关信息。 | ## 高级功能 | 方法 | 描述 | | --- | --- | | [setAnsMode](85516#IRTCEngine-setansmode) | 支持根据业务场景，设置通话中的音频降噪模式。 | | [getRangeAudio](85516#IGameRoom-getrangeaudio) | 获取游戏房间范围语音接口实例。 | | [stopAudioRecording](85516#IRTCEngine-stopaudiorecording) | 停止音频文件录制 | | [startAudioRecording](85516#IRTCEngine-startaudiorecording) | 开始音频录制，并生成录音文件保存到本地。 | | [stopFileRecording](85516#IRTCEngine-stopfilerecording) | 停止本地录制 | | [startFileRecording](85516#IRTCEngine-startfilerecording) | 录制通话过程中的音视频数据到本地的文件中。 | | 回调 | 描述 | | --- | --- | | [onExtensionAccessError](85517#IRTCEngineEventHandler-onextensionaccesserror) | 当访问插件失败时，收到此回调。
RTC SDK 将一些功能封装成插件。当使用这些功能时，如果插件不存在，功能将无法使用。 | | [onRecordingProgressUpdate](85517#IRTCEngineEventHandler-onrecordingprogressupdate) | 本地录制进度回调。
该回调由 [startFileRecording](85516#IRTCEngine-startfilerecording) 触发，录制状态正常时，系统每秒钟都会通过该回调提示录制进度。 | | [onRecordingStateUpdate](85517#IRTCEngineEventHandler-onrecordingstateupdate) | 获取本地录制状态回调。
该回调由 [startFileRecording](85516#IRTCEngine-startfilerecording) 或 [stopFileRecording](85516#IRTCEngine-stopfilerecording) 触发。 |

实时音视频