方法
引擎管理
方法描述
createRTCVideo创建引擎对象

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

如果当前进程中已创建了引擎实例,再次调用此方法时,会返回已创建的引擎实例。
destroyRTCVideo销毁由 createRTCVideo 所创建引擎实例,并释放所有相关资源
getSdkVersion获取 SDK 当前的版本号。
feedback将用户反馈的问题上报到 RTC
getErrorDescription获取 SDK 内各种错误码、警告码的描述文字
setRtcVideoEventHandler设置引擎事件回调的接收类,必须继承自 IRTCVideoEventHandler 。
setBusinessId设置业务标识参数

可通过 businessId 区分不同的业务场景。businessId 由客户自定义,相当于一个“标签”,可以分担和细化现在 AppId 的逻辑划分的功能,但不需要鉴权。
setRuntimeParameters设置运行时的参数
房间管理
方法描述
createRTCRoom创建房间实例。
调用此方法仅返回一个房间实例,你仍需调用 joinRoom 才能真正地创建/加入房间。
多次调用此方法以创建多个 RTCRoom 实例。分别调用各 RTCRoom 实例中的 joinRoom 方法,同时加入多个房间。
多房间模式下,用户可以同时订阅各房间的音视频流。
destroy退出并销毁调用 createRTCRoom 所创建的房间实例。
setRTCRoomEventHandler通过设置房间事件 handler,监听此对象对应的回调事件。
joinRoom加入房间。

多房间场景下,调用 createRTCRoom 创建房间后,调用此方法加入房间,同房间内其他用户进行音视频通话。
leaveRoom离开房间。

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

此方法是异步操作,调用返回时并没有真正退出房间。真正退出房间后,本地会收到 onLeaveRoom 回调通知。
setUserVisibility设置用户可见性。默认可见。
updateToken更新 Token。
在 Token 进房权限过期前 30 秒,会收到 onTokenWillExpire 回调,此时需要重新获取 Token,并调用此方法更新 Token,否则用户将因为 Token 过期被移出房间。
音频管理
方法描述
setDefaultAudioRoute将默认的音频播放设备设置为听筒或扬声器。
setAudioRoute设置当前音频播放路由。默认使用 setDefaultAudioRoute 中设置的音频路由。
音频播放路由发生变化时,会收到 onAudioRouteChanged 回调。
getAudioRoute获取当前使用的音频播放路由。
setCaptureVolume调节音频采集音量
setPlaybackVolume调节本地播放的所有远端用户混音后的音量。播放音频前或播放音频时,你都可以使用此接口设定播放音量。
setRemoteAudioPlaybackVolume调节来自指定远端用户的音频播放音量,默认为 100。
enableAudioPropertiesReport启用音频信息提示。
startAudioCapture开启内部音频采集。默认为关闭状态。

内部采集是指:使用 RTC SDK 内置的音频采集机制进行音频采集。
调用该方法开启后,本地用户会收到 onAudioDeviceStateChanged 的回调。

非隐身用户进房后调用该方法,房间中的其他用户会收到 onUserStartAudioCapture 的回调。
stopAudioCapture立即关闭内部音频采集。默认为关闭状态。

内部采集是指:使用 RTC SDK 内置的音频采集机制进行音频采集。
调用该方法,本地用户会收到 onAudioDeviceStateChanged 的回调。

非隐身用户进房后调用该方法,房间中的其他用户会收到 onUserStopAudioCapture 的回调。
setAudioScenario设置音频场景类型
setAudioProfile设置音质档位。当所选的 ChannelProfile 中的音频参数无法满足你的场景需求时,调用本接口切换的音质档位。
enableExternalSoundCard启用匹配外置声卡的音频处理模式
getAudioDeviceManager
startAudioPlaybackDeviceTest启动音频播放设备检测。测试启动后,循环播放指定的音频文件,同时将通过 onAudioPlaybackDeviceTestVolume 回调播放时的音量信息。
stopAudioPlaybackDeviceTest停止音频播放测试。
startAudioDeviceRecordTest开始音频采集设备和音频播放设备测试。

建议提前调用 enableAudioPropertiesReport 注册音量提示回调,测试开始后,音频设备开始采集本地声音,可以通过 onLocalAudioPropertiesReport 获取采集音量。
stopAudioDeviceRecordAndPlayTest停止采集本地音频,并开始播放采集到的声音。录音播放完毕后,设备测试流程结束。

调用 startAudioDeviceRecordTest 30 s 内调用本接口来停止采集并开始播放此前采集到的声音。
stopAudioDevicePlayTest停止由调用 startAudioDeviceRecordTest 开始的音频播放设备测试。
在音频播放设备测试自动结束前,可调用本接口停止音频采集与播放测试。
视频管理
方法描述
startVideoCapture立即开启内部视频采集。默认为关闭状态。

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

调用该方法后,本地用户会收到 onVideoDeviceStateChanged 的回调。

