需要访问旧版文档站？前往旧版文档官网首页。 (在新标签页打开)
声网文档中心

API 概览

  • Android

更新时间不可用

声网通过全球部署的 SD-RTN™，提供可以灵活搭配的 API 组合，实现质量可靠的实时音视频通信。

初始化相关

API描述
create [1/2]创建并初始化 RtcEngine 实例。
create [2/2]创建并初始化 RtcEngine 实例。
addHandler添加事件处理器。
destroy [2/2]销毁 RtcEngine 实例并释放相关资源。
destroy [1/2]释放 RtcEngine 实例。
removeHandler移除指定的 IRtcEngineEventHandler 实例。
onEngineReleasedRtcEngine 被释放时触发的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

频道相关

API描述
setChannelProfile设置频道场景。
joinChannel [1/2]加入一个频道。
joinChannel [2/2]加入频道并设置媒体选项。
joinChannelEx加入一个频道。
updateChannelMediaOptions在加入频道后更新频道媒体选项。
updateChannelMediaOptionsEx加入频道后更新频道媒体选项。
leaveChannel [1/2]离开频道。
leaveChannel [2/2]设置频道选项并离开频道。
leaveChannelEx [1/2]离开频道。
leaveChannelEx [2/2]设置频道参数并离开频道。
preloadChannel预加载指定频道以缩短观众加入频道的时间。
updatePreloadChannelToken更新用于预加载频道的通配 Token。
renewToken更新 Token。
setClientRole [1/2]设置客户端实例的用户角色。
setClientRole [2/2]设置直播场景下的用户角色和观众延迟等级。
getUserInfoByUidEx通过传入用户 ID 获取用户信息。
onClientRoleChanged用户角色或观众延迟级别发生变化回调。
onClientRoleChangeFailed切换用户角色失败时的回调。
onErrorSDK 运行期间发生错误时触发的回调。
onJoinChannelSuccess本地用户成功加入频道回调。
onLeaveChannel用户离开频道回调。
onRejoinChannelSuccess用户重新加入频道回调。
onRenewTokenResultrenewToken 调用结果回调。
onRequestTokenToken 过期回调。
onRtcStats报告当前通话统计信息的回调。
onTokenPrivilegeWillExpireToken 即将在 30 秒后过期时触发的回调。
onUserJoined远端用户或主播加入频道回调。
onUserOffline远端用户或主播离开频道时触发的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

发布和订阅

API描述
muteAllRemoteAudioStreams停止或恢复订阅所有远端用户的音频流。
muteAllRemoteAudioStreamsEx停止或恢复订阅所有远端用户的音频流。
muteAllRemoteVideoStreams停止或恢复订阅所有远端用户的视频流。
muteAllRemoteVideoStreamsEx停止或恢复订阅所有远端用户的视频流。
muteLocalAudioStream停止或恢复发布本地采集音频流。
muteLocalAudioStreamEx停止或恢复发布本地音频流。
muteLocalVideoStream停止或恢复发布本地视频流。
muteLocalVideoStreamEx停止或恢复发布本地视频流。
muteRemoteAudioStream停止或恢复订阅指定远端用户的音频流。
muteRemoteAudioStreamEx停止或恢复接收指定用户的音频流。
muteRemoteVideoStream停止或恢复订阅指定远端用户的视频流。
muteRemoteVideoStreamEx停止或恢复接收指定用户的视频流。
setDualStreamMode [1/2]设置发送端的视频流模式，用于控制是否发送视频小流。
setDualStreamMode [2/2]设置发送端的不同质量层级的视频流模式配置。
setDualStreamModeEx设置发送端的视频流模式，用于控制是否发送视频小流。
setRemoteDefaultVideoStreamType [1/2]设置默认订阅的视频流类型。
setRemoteVideoStreamType [1/2]设置要订阅的视频流类型。
setRemoteVideoStreamTypeEx [1/2]设置要订阅的视频流类型。
setRemoteVideoSubscriptionOptions设置订阅远端视频流的选项。
setRemoteVideoSubscriptionOptionsEx设置订阅远端视频流的选项。
setSubscribeAudioAllowlist设置音频流订阅的白名单。
setSubscribeAudioAllowlistEx设置音频流订阅的白名单。
setSubscribeAudioBlocklist设置音频流订阅的黑名单。
setSubscribeAudioBlocklistEx设置音频流订阅的黑名单。
setSubscribeVideoAllowlist设置视频流订阅的白名单。
setSubscribeVideoAllowlistEx设置视频流订阅的白名单。
setSubscribeVideoBlocklist设置视频流订阅的阻止名单。
setSubscribeVideoBlocklistEx设置视频流订阅的黑名单。
onAudioPublishStateChanged音频发布状态发生变化回调。
onAudioSubscribeStateChanged音频订阅状态发生变化回调。
onVideoSubscribeStateChanged视频订阅状态发生变化回调。
表格内容超出当前宽度，可横向滚动查看更多列。

音频基础功能

API描述
adjustPlaybackSignalVolume调节所有远端用户的本地播放音量。
adjustUserPlaybackSignalVolume调节指定远端用户的播放音量。
adjustUserPlaybackSignalVolumeEx调整指定远端用户的播放音量。
disableAudio禁用音频模块。
enableAudio启用音频模块。
enableAudioVolumeIndication启用用户音量提示上报功能。
enableAudioVolumeIndicationEx启用用户音量提示的上报功能。
setAudioProfile [2/2]设置音频配置文件。
setAudioScenario设置音频场景。
onActiveSpeaker最活跃远端说话人回调。
onAudioVolumeIndication报告用户音量信息的回调。
onFirstLocalAudioFramePublished本地音频首帧发布回调。
onLocalAudioStateChanged本地音频流状态发生变化回调。
onLocalAudioStats本地音频流统计信息回调。
onRemoteAudioStateChanged远端音频状态发生变化回调。
onRemoteAudioStats报告每个远端音频流的传输层统计信息回调。
onUserMuteAudio远端用户或主播停止或恢复发送音频流的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

音频采集

API描述
adjustRecordingSignalVolume调节采集音频信号的音量。
enableInEarMonitoring [1/2]启用或关闭耳返监听。
enableInEarMonitoring [2/2]启用或关闭耳返监听功能。
enableLocalAudio启用或关闭本地音频采集功能。
muteRecordingSignal设置是否静音录制信号。
setInEarMonitoringVolume设置耳返音量。
表格内容超出当前宽度，可横向滚动查看更多列。

人声音效

API描述
enableVoiceAITuner启用或关闭语音 AI 调音器。
getAudioEffectManager获取用于管理音效文件的 IAudioEffectManager 实例。
setAdvancedAudioOptions设置高级音频选项。
setAINSMode设置是否启用 AI 降噪功能并设置降噪模式。
setAudioEffectParameters设置 SDK 预设音效的参数。
setAudioEffectPreset设置 SDK 预设的音效效果。
setLocalVoiceEqualization设置本地语音的均衡效果。
setLocalVoiceFormant设置共振峰比例以改变人声音色。
setLocalVoicePitch设置本地语音的音调。
setLocalVoiceReverb设置本地语音的混响效果。
setVoiceBeautifierParameters设置预设美声特效的参数。
setVoiceBeautifierPreset设置预设的美声效果。
setVoiceConversionPreset设置 SDK 预设的变声效果。
表格内容超出当前宽度，可横向滚动查看更多列。

听声辨位

API描述
enableSoundPositionIndication启用或关闭远端用户的立体声声像功能。
setRemoteVoicePosition设置远端用户语音的二维位置和音量。
setRemoteVoicePositionEx设置远端用户语音的二维位置和音量。
表格内容超出当前宽度，可横向滚动查看更多列。

空间音频

API描述
initialize初始化 ILocalSpatialAudioEngine。
clearRemotePositions移除所有远端用户的空间位置。
create创建一个 ILocalSpatialAudioEngine 实例。
enableSpatialAudio启用或关闭空间音效。
muteAllRemoteAudioStreams停止或恢复订阅所有远端用户的音频流。
muteLocalAudioStream停止或恢复发布本地音频流。
muteRemoteAudioStream停止或恢复订阅指定远端用户的音频流。
destroy销毁 ILocalSpatialAudioEngine 实例。
removeRemotePosition移除指定远端用户的空间位置信息。
setAudioRecvRange设置本地用户的音频接收范围。
setDistanceUnit设置游戏引擎中每个单位距离对应的米数。
setHeadphoneEQParameters设置耳机均衡器的低频和高频参数。
setHeadphoneEQPreset设置预设的耳机均衡器效果。
setMaxAudioRecvCount设置你在指定音频接收范围内可接收的最大音频流数量。
setPlayerAttenuation设置媒体播放器的声音衰减属性。
setRemoteAudioAttenuation设置指定用户的声音衰减效果。
setRemoteUserSpatialAudioParams设置远端用户的空间音效参数。
setSpatialAudioParams启用或关闭媒体播放器的空间音效。
setZones设置隔音区域。
updatePlayerPositionInfo更新媒体播放器的空间位置。
updateRemotePosition更新指定远端用户的空间位置。
updateSelfPosition更新本地用户的空间位置。
表格内容超出当前宽度，可横向滚动查看更多列。

本地音频合流

API描述
startLocalAudioMixer开始本地音频合流。
stopLocalAudioMixer停止本地音频合流。
updateLocalAudioMixerConfiguration更新本地音频合流配置。
表格内容超出当前宽度，可横向滚动查看更多列。

原始音频数据