本地用户在非隐身状态下调用该方法后,房间中的其他用户会收到 onUserStartVideoCapture 的回调。
stopVideoCapture立即关闭内部视频采集。默认为关闭状态。

内部视频采集指:使用 RTC SDK 内置视频采集模块,进行采集。
调用该方法,本地用户会收到 onVideoDeviceStateChanged 的回调。

非隐身用户进房后调用该方法,房间中的其他用户会收到 onUserStopVideoCapture 的回调。
setVideoCaptureConfig设置 RTC SDK 内部采集时的视频采集参数。

如果你的项目使用了 SDK 内部采集模块,可以通过本接口指定视频采集参数包括模式、分辨率、帧率。
setVideoRotationMode设置采集视频的旋转模式。默认以 App 方向为旋转参考系。

接收端渲染视频时,将按照和发送端相同的方式进行旋转。
setLocalVideoCanvas设置本地视频渲染时使用的视图,并设置渲染模式。
updateLocalVideoCanvas修改本地视频渲染模式和背景色。
setRemoteVideoCanvas渲染来自指定远端用户的视频流时,设置使用的视图和渲染模式。

要解除绑定,将 videoCanvas 设置为空。
updateRemoteStreamVideoCanvas修改远端视频渲染模式和背景色。
switchCamera切换视频内部采集时使用的前置/后置摄像头

调用此接口后,在本地会触发 onVideoDeviceStateChanged 回调。
isCameraZoomSupported检测当前使用的摄像头(前置/后置),是否支持变焦(数码/光学变焦)。
getCameraZoomMaxRatio获取当前使用的摄像头(前置/后置)的最大变焦倍数
setCameraZoomRatio设置当前使用的摄像头(前置/后置)的变焦倍数
isCameraTorchSupported检测当前使用的摄像头(前置/后置),是否支持闪光灯。
setCameraTorch打开/关闭当前使用的摄像头(前置/后置)的闪光灯
isCameraFocusPositionSupported检查当前使用的摄像头是否支持手动对焦。
setCameraFocusPosition设置当前使用的摄像头的对焦点。
isCameraExposurePositionSupported检查当前使用的摄像头是否支持手动设置曝光点。
setCameraExposurePosition设置当前使用的摄像头的曝光点
setCameraExposureCompensation设置当前使用的摄像头的曝光补偿。
registerFaceDetectionObserver注册人脸检测结果回调观察者

注册此观察者后,你会周期性收到 onFaceDetectResult 回调。
setVideoEncoderConfig
视频发布端设置期望发布的最大分辨率视频流参数,包括分辨率、帧率、码率、网络不佳时的回退策略等。

该接口支持设置一路视频流参数,设置多路参数请使用重载 API:setVideoEncoderConfig
setVideoEncoderConfig
视频发布端设置推送多路流时各路流的参数,包括分辨率、帧率、码率、网络不佳时的回退策略等。
音视频传输
方法描述
pauseAllSubscribedStream暂停接收来自远端的媒体流。
resumeAllSubscribedStream恢复接收来自远端的媒体流
publishStream在当前所在房间内发布本地通过摄像头/麦克风采集的媒体流
unpublishStream停止将本地摄像头/麦克风采集的媒体流发布到当前所在房间中
subscribeStream订阅房间内指定的通过摄像头/麦克风采集的媒体流,或更新对指定远端用户的订阅选项
unsubscribeStream取消订阅房间内指定的通过摄像头/麦克风采集的媒体流。

该方法对自动订阅和手动订阅模式均适用。
subscribeAllStreams订阅房间内所有通过摄像头/麦克风采集的媒体流,或更新订阅选项。
unsubscribeAllStreams取消订阅房间内所有的通过摄像头/麦克风采集的媒体流。

自动订阅和手动订阅的流都可以通过本方法取消订阅。
requestRemoteVideoKeyFrame在订阅远端视频流之后,向远端请求关键帧
startForwardStreamToRooms开始跨房间转发媒体流。
在用户进入房间后调用本接口,实现向多个房间转发媒体流,适用于跨房间连麦等场景。
updateForwardStreamToRooms更新跨房间媒体流转发信息。

通过 startForwardStreamToRooms 发起媒体流转发后,可调用本方法增加或者减少目标房间,或更新房间密钥。
调用本方法增加或删减房间后,将在本端触发 onForwardStreamStateChanged 回调,包含发生了变动的目标房间中媒体流转发状态。
stopForwardStreamToRooms停止跨房间媒体流转发。
通过 startForwardStreamToRooms 发起媒体流转发后,可调用本方法停止向所有目标房间转发媒体流。
pauseForwardStreamToAllRooms暂停跨房间媒体流转发。
通过 startForwardStreamToRooms 发起媒体流转发后,可调用本方法暂停向所有目标房间转发媒体流。
调用本方法暂停向所有目标房间转发后,你可以随时调用 resumeForwardStreamToAllRooms 快速恢复转发。
resumeForwardStreamToAllRooms恢复跨房间媒体流转发。
调用 pauseForwardStreamToAllRooms 暂停转发之后,调用本方法恢复向所有目标房间转发媒体流。
setMultiDeviceAVSync设置发流端音画同步。

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

用户可以指定房间内多个用户发布的媒体流合成一路公共流。使用同一 appID 的用户,可以调用 startPlayPublicStream 获取和播放指定的公共流。
stopPushPublicStream停止发布当前用户发布的公共流

关于发布公共流,查看 startPushPublicStream
updatePublicStreamParam更新公共流参数

关于发布公共流,查看 startPushPublicStream。
startPlayPublicStream订阅指定公共流

无论用户是否在房间内,都可以调用本接口获取和播放指定的公共流。
stopPlayPublicStream取消订阅指定公共流

关于订阅公共流,查看 startPlayPublicStream。
setPublicStreamVideoCanvas为指定公共流绑定内部渲染视图。
setPublicStreamVideoSink为指定公共流绑定自定义渲染器。详见自定义视频渲染。
音视频处理
方法描述
setLocalVideoMirrorType为采集到的视频流开启镜像
setVideoOrientation在自定义视频前处理及编码前,设置 RTC 链路中的视频帧朝向,默认为 Adaptive 模式。
移动端开启视频特效贴纸,或使用自定义视频前处理时,建议固定视频帧朝向为 Portrait 模式。单流转推场景下,建议根据业务需要固定视频帧朝向为 Portrait 或 Landscape 模式。不同模式的具体显示效果参看视频帧朝向。
setVideoWatermark在指定视频流上添加水印。
clearVideoWatermark移除指定视频流的水印。
checkVideoEffectLicense视频特效许可证检查
setVideoEffectAlgoModelPath设置视频特效算法模型路径
enableVideoEffect创建/销毁视频特效引擎
setVideoEffectNodes设置视频特效素材包
updateVideoEffectNode设置特效强度
setVideoEffectColorFilter设置颜色滤镜
setVideoEffectColorFilterIntensity设置已启用的颜色滤镜强度
enableEffectBeauty开启/关闭基础美颜
setBeautyIntensity调整基础美颜强度
setBackgroundSticker将摄像头采集画面中的人像背景替换为指定图片或纯色背景。
若要取消背景特效,将背景贴纸特效素材路径设置为null。
setVoiceChangerType设置变声特效类型
setVoiceReverbType设置混响特效类型
setLocalVoicePitch开启本地语音变调功能,多用于 K 歌场景。

使用该方法,你可以对本地语音的音调进行升调或降调等调整。
自定义流处理
方法描述
setVideoSourceType设置向 SDK 输入的视频源,包括屏幕流
默认使用内部采集。内部采集指:使用 RTC SDK 内置的视频采集机制进行视频采集。
pushExternalVideoFrame推送外部视频帧。
setLocalVideoSink将本地视频流与自定义渲染器绑定。
setRemoteVideoSink将远端视频流与自定义渲染器绑定。
registerRemoteEncodedVideoFrameObserver注册远端编码后视频数据回調。

完成注册后,当 SDK 监测到远端编码后视频帧时,会触发 OnRemoteEncodedVideoFrame 回调
setVideoDecoderConfig在订阅远端视频流之前,设置远端视频数据解码方式
setAudioSourceType切换音频采集方式
setAudioRenderType切换音频渲染方式
pushExternalAudioFrame推送自定义采集的音频数据到 RTC SDK。
pullExternalAudioFrame拉取音频数据,用于外部播放。
registerLocalVideoProcessor设置自定义视频前处理器。

使用这个视频前处理器,你能够调用 processVideoFrame 对 RTC SDK 采集得到的视频帧进行前处理,并将处理后的视频帧用于 RTC 音视频通信。
processVideoFrame获取 RTC SDK 采集得到的视频帧,根据 registerLocalVideoProcessor 设置的视频前处理器,进行视频前处理,最终将处理后的视频帧给到 RTC SDK 用于编码传输。
registerAudioProcessor注册自定义音频处理器。

注册完成后,你可以调用 enableAudioProcessor,对本地采集或接收到的远端音频进行处理。
enableAudioProcessor设置并开启指定的音频帧回调,进行自定义处理。
disableAudioProcessor关闭自定义音频处理。
registerAudioFrameObserver注册音频数据回调观察者。
enableAudioFrameCallback设置并开启指定的音频数据帧回调
disableAudioFrameCallback关闭音频回调
registerLocalEncodedVideoFrameObserver注册本地视频帧监测器。

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

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

你可调用该接口设置网络不佳或设备性能不足时允许订阅流进行降级或只订阅音频流,以保证通话流畅。
setRemoteUserPriority设置用户优先级。
startNetworkDetection开启通话前网络探测
stopNetworkDetection停止通话前网络探测
startEchoTest开启音视频回路测试。

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