API描述
getEarMonitoringAudioParamsonEarMonitoringAudioFrame 回调的音频格式设置方法。
getMixedAudioParams设置 onMixedAudioFrame 回调的音频格式。
getObservedAudioFramePosition设置音频数据观察位置。
getPlaybackAudioParamsonPlaybackAudioFrame 回调的音频格式设置方法。
getRecordAudioParams设置 onRecordAudioFrame 回调的音频格式。
registerAudioFrameObserver注册音频帧观测器对象。
setEarMonitoringAudioFrameParameters设置耳返音频数据格式。
setMixedAudioFrameParameters设置混音后用于采集和播放的原始音频数据格式。
setPlaybackAudioFrameBeforeMixingParameters [1/2]设置混音前原始音频播放数据的格式。
setPlaybackAudioFrameBeforeMixingParameters [2/2]设置 onPlaybackAudioFrameBeforeMixing 回调中返回音频数据的格式。
setPlaybackAudioFrameParameters设置原始音频播放数据的格式。
setRecordingAudioFrameParameters设置采集的原始音频数据格式。
onEarMonitoringAudioFrame耳返音频帧回调。
onMixedAudioFrame获取混合采集和播放的音频帧回调。
onPlaybackAudioFrame获取用于播放的原始音频帧回调。
onPlaybackAudioFrameBeforeMixing获取已订阅远端用户混音前的音频帧回调。
onRecordAudioFrame获取采集到的音频帧回调。
表格内容超出当前宽度，可横向滚动查看更多列。

已编码音频数据

API描述
registerAudioEncodedFrameObserver注册编码音频数据的观察器。
onMixedAudioEncodedFrame本地及所有远端用户的混音编码音频数据回调。
onPlaybackAudioEncodedFrame获取所有远端用户编码音频数据的回调。
onRecordAudioEncodedFrame本地用户编码音频数据回调。
表格内容超出当前宽度，可横向滚动查看更多列。

自定义音频采集和渲染

API描述
adjustCustomAudioPlayoutVolume调节本地播放的自定义音频轨道的音量。
adjustCustomAudioPublishVolume调节远端播放的自定义音频轨道的音量。
createCustomAudioTrack创建一个自定义音频轨道。
destroyCustomAudioTrack销毁指定的音频轨道。
enableCustomAudioLocalPlayback设置是否启用外部音频源的本地播放。
pullPlaybackAudioFrame [1/2]拉取远端混音后的音频数据用于播放。
pullPlaybackAudioFrame [2/2]拉取远端音频数据。
pushExternalAudioFrame将外部音频帧推送到 SDK。
setExternalAudioSink设置外部音频渲染器。
表格内容超出当前宽度，可横向滚动查看更多列。

音频频谱

API描述
disableAudioSpectrumMonitor禁用音频频谱监测。
enableAudioSpectrumMonitor开启音频频谱监测功能。
registerAudioSpectrumObserver注册音频频谱观察器。
unRegisterAudioSpectrumObserver取消注册音频频谱观察器。
onLocalAudioSpectrum本地音频频谱数据回调。
onRemoteAudioSpectrum远端音频频谱数据回调。
表格内容超出当前宽度，可横向滚动查看更多列。

视频基础功能

API描述
disableVideo关闭视频模块。
enableLocalVideo启用或禁用本地视频采集。
enableVideo启用视频模块。
setVideoEncoderConfiguration设置本地视频的编码器配置。
setVideoEncoderConfigurationEx设置本地视频的编码器配置。
setVideoScenario设置视频应用场景。
startPreview [1/2]启用本地视频预览。
startPreview [2/2]启用本地视频预览，并指定用于预览的视频源。
stopPreview [1/2]停止本地视频预览。
stopPreview [2/2]停止本地视频预览。
onFirstLocalVideoFrame本地视频首帧在本地视图中显示时触发的回调。
onFirstLocalVideoFramePublished本地视频首帧发布回调。
onFirstRemoteVideoFrame远端视频首帧显示回调。
onLocalVideoEvent本地视频事件发生时触发的回调。
onLocalVideoStateChanged本地视频流状态发生变化回调。
onLocalVideoStats本地视频流统计信息回调。
onRemoteVideoStateChanged远端视频状态发生改变回调。
onRemoteVideoStats报告每个远端用户发送的视频流的统计信息回调。
onUserEnableVideo远端用户启用或关闭视频模块的回调。
onUserMuteVideo远端视频状态发生改变回调。
onVideoPublishStateChanged视频发布状态发生变化回调。
onVideoSizeChanged指定用户的视频尺寸或旋转信息发生变化回调。
表格内容超出当前宽度，可横向滚动查看更多列。

摄像头采集

API描述
startCameraCapture开始视频采集。
stopCameraCapture停止摄像头采集。
表格内容超出当前宽度，可横向滚动查看更多列。

屏幕采集

API描述
queryScreenCaptureCapability查询设备在屏幕共享时支持的最高帧率。
setExternalMediaProjection配置 SDK 外部的 MediaProjection 以采集屏幕视频流。
setScreenCaptureScenario设置屏幕共享场景。
startScreenCapture开始屏幕采集。
stopScreenCapture停止屏幕采集。
updateScreenCaptureParameters更新屏幕采集参数。
表格内容超出当前宽度，可横向滚动查看更多列。

本地截图上传

API描述
enableContentInspect启用或关闭本地截图上传功能。
enableContentInspectEx启用或关闭本地截图上传功能。
takeSnapshot [1/2]截取指定用户的视频流快照并保存为 JPG 图像。
takeSnapshot [2/2]在指定的观察点截取视频截图。
takeSnapshotEx [1/2]使用连接 ID 对视频流进行截图。
takeSnapshotEx [2/2]通过连接 ID 获取指定用户的视频截图。
onSnapshotTaken视频截图结果回调。
表格内容超出当前宽度，可横向滚动查看更多列。