开始检测后,SDK 会录制你声音或视频。如果你在设置的延时范围内收到了回放,则视为音视频回路测试正常。
stopEchoTest停止音视频回路测试。

调用 startEchoTest 开启音视频回路检测后,你必须调用该方法停止检测。
消息
方法描述
sendRoomMessage给房间内的所有其他用户群发文本消息。
sendRoomBinaryMessage给房间内的所有其他用户群发二进制消息。
sendUserMessage给房间内指定的用户发送点对点文本消息
sendUserBinaryMessage给房间内指定的用户发送点对点二进制消息。
login必须先登录,才能发送房间外点对点消息和向应用服务器发送消息

在调用本接口登录后,如果想要登出,需要调用 logout。
logout调用本接口登出后,无法调用房间外消息以及端到服务器消息相关的方法或收到相关回调。
updateLoginToken更新用户用于登录的 Token

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

调用 login 方法登录时,如果使用了过期的 Token 将导致登录失败,并会收到 onLoginResult 回调通知,错误码为 LOGIN_ERROR_CODE_INVALID_TOKEN。此时需要重新获取 Token,并调用此方法更新 Token。
setServerParams设置应用服务器参数

客户端调用 sendServerMessage 或 sendServerBinaryMessage 发送消息给应用服务器之前,必须需要设置有效签名和应用服务器地址。
getPeerOnlineStatus查询对端用户或本端用户的登录状态
sendUserMessageOutsideRoom给房间外指定的用户发送文本消息(P2P)
sendUserBinaryMessageOutsideRoom给房间外指定的用户发送二进制消息(P2P)
sendServerMessage客户端给应用服务器发送文本消息(P2Server)
sendServerBinaryMessage客户端给应用服务器发送二进制消息(P2Server)
sendStreamSyncInfo发送音频流同步信息。将消息通过音频流发送到远端,并实现与音频流同步,该接口调用成功后,远端用户会收到 onStreamSyncInfoReceived 回调。
sendSEIMessage通过视频帧发送 SEI 数据。

在视频通话场景下,SEI 数据会随视频帧发送;在语音通话场景下,SDK 会自动生成一路 16px × 16px 的黑帧视频流用来发送 SEI 数据。
CDN 推流
方法描述
startLiveTranscoding新增转推直播任务,并设置合流的图片、视频视图布局和音频属性。

同一个任务中转推多路直播流时,SDK 会先将多路流合成一路流,然后再进行转推。
stopLiveTranscoding停止转推直播,会收到 onStreamMixingEvent 回调。

关于启动转推直播,参看 startLiveTranscoding。
updateLiveTranscoding更新转推直播参数,会收到 onStreamMixingEvent 回调。

使用 startLiveTranscoding 启用转推直播功能后,使用此方法更新功能配置参数。
startPushSingleStreamToCDN新增单流转推直播任务。
stopPushStreamToCDN停止转推直播。

关于启动转推直播,参看 startPushSingleStreamToCDN。
混音
方法描述
enableAudioMixingFrame启动 PCM 音频数据混音
disableAudioMixingFrame关闭 PCM 混音
pushAudioMixingFrame推送 PCM 音频帧数据用于混音
getAudioMixingManager混音管理接口创建
startAudioMixing开始播放音频文件。

可以通过传入不同的 ID 和 filepath 多次调用本方法,以实现同时播放多个混音文件,实现混音叠加。
stopAudioMixing停止播放音频文件
pauseAudioMixing暂停播放音频文件
resumeAudioMixing恢复播放音频文件
setAudioMixingVolume调节指定混音的音量大小,包括音频文件混音和 PCM 混音。
setAllAudioMixingVolume设置默认的混音音量大小,包括音频文件混音和 PCM 混音。
enableVocalInstrumentBalance开启/关闭音量均衡功能。

开启音量均衡功能后,人声的响度会调整为 -16lufs。如果已调用 setAudioMixingLoudness 传入了混音音乐的原始响度,此音乐播放时,响度会调整为 -20lufs。
setAudioMixingLoudness如果你需要使用 enableVocalInstrumentBalance 对混音音频文件/PCM 音频数据进行音量调整,你必须通过此接口传入其原始响度。
enablePlaybackDucking打开/关闭音量闪避功能,适用于“一起看”等场景。

开启该功能后,当检测到远端人声时,本地的媒体播放音量会自动减弱,从而保证远端人声的清晰可辨;当远端人声消失时,本地媒体音量会恢复到闪避前的音量水平。
setAudioMixingPitch开启本地播放音乐文件变调功能,多用于 K 歌场景。

使用该方法,你可以对本地播放音乐文件的音调进行升调或降调等调整。
getAudioMixingCurrentPosition获取音频文件播放进度
setAudioMixingPosition设置音频文件的起始播放位置。
getAudioTrackCount获取当前音频文件的音轨索引
getSpatialAudio获取空间音频接口实例。 空间音频相关 API 和调用时序详见空间音频。
selectAudioTrack指定当前音频文件的播放音轨
setAudioMixingPlaybackSpeed设置混音时音频文件的播放速度
setAudioMixingDualMonoMode设置当前音频文件的声道模式
setAudioMixingProgressInterval设置混音时音频文件播放进度回调的间隔
preloadAudioMixing预加载指定音乐文件到内存中,以避免频繁播放同一文件时的重复加载,减少 CPU 占用。
unloadAudioMixing卸载指定音频文件
getAudioMixingDuration获取音频文件时长
getAudioMixingPlaybackDuration获取混音音频文件的实际播放时长(单位:毫秒)。
屏幕分享
方法描述
startScreenCapture使用 RTC SDK 内部采集模块开始采集屏幕音频流和(或)视频流。
updateScreenCapture使用 RTC SDK 内部屏幕采集后,更新采集的媒体类型。
stopScreenCapture在屏幕共享时,停止使用 RTC SDK 内部采集方式采集屏幕音视频。
publishScreen在当前所在房间内发布本地屏幕共享音视频流
unpublishScreen停止将本地屏幕共享音视频流发布到当前所在房间中
setScreenAudioSourceType在屏幕共享时,设置屏幕音频的采集方式(内部采集/自定义采集)
setScreenAudioStreamIndex在屏幕共享时,设置屏幕音频流和麦克风采集到的音频流的混流方式
setScreenVideoEncoderConfig为发布的屏幕共享视频流设置期望的编码参数,包括分辨率、帧率、码率、网络不佳时的回退策略等。
pushScreenAudioFrame使用自定义采集方式,采集屏幕共享时的屏幕音频时,将音频帧推送至 RTC SDK 处进行编码等处理。
pushScreenFrame推送屏幕视频帧
subscribeScreen订阅房间内指定的远端屏幕共享音视频流,或更新对指定远端用户的订阅选项
unsubscribeScreen取消订阅房间内指定的远端屏幕共享音视频流。

该方法对自动订阅和手动订阅模式均适用。
安全与加密
方法描述
startCloudProxy开启云代理
stopCloudProxy关闭云代理
setCustomizeEncryptHandler设置自定义加密方法
自定义加密方法需要实现对应的加密/解密方法
setEncryptInfo设置AES加密算法和加密密钥

有四种内置的加密算法,为 AES-128-CBC,AES-256-CBC,AES-128-ECB,AES-256-ECB
高级功能
方法描述
startFileRecording该方法将通话过程中的音视频数据录制到本地的文件中。
stopFileRecording停止本地录制
setEarMonitorMode打开/关闭耳返功能。
setEarMonitorVolume设置耳返音量。
getRangeAudio获取范围语音接口实例。
startASR开启自动语音识别服务。该方法将识别后的用户语音转化成文字,并通过 onMessage 事件回调给用户。
stopASR关闭语音识别服务
takeLocalSnapshot截取本地视频画面
takeRemoteSnapshot截取远端视频画面
音乐及打分
方法描述
getKTVManager创建 KTV 管理接口。
setKTVEventHandler设置 KTV 回调接口。
setMaxCacheSize设置歌曲文件最大占用的本地缓存。
getMusicList获取歌曲列表。
searchMusic根据关键词搜索歌曲。
getHotMusic根据热榜类别获取每个榜单的歌曲列表。
getMusicDetail获取音乐详细信息。
downloadMusic下载音乐。
downloadLyric下载歌词。
downloadMidi下载 MIDI 文件。
cancelDownload取消下载任务。
clearCache清除当前音乐缓存文件,包括音乐音频和歌词。
getKTVPlayer获取 KTV 播放器。
setPlayerEventHandler设置 KTV 播放器进度及状态回调接口。
playMusic播放歌曲。
pauseMusic暂停播放歌曲。
resumeMusic继续播放歌曲。
stopMusic停止播放歌曲。
seekMusic设置音乐文件的起始播放位置。
setMusicVolume设置歌曲播放音量,只能在开始播放后进行设置。
switchAudioTrackType切换歌曲原唱伴唱。
setMusicPitch对播放中的音乐设置升降调信息。
getSingScoringManager创建 K 歌评分管理接口。
initSingScoring初始化 K 歌评分。
setSingScoringConfig设置 K 歌评分参数。
getStandardPitchInfo获取标准音高数据。
startSingScoring开始 K 歌评分。
stopSingScoring停止 K 歌评分。
getLastSentenceScore获取上一句的演唱评分。调用 startSingScoring 开始评分后可以调用该接口。
getTotalScore获取当前演唱总分。调用 startSingScoring 开始评分后可以调用该接口。
getAverageScore获取当前演唱歌曲的平均分。
回调
引擎管理
回调描述
onLogReport上报日志时回调该事件。
onHttpsProxyStateHTTPS 代理连接状态改变时,收到该回调。
onSocks5ProxyStateSOCKS5 代理状态改变时,收到该回调。
onSysStats每2秒发生回调,通知当前cpu,内存使用的信息。
onWarning发生警告回调。
onError发生错误回调。
onTokenWillExpireToken 过期前 30 秒将触发该回调。