虚拟背景

API描述
enableVirtualBackground [1/2]启用或关闭虚拟背景功能。
enableVirtualBackground [2/2]启用虚拟背景并指定媒体源，或关闭虚拟背景。
表格内容超出当前宽度，可横向滚动查看更多列。

本地合图

API描述
startLocalVideoTranscoder开始本地视频合图。
stopLocalVideoTranscoder停止本地合图。
updateLocalTranscoderConfiguration更新本地合图配置。
onLocalVideoTranscoderError本地视频合图过程中发生错误回调。
表格内容超出当前宽度，可横向滚动查看更多列。

视频增强

API描述
addOrUpdateVideoEffect为指定的视频特效节点 ID 和模板添加或更新视频特效。
createVideoEffectObject创建一个 IVideoEffectObject 视频特效对象。
destroyVideoEffectObject销毁一个视频特效对象。
getFaceShapeAreaOptions [1/2]获取美颜区域的当前设置。
getFaceShapeAreaOptions [2/2]获取当前美颜效果区域的设置选项。
getFaceShapeBeautyOptions [1/2]获取当前的美颜特效设置。
getFaceShapeBeautyOptions [2/2]获取当前的美颜特效设置。
getOptions获取当前配置的水印显示选项。
getVideoEffectBoolParam获取视频特效中的布尔类型参数。
getVideoEffectFloatParam获取视频特效中指定参数的 float 类型值。
getVideoEffectIntParam获取视频特效中的整数类型参数。
performVideoEffectAction对指定的视频特效节点执行操作。
removeVideoEffect移除指定节点 ID 的视频特效节点。
setBeautyEffectOptions [1/2]设置美颜特效功能及其参数。
setBeautyEffectOptions [2/2]设置美颜特效选项并指定媒体源。
setColorEnhanceOptions [1/2]设置色彩增强功能。
setColorEnhanceOptions [2/2]设置色彩增强选项并指定媒体源。
setFaceShapeAreaOptions [1/2]设置面部区域的美颜特效选项并指定媒体源。
setFaceShapeAreaOptions [2/2]设置美颜增强的面部区域选项。
setFaceShapeBeautyOptions [1/2]设置美型效果并指定应用的媒体源。
setFaceShapeBeautyOptions [2/2]设置美型选项。
setFilterEffectOptions [1/2]设置滤镜特效参数并指定媒体源。
setFilterEffectOptions [2/2]设置滤镜特效选项。
setLowlightEnhanceOptions [1/2]设置暗光增强功能。
setLowlightEnhanceOptions [2/2]设置低光增强选项并指定媒体源。
setVideoDenoiserOptions [1/2]设置视频降噪功能及其选项。
setVideoDenoiserOptions [2/2]设置视频降噪并指定媒体源。
setVideoEffectBoolParam设置视频特效的布尔参数。
setVideoEffectFloatParam设置视频特效的浮点参数。
setVideoEffectIntParam设置视频特效的整数参数。
setVideoEffectStringParam设置视频效果的字符串参数。
表格内容超出当前宽度，可横向滚动查看更多列。

人脸检测

API描述
enableFaceDetection启用或关闭本地用户的人脸检测功能。
onFacePositionChanged上报本地用户的人脸检测结果。
表格内容超出当前宽度，可横向滚动查看更多列。

直播水印

API描述
addVideoWatermark [3/3]向本地视频流添加水印图像。
addVideoWatermarkEx [2/2]向本地视频添加水印图像。
clearVideoWatermarkEx从视频流中移除水印图像。
clearVideoWatermarks从视频流中移除水印图像。
getBuffer获取水印图像的数据缓冲区。
getFormat获取水印图像的格式。
getHeight获取水印图像的高度。
getId获取水印的唯一标识符。
getImageUrl获取水印图像的 URL。
getPositionInLandscapeMode获取横屏模式下水印的位置。
getPositionInPortraitMode获取竖屏模式下水印的位置。
getType获取当前水印配置中的水印类型信息。
getWidth获取水印图像的宽度。
getzOrder获取水印图像的 Z-order 索引。
isVisibleInPreview检查水印在本地视频预览中是否可见。
removeVideoWatermark从本地视频中移除水印图像。
removeVideoWatermarkEx从本地或远端视频流中移除指定的水印图像。
表格内容超出当前宽度，可横向滚动查看更多列。

垫片推流

API描述
enableVideoImageSource设置在发布视频流时是否使用图片替代当前视频画面。
表格内容超出当前宽度，可横向滚动查看更多列。

视频渲染