调用 updateToken 更新 Token。否则 Token 过期后,用户将被移出房间无法继续进行音视频通话。
onHttpProxyStateHTTP 代理连接状态改变时,收到该回调。
房间管理
回调描述
onRoomStateChanged房间状态改变回调,加入房间、异常退出房间、发生房间相关的警告或错误时会收到此回调。
onCreateRoomStateChanged创建房间失败回调。
onLeaveRoom离开房间成功回调。

用户调用 leaveRoom 方法后,SDK 会停止所有的发布订阅流,并在释放所有通话相关的音视频资源后,通过此回调通知用户离开房间成功。
onUserJoined可见用户加入房间,或房内隐身用户切换为可见的回调。

1.远端用户调用 setUserVisibility 方法将自身设为可见后加入房间时,房间内其他用户将收到该事件。

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

3.房间内隐身远端用户调用 setUserVisibility 方法切换至可见时,房间内其他用户将收到该事件。

4.新进房用户也会收到进房前已在房内的主播角色用户的进房回调通知。
onUserLeave远端用户离开房间,或切至不可见时,房间内其他用户会收到此事件
onRoomStats房间通话统计信息回调。

用户进房开始通话后,每 2s 收到一次本回调。
音频管理
回调描述
onAudioDeviceWarning音频设备警告回调。音频设备包括音频采集设备、音频渲染设备等。
onAudioRouteChanged音频播放路由变化时,收到该回调。
onAudioDeviceStateChanged音频设备状态回调。提示音频采集、音频播放等媒体设备的状态。
onLocalAudioPropertiesReport调用 enableAudioPropertiesReport 后,根据设置的 interval 值,你会周期性地收到此回调,了解本地音频的相关信息。

本地音频包括使用 RTC SDK 内部机制采集的麦克风音频和屏幕音频。
onRemoteAudioPropertiesReport远端用户进房后,本地调用 enableAudioPropertiesReport ,根据设置的 interval 值,本地会周期性地收到此回调,了解订阅的远端用户的音频信息。

远端用户的音频包括使用 RTC SDK 内部机制/自定义机制采集的麦克风音频和屏幕音频。
onActiveSpeaker调用 enableAudioPropertiesReport 后,根据设置的 AudioPropertiesConfig.interval,你会周期性地收到此回调,获取房间内的最活跃用户信息。
onUserStartAudioCapture房间内的用户调用 startAudioCapture 开启音频采集时,房间内其他用户会收到此回调。
onUserStopAudioCapture房间内的用户调用 stopAudioCapture 关闭音频采集时,房间内其他用户会收到此回调。
onStreamSyncInfoReceived音频流同步信息回调。可以通过此回调,在远端用户调用 sendStreamSyncInfo 发送音频流同步消息后,收到远端发送的音频流同步信息。
onAudioStreamBanned通过调用服务端 BanUserStream/UnbanUserStream 方法禁用/解禁指定房间内指定用户音频流的发送时,触发此回调。
onAudioPlaybackDeviceTestVolume回调音频设备测试时的播放音量
视频管理
回调描述
onUserStartVideoCapture房间内的可见用户调用 startVideoCapture 开启内部视频采集时,房间内其他用户会收到此回调。
onUserStopVideoCapture房间内的可见用户调用 stopVideoCapture 关闭内部视频采集时,房间内其他用户会收到此回调。
onVideoDeviceStateChanged视频设备状态回调。提示摄像头视频采集、屏幕视频采集等媒体设备的状态。
onVideoDeviceWarning视频设备警告回调,包括视频采集等设备。
onFaceDetectResult特效 SDK 进行人脸检测结果的回调。

调用 registerFaceDetectionObserver 注册了 IFaceDetectionObserver,并使用 RTC SDK 中包含的特效 SDK 进行视频特效处理时,你会收到此回调。
音视频传输
回调描述
onStreamStateChanged流状态改变回调,发生流相关的警告或错误时会收到此回调。
onAVSyncStateChange发布端调用 setMultiDeviceAVSync 后音视频同步状态发生改变时,会收到此回调。
onUserPublishStream房间内新增远端摄像头/麦克风采集音视频流的回调。
onUserUnpublishStream房间内远端摄像头/麦克风采集的媒体流移除的回调。
onAudioFrameSendStateChanged本地音频首帧发送状态发生改变时,收到此回调
onVideoFrameSendStateChanged本地视频首帧发送状态发生改变时,收到此回调
onAudioFramePlayStateChanged音频首帧播放状态发生改变时,收到此回调
onVideoFramePlayStateChanged视频首帧播放状态发生改变时,收到此回调
onForwardStreamStateChanged跨房间媒体流转发状态和错误回调
onForwardStreamEvent跨房间媒体流转发事件回调
onLocalStreamStats反映通话中本地设备发送音/视频流的统计信息以及网络状况的回调。