API描述
enableInstantMediaRendering启用音视频帧的即时渲染。
setLocalRenderMode [2/2]更新本地视频画面的显示模式。
setLocalRenderTargetFps设置本地视频渲染的最大帧率。
setRemoteRenderModeEx设置指定远端用户的视频显示模式。
setRemoteRenderTargetFps设置远端视频渲染的最大帧率。
setVideoRenderMode设置媒体播放器的渲染模式。
setupLocalVideo初始化本地视频画面。
setupRemoteVideo初始化远端视频视图。
setupRemoteVideoEx初始化远端用户的视频视图。
startMediaRenderingTracing启用视频帧渲染过程的追踪。
startMediaRenderingTracingEx启用视频帧渲染过程的追踪。
onTranscodedStreamLayoutInfo接收到携带布局信息的合图视频流回调。
onVideoRenderingTracingResult视频帧渲染事件回调。
表格内容超出当前宽度，可横向滚动查看更多列。

原始视频数据

API描述
getMirrorApplied每次 SDK 接收到视频帧时触发的回调，用于设置是否对采集的视频进行镜像。
getObservedFramePosition设置视频观察器的帧位置。
getRotationAppliedgetRotationApplied 回调在每次 SDK 接收到视频帧时触发，用于设置是否旋转采集的视频。
getVideoFormatPreference设置 SDK 输出的原始视频数据格式。
getVideoFrameProcessModegetVideoFrameProcessMode 回调。每次 SDK 接收到视频帧时触发，并提示你设置视频帧的处理模式。
registerVideoFrameObserver注册原始视频帧观察器对象。
onCaptureVideoFrame本地设备采集到视频帧时触发的回调。
onPreEncodeVideoFrame每次 SDK 接收到编码前视频帧时触发该回调。
onRenderVideoFrame远端用户发送视频帧时触发的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

已编码视频数据

API描述
registerVideoEncodedFrameObserver注册用于接收编码后视频帧的观察器对象。
onEncodedVideoFrameReceived接收端收到远端编码视频帧回调。
表格内容超出当前宽度，可横向滚动查看更多列。

自定义视频采集和渲染

API描述
createCustomVideoTrack创建一个自定义视频轨道。
destroyCustomVideoTrack销毁指定的视频轨道。
isTextureEncodeSupported检查视频是否支持 Texture 编码。
pushExternalVideoFrameById [1/2]通过视频轨道向 SDK 推送外部原始视频帧。
pushExternalVideoFrameById [2/2]通过视频轨道向 SDK 推送外部原始视频帧。
setExternalRemoteEglContext设置用于渲染远端视频流的 EGL 上下文。
setExternalVideoSource配置外部视频源。
表格内容超出当前宽度，可横向滚动查看更多列。

音乐文件播放

API描述
adjustAudioMixingPlayoutVolume调节本地播放的混音音量。
adjustAudioMixingPublishVolume调节用于发布的混音音量。
adjustAudioMixingVolume调节混音时的音量。
getAudioMixingCurrentPosition获取当前混音的播放位置（毫秒）。
getAudioMixingDuration获取音频文件的混音时长（毫秒）。
getAudioMixingPlayoutVolume获取本地播放的混音音量。
getAudioMixingPublishVolume获取用于发布的混音音量。
getAudioTrackCount获取当前音乐文件的音轨索引。
pauseAudioMixing暂停播放和混音的音乐文件。
resumeAudioMixing恢复播放和混音的音乐文件。
selectAudioTrack选择播放过程中使用的音轨。
selectMultiAudioTrack选择要在本地设备播放和发布到频道的音轨。
setAudioMixingDualMonoMode设置当前音频文件的声道模式。
setAudioMixingPitch设置本地音乐文件的音调。
setAudioMixingPlaybackSpeed设置当前音频文件的播放速度。
setAudioMixingPosition设置混音的播放位置。
startAudioMixing [2/2]开始播放音乐文件。
stopAudioMixing停止播放音乐文件。
onAudioMixingPositionChanged音乐文件播放进度回调。
onAudioMixingStateChanged音乐文件播放状态变化回调。
表格内容超出当前宽度，可横向滚动查看更多列。

音效文件播放

API描述
getEffectCurrentPosition获取指定音效文件的播放位置。
getEffectDuration获取音效文件的时长。
getEffectsVolume获取音效的音量。
getVolumeOfEffect获取指定音效文件的音量。
pauseAllEffects暂停所有音效。
pauseEffect暂停指定音效文件的播放。
playAllEffects播放所有音效。
playEffect [1/2]播放指定的本地或在线音效文件。
playEffect [2/2]播放指定的本地或在线音效文件。
playEffectEx [1/2]在频道中播放指定的音效。
playEffectEx [2/2]在频道中播放指定音效。
preloadEffect [1/2]预加载指定的音效文件。
preloadEffect [2/2]将指定的音效文件预加载到内存中。
preloadEffectEx [1/2]将指定音效预加载到频道中。
preloadEffectEx [2/2]将指定音效预加载到频道中。
resumeAllEffects恢复播放所有音效文件。
resumeEffect恢复播放指定音效。
setEffectPosition设置音效文件的播放位置。
setEffectsVolume设置音效的播放音量。
setVolumeOfEffect设置指定音效文件的播放音量。
stopAllEffects停止播放所有音效。
stopEffect停止播放指定音效。
unloadEffect释放指定的预加载音效文件。
onAudioEffectFinished本地音效文件播放完成时的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

初始化

API描述
createMediaPlayer创建一个 IMediaPlayer 对象。
destroy销毁媒体播放器实例。
getMediaPlayerCacheManager获取一个 IMediaPlayerCacheManager 实例。
表格内容超出当前宽度，可横向滚动查看更多列。

媒体资源打开

API描述
open [1/2]打开媒体资源。
open [2/2]通过 URI 地址打开媒体文件。
openWithMediaSource打开媒体文件并配置播放场景。
preloadSrc预加载媒体资源。
switchSrc切换正在播放的媒体资源。
unloadSrc卸载预加载的媒体资源。
表格内容超出当前宽度，可横向滚动查看更多列。

媒体资源播放和渲染

API描述
selectAudioTrack在播放过程中选择音频轨道。
setAudioDualMonoMode设置当前音频文件的声道模式。
setAudioPitch设置当前媒体资源的音调。
setLoopCount设置音效的循环播放次数。
setPlaybackSpeed设置当前音频文件的播放速度。
setPlayerOption设置媒体播放器选项。
setPlayerOptionString设置媒体播放器的参数选项。
setView设置渲染视图。
表格内容超出当前宽度，可横向滚动查看更多列。

播放器控制

API描述
adjustPlayoutVolume调节本地播放音量。
adjustPublishSignalVolume调节用于发布的媒体文件音量。
mute设置是否静音媒体文件。
pause暂停播放。
play播放媒体文件。
playPreloadedSrc播放预加载的媒体资源。
resume恢复播放媒体文件。
seek跳转到新的播放位置。
stop [1/2]停止播放媒体轨道。
onSeek当 SDK 定位媒体资源数据时触发的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

播放信息获取

API描述
getAudioBufferDelay获取播放媒体文件时的音频缓冲延迟。
getDuration获取媒体资源的时长。
getMediaPlayerId获取媒体播放器的 ID。
getMute报告媒体资源是否被静音。
getPlayoutVolume获取本地播放音量。
getPlayPosition获取当前本地播放进度。
getPlaySrc [1/2]获取当前正在播放的媒体资源路径。
getPublishSignalVolume获取用于发布的媒体文件音量。
getState获取当前播放状态。
getStreamCount获取媒体资源中媒体流的数量。
getStreamInfo获取媒体流的详细信息。
onPlayerPlaybackStats报告正在播放的媒体文件的统计信息回调。
表格内容超出当前宽度，可横向滚动查看更多列。

音视频观测器

API描述
registerAudioFrameObserver注册音频帧观测器对象。
registerPlayerObserver注册媒体播放器观察器。
registerVideoFrameObserver注册视频帧观察者对象。
unRegisterPlayerObserver释放媒体播放器观察者。
onAudioVolumeIndication报告媒体播放器音量的回调。
onFrame播放器接收到音频帧时触发的回调。
onFrame播放器接收到视频帧时触发的回调。
onMetaData接收到媒体元数据时触发的回调。
onPlayBufferUpdatedonPlayBufferUpdated 回调：报告缓冲数据可支持的播放时长。
onPlayerEvent播放器事件回调。
onPlayerInfoUpdated媒体播放器相关信息发生变化时的回调。
onPlayerStateChanged播放状态发生改变回调。
onPlayerSrcInfoChanged媒体资源视频码率发生变化回调。
onPositionChanged播放进度回调。
onPreloadEvent预加载媒体资源事件回调。
onReadDataSDK 读取媒体资源数据时触发的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

媒体播放器缓存

API描述
enableAutoRemoveCache设置是否自动删除缓存的媒体文件。
getCacheDir获取缓存媒体文件的存储路径。
getCacheFileCount获取已缓存的媒体文件数量。
getMaxCacheFileCount获取可缓存的媒体文件的最大数量。
getMaxCacheFileSize获取缓存媒体文件聚合存储空间的最大大小。
removeAllCaches删除媒体播放器中所有缓存的媒体文件。
removeCacheByUri删除缓存的媒体文件。
removeOldCache删除最少使用的缓存媒体文件。
setCacheDir设置要缓存的媒体文件的存储路径。
setMaxCacheFileCount设置可缓存的媒体文件数量上限。
setMaxCacheFileSize设置缓存媒体文件的聚合存储空间的最大大小。
onPlayerCacheStats报告正在缓存的媒体文件的统计信息回调。
表格内容超出当前宽度，可横向滚动查看更多列。

版权音乐