本地用户发布音视频流成功后,每隔 2s 收到此回调。
onRemoteStreamStats反映通话中本地设备接收订阅的远端音/视频流的统计信息以及网络状况的回调。每隔 2s 收到此回调。
onNetworkQuality加入房间后, 以 2 秒 1 次的频率,报告用户的网络质量信息
onStreamSubscribed关于订阅媒体流状态改变的回调
onLocalAudioStateChanged本地音频流的状态发生改变时,该回调通知当前的本地音频流状态。
onRemoteAudioStateChanged用户订阅来自远端的音频流状态发生改变时,会收到此回调,了解当前的远端音频流状态。
onFirstLocalAudioFrame发布音频流时,采集到第一帧音频帧,收到该回调。
onFirstRemoteAudioFrame接收到来自远端某音频流的第一帧时,收到该回调。
onLocalVideoStateChanged本地视频流的状态发生改变时,收到该事件。
onRemoteVideoStateChanged远端视频流的状态发生改变时,房间内订阅此流的用户会收到该事件。
onFirstRemoteVideoFrameRenderedSDK 内部渲染成功远端视频流首帧后,收到此回调。
onFirstLocalVideoFrameCapturedRTC SDK 在本地完成第一帧视频帧或屏幕视频帧采集时,收到此回调。
onLocalVideoSizeChanged本地预览视频大小或旋转信息发生改变时,收到此回调。
onRemoteVideoSizeChanged远端视频大小或旋转信息发生改变时,房间内订阅此视频流的用户会收到此回调。
onFirstRemoteVideoFrameDecodedSDK 接收并解码远端视频流首帧后,收到此回调。
onVideoStreamBanned通过调用服务端 BanUserStream/UnbanUserStream 方法禁用/解禁指定房间内指定用户视频流的发送时,触发此回调。
onPushPublicStreamResult公共流发布结果回调。

调用 startPushPublicStream 接口发布公共流后,启动结果通过此回调方法通知用户。
onPlayPublicStreamResult订阅公共流的结果回调

调用 startPlayPublicStream 接口启动拉公共流功能后,通过此回调收到启动结果和拉流过程中的错误。
onPublicStreamSEIMessageReceived回调公共流中包含的 SEI 信息

调用 startPlayPublicStream 接口启动拉公共流功能后,通过此回调收到公共流中的SEI消息。
onFirstPublicStreamVideoFrameDecoded公共流的首帧视频解码成功

关于订阅公共流,详见 startPlayPublicStream。
onFirstPublicStreamAudioFrame公共流的音频首帧解码成功

关于订阅公共流,详见 startPlayPublicStream。
自定义流处理
回调描述
OnStart提示自定义编码帧可以开始推送的回调。

收到该回调后,你即可调用 pushExternalEncodedVideoFrame 向 SDK 推送自定义编码视频帧
OnStop当收到该回调时,你需停止向 SDK 推送自定义编码视频帧
OnRateUpdate当自定义编码流的帧率或码率发生变化时,触发该回调
OnRequestKeyFrame提示流发布端需重新生成关键帧的回调
onLocalEncodedVideoFrame调用 registerLocalEncodedVideoFrameObserver 后,SDK 每次使用内部采集,采集到一帧视频帧,或收到一帧外部视频帧时,都会回调该事件。
OnRemoteEncodedVideoFrame调用 registerRemoteEncodedVideoFrameObserver 后,SDK 监测到远端编码后视频数据时,触发该回调
onRecordAudioFrame返回麦克风录制的音频数据
onPlaybackAudioFrame返回订阅的远端所有用户混音后的音频数据
onRemoteUserAudioFrame返回远端单个用户的音频数据
onMixedAudioFrame返回本地麦克风录制和订阅的所有远端用户混音后的音频数据
网络管理
回调描述
onPerformanceAlarms本地未开启发布性能回退,检测到设备性能不足时,收到此回调。

本地开启发布性能回退,因设备性能/网络原因,造成发布性能回退/恢复时,收到此回调。
onSimulcastSubscribeFallback音视频流因网络环境变化等原因发生回退,或从回退中恢复时,触发该回调。
onNetworkDetectionResult通话前网络探测结果。

成功调用 startNetworkDetection 接口开始探测后,会在 3s 内首次收到该回调,之后每 2s 收到一次该回调。
onNetworkDetectionStopped通话前网络探测结束
以下情况将停止探测并收到本一次本回调:

1. 当调用 stopNetworkDetection 接口停止探测后,会收到一次该回调;
2. 当收到远端/本端音频首帧后,停止探测;
3. 当探测超过3分钟后,停止探测;
4. 当探测链路断开一定时间之后,停止探测。
onConnectionStateChanged回调 SDK 与信令服务器连接状态相关事件。当 SDK 与信令服务器的网络连接状态改变时回调该事件。
onNetworkTypeChangedSDK 当前网络连接类型改变回调。当 SDK 的当前网络连接类型发生改变时回调该事件。
onSEIMessageReceived收到通过调用 sendSEIMessage 发送带有 SEI 消息的视频帧时,收到此回调
onEchoTestResult关于音视频回路测试结果的回调。
消息
回调描述
onRoomMessageReceived接收到房间内广播消息的回调。

房间内其他用户调用 sendRoomMessage 发送广播消息时,收到此回调。
onRoomBinaryMessageReceived接收到房间内广播二进制消息的回调。

房间内其他用户调用 sendRoomBinaryMessage 发送广播二进制消息时,收到此回调。
onUserMessageReceived收到来自房间中其他用户通过 sendUserMessage 发来的点对点文本消息时,会收到此回调。
onUserBinaryMessageReceived收到来自房间中其他用户通过 sendUserBinaryMessage 发来的点对点二进制消息时,会收到此回调。
onUserMessageSendResult向房间内单个用户发送点对点文本或点对点二进制消息后,消息发送方会收到该消息发送结果回调。
onRoomMessageSendResult调用 sendRoomMessage 或 sendRoomBinaryMessage 向房间内群发文本或二进制消息后,消息发送方会收到该消息发送结果回调。
onLoginResult登录结果回调
onLogout登出结果回调
onServerParamsSetResult设置应用服务器参数的返回结果
onGetPeerOnlineStatus查询对端或本端用户登录状态的返回结果
onUserMessageReceivedOutsideRoom收到房间外用户调用 sendUserMessageOutsideRoom 发来的文本消息时,会收到此回调
onUserBinaryMessageReceivedOutsideRoom收到房间外用户调用 sendUserBinaryMessageOutsideRoom 发来的二进制消息时,会收到此回调
onUserMessageSendResultOutsideRoom给房间外指定的用户发送消息的回调
onServerMessageSendResult给应用服务器发送消息的回调。
CDN 推流
回调描述
onStreamMixingEvent转推直播状态回调
isSupportClientPushStream是否具有推流能力。

+ false:不具备推流能力(默认值)

+ true:具备推流能力
onMixingAudioFrame端云一体合流音频 PCM 回调
onMixingVideoFrame端云一体合流视频 YUV 回调
onDataFrame端云一体合流视频 SEI 数据回调
混音
回调描述
onAudioMixingStateChanged音频混音文件播放状态改变时回调
onAudioMixingPlayingProgress混音音频文件播放进度回调
屏幕分享
回调描述
onUserPublishScreen房间内新增远端屏幕共享音视频流的回调。
onUserUnpublishScreen房间内远端屏幕共享音视频流移除的回调。
onScreenVideoFrameSendStateChanged屏幕共享流的视频首帧发送状态发生改变时,收到此回调
onScreenVideoFramePlayStateChanged屏幕共享流视频首帧播放状态发生改变时,收到此回调
安全与加密
回调描述
onCloudProxyConnected调用 startCloudProxy 开启云代理,SDK 首次成功连接云代理服务器时,回调此事件。
onEncryptData自定义加密
onDecryptData自定义解密
高级功能
回调描述
onRecordingStateUpdate获取本地录制状态回调。

该回调由 startFileRecording 或 stopFileRecording 触发。
onRecordingProgressUpdate本地录制进度回调。

该回调由 startFileRecording 触发,录制状态正常时,系统每秒钟都会通过该回调提示录制进度。
onRangeAudioInfo关于当前范围语音衰减系数的回调。

手动订阅的场景下,房间内任一用户调用 updatePosition 更新自身位置或调用 updateReceiveRange 更新语音接收范围时,该用户与房间内其他用户的相对距离都会发生改变,据此计算的衰减系数也会发生改变,并通过该回调通知用户。

你可以通过关注该回调中包含的远端用户的衰减系数决定是否订阅该远端用户的流。
onTakeLocalSnapshotResult调用 takeLocalSnapshot 截取视频画面时,收到此回调。
onTakeRemoteSnapshotResult调用 takeRemoteSnapshot 截取视频画面时,收到此回调。
音乐及打分
回调描述
onMusicListResult歌曲列表回调。
onSearchMusicResult搜索歌曲结果回调。
onHotMusicResult热榜歌曲结果回调。
onMusicDetailResult歌曲详细信息回调。
onDownloadSuccess下载成功回调。
onDownloadFail下载失败回调。
onDownloadMusicProgress歌曲文件下载进度回调。
onPlayProgress音乐播放进度回调。
onPlayStateChange音乐播放状态改变回调。
onCurrentScoringInfo实时评分信息回调。调用 startSingScoring 后,会收到该回调。