API描述
createMusicPlayer创建一个音乐播放器。
destroy销毁 IAgoraMusicContentCenter 实例。
destroyMusicPlayer销毁音乐播放器对象。
getCaches获取已缓存的音乐资源信息。
getInternalSongCode创建音乐资源副歌片段的内部标识符。
getLyric获取音乐资源歌词的下载链接。
getMusicCharts获取所有音乐排行榜。
getMusicCollectionByMusicChartId [1/2]根据音乐榜单 ID 获取音乐资源列表。
getMusicCollectionByMusicChartId [2/2]根据音乐榜单 ID 获取音乐资源列表。
getPlaySrc [2/2]获取当前播放的音乐资源的标识符或 URL。
getSongSimpleInfo检索特定音乐资源的详细信息。
initialize初始化 IAgoraMusicContentCenter。
isPreloaded检查指定音乐资源是否已预加载。
open [2/2]通过 URL 打开音乐资源。
open [1/2]通过资源 ID 打开音乐资源。
preload [2/2]预加载版权音乐资源。
registerEventHandler注册版权音乐内容中心的回调事件。
removeCache删除已缓存的音乐资源。
renewToken更新 Token。
searchMusic [1/2]搜索音乐资源。
searchMusic [2/2]搜索音乐资源。
setPlayMode设置音乐曲目的播放模式。
stop [2/2]停止播放音乐资源。
unregisterEventHandler取消注册版权音乐内容中心的事件回调。
onLyricResult歌词下载链接回调。
onMusicChartsResult获取音乐排行榜后的回调。
onMusicCollectionResult获取音乐资源列表的回调。
onPreLoadEvent预加载音乐资源事件的回调。
onSongSimpleInfoResult获取音乐资源详细信息的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

音视频录制

API描述
createMediaRecorder创建用于音视频录制的录制器实例。
destroyMediaRecorder销毁音视频录制器实例。
setMediaRecorderObserver注册一个用于音视频录制的回调观察者。
startAudioRecording [1/2]开始客户端录音。
startAudioRecording [2/2]开始客户端录制并应用录制配置。
startRecording开始录制音频和视频流。
stopAudioRecording停止客户端录制音频。
stopRecording停止录制音视频流。
onRecorderInfoUpdated录制信息更新回调。
onRecorderStateChanged录制状态发生变化时的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

跨频道媒体流转发

API描述
pauseAllChannelMediaRelay暂停向所有目标频道的跨频道媒体流转发。
resumeAllChannelMediaRelay恢复向所有目标频道的跨频道媒体流转发。
resumeAllChannelMediaRelayEx恢复向所有目标频道的跨频道媒体流转发。
startOrUpdateChannelMediaRelay开始或更新跨频道媒体流转发。
startOrUpdateChannelMediaRelayEx开始或更新跨频道媒体流转发。
stopChannelMediaRelay停止跨频道媒体流转发。
stopChannelMediaRelayEx停止跨频道媒体流转发。
onChannelMediaRelayStateChanged跨频道媒体流转发状态发生变化回调。
表格内容超出当前宽度，可横向滚动查看更多列。

旁路推流

API描述
startRtmpStreamWithoutTranscoding开始向 CDN 推送音视频流（不进行转码）。
startRtmpStreamWithoutTranscodingEx开始向 CDN 推送未经转码的媒体流。
startRtmpStreamWithTranscoding开始旁路推流并设置转码配置。
startRtmpStreamWithTranscodingEx开始旁路推流并设置转码配置。
stopRtmpStream停止向指定 CDN 地址推送媒体流。
stopRtmpStreamEx停止向指定 CDN 地址推送媒体流。
updateRtmpTranscoding更新旁路推流的转码配置。
updateRtmpTranscodingEx更新旁路推流的转码配置。
onRtmpStreamingEvent旁路推流事件回调。
onRtmpStreamingStateChanged旁路推流状态发生变化回调。
onTranscodingUpdated发布端云端转码配置更新回调。
表格内容超出当前宽度，可横向滚动查看更多列。

数据流 Datastream

API描述
createDataStream [1/2]创建一个数据流，用于提升数据传输的可靠性和顺序性。
createDataStream [2/2]创建一个数据流。
createDataStreamEx [2/2]创建一个数据流。
sendStreamMessage发送数据流消息。
sendStreamMessageEx发送数据流消息。
onStreamMessage远端用户发送数据流时的回调。
onStreamMessageErroronStreamMessageError 回调：本地用户未收到远端用户发送的数据流时触发。
表格内容超出当前宽度，可横向滚动查看更多列。

媒体流附属信息分发

API描述
getMaxMetadataSize当 SDK 请求元数据最大大小时触发的回调。
registerMediaMetadataObserver注册元数据观察器。
unregisterMediaMetadataObserver取消注册指定的元数据观察者。
onMetadataReceived本地用户接收到元数据时触发的回调。
onReadyToSendMetadataSDK 准备好发送元数据时触发的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

音频路由

API描述
isSpeakerphoneEnabled检查是否启用扬声器播放音频。
setDefaultAudioRoutetoSpeakerphone设置默认音频播放路由。
setEnableSpeakerphone设置是否将音频路由切换到扬声器。
setRouteInCommunicationMode在通信音频模式下设置音频播放路由。
onAudioRouteChanged本地音频路由发生变化时的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

视频设备管理

API描述
getCameraMaxZoomFactor获取摄像头支持的最大变焦倍数。
isCameraAutoFocusFaceModeSupported检查设备是否支持人脸自动对焦功能。
isCameraExposurePositionSupported检查设备是否支持手动曝光。
isCameraExposureSupported查询当前摄像头是否支持调节曝光值。
isCameraFaceDetectSupported检查设备摄像头是否支持人脸检测。
isCameraFocusSupported检查设备是否支持手动对焦功能。
isCameraTorchSupported检查设备是否支持相机闪光灯功能。
isCameraZoomSupported检查设备是否支持摄像头变焦。
queryCameraFocalLengthCapability查询摄像头支持的焦距能力。
queryCodecCapability查询 SDK 的视频编解码能力。
setCameraAutoFocusFaceModeEnabled启用或关闭摄像头人脸自动对焦功能。
setCameraCapturerConfiguration设置摄像头采集配置。
setCameraExposureFactor设置摄像头曝光值。
setCameraExposurePosition设置摄像头曝光位置。
setCameraFocusPositionInPreview设置摄像头的手动对焦位置。
setCameraTorchOn打开或关闭摄像头闪光灯。
setCameraZoomFactor设置摄像头的缩放因子。
switchCamera [1/2]切换前置和后置摄像头。
switchCamera [2/2]通过摄像头 ID 切换摄像头。
onCameraExposureAreaChanged摄像头曝光区域发生变化回调。
onCameraFocusAreaChanged摄像头对焦区域发生变化的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

音频设备管理

API描述
getAudioDeviceInfo获取音频设备信息。
startPlaybackDeviceTest启动本地音频播放设备测试。
startRecordingDeviceTest启动音频采集设备测试。
stopPlaybackDeviceTest停止音频播放设备测试。
stopRecordingDeviceTest停止音频采集设备测试。
表格内容超出当前宽度，可横向滚动查看更多列。

插件

API描述
addExtension添加扩展。
enableExtension启用或禁用扩展功能。
getExtensionProperty [1/2]获取扩展组件的详细信息。
getExtensionProperty [2/2]获取扩展组件的详细信息。
registerExtension注册一个扩展。
setExtensionProperty设置扩展组件的属性。
setExtensionProviderProperty设置扩展提供方的属性。
onErrorWithContext扩展运行异常时触发的回调。
onEventWithContext扩展事件回调。
onStartedWithContext扩展启用成功回调。
onStoppedWithContext扩展被禁用时触发的回调。
表格内容超出当前宽度，可横向滚动查看更多列。

网络及其他

API描述
complain允许你在通话结束后投诉通话质量。
enableEncryption启用或关闭内置加密功能。
enableEncryptionEx启用或关闭内置加密功能。
getCallId获取当前通话 ID。
getCallIdEx获取与连接 ID 对应的通话 ID。
getConnectionState获取 SDK 当前的连接状态。
getConnectionStateEx获取 SDK 当前的连接状态。
getCurrentMonotonicTimeInMs获取 SDK 当前的单调时间。
getErrorDescription获取警告或错误码对应的描述信息。
getNativeHandle获取原生 SDK 的 C++ 句柄。
getNetworkType获取本地网络连接类型。
getNtpWallTimeInMs获取当前 NTP（网络时间协议）时间。
getSdkVersion获取 SDK 的版本号。
isFeatureAvailableOnDevice检查当前设备是否支持指定的高级功能。
queryDeviceScore查询设备评分。
rate允许用户在通话结束后对通话进行评分。
sendCustomReportMessage上报自定义消息。
sendCustomReportMessageEx支持上报和分析自定义消息。
setAVSyncSource设置发布端的音视频同步源。
setCloudProxy设置云代理服务。
setLocalAccessPoint配置连接到声网私有媒体服务器接入模块。
setParameters通过配置 JSON 选项，为 SDK 提供技术预览功能或特殊定制。
setRemoteSubscribeFallbackOption [1/2]根据网络状况设置订阅端的视频流回退选项。
startEchoTest开始音视频设备回路测试。
startLastmileProbeTest开始 Last-mile 网络探测测试。
stopEchoTest停止音频通话测试。
stopLastmileProbeTest停止 Last-mile 网络探测测试。
onConnectionLostonConnectionLost 回调：当 SDK 在连接中断后 10 秒内无法重新连接到声网边缘服务器时触发。
onConnectionStateChanged网络连接状态发生变化回调。
onEncryptionError内置加密错误回调。
onLastmileProbeResult上行和下行 Last-mile 网络探测测试结果的回调。
onLastmileQuality本地用户的 Last-mile 网络质量回调。
onMultipathStats多路径传输统计信息回调。
onNetworkQualityonNetworkQuality 回调。报告频道中每个用户的 Last-mile 网络质量。
onNetworkTypeChanged本地网络类型发生变化时的回调。
onPermissionError设备权限获取失败时触发的回调。
onPermissionGrantedonPermissionGranted 回调。用于上报已授予的权限。
onProxyConnected代理连接状态回调。
onRemoteSubscribeFallbackToAudioOnlyonRemoteSubscribeFallbackToAudioOnly 回调。当远端媒体流因网络变化在音频流与视频流之间切换时触发。
onUplinkNetworkInfoUpdated上行网络信息发生变化回调。
表格内容超出当前宽度，可横向滚动查看更多列。

咨询电话

400 632 6626

上海声网科技有限公司

Copyright © 2026 声网保留所有权利