API 概览
声网通过全球部署的 SD-RTN™,提供可以灵活搭配的 API 组合,实现质量可靠的实时音视频通信。
初始化相关
| API | 描述 |
|---|---|
| createAgoraRtcEngine | 创建 RtcEngine 对象。 |
| initialize | 初始化 RtcEngine。 |
| registerEventHandler | 添加主回调事件。 |
| createAgoraRtcEngineEx | 创建 RtcEngineEx 对象。 |
| getMediaEngine | 获取 MediaEngine 对象。 |
| initialize | 创建一个 MediaPlayerController。 |
| release | 销毁 RtcEngine 对象。 |
| unregisterEventHandler | 删除指定的回调事件。 |
频道相关
| API | 描述 |
|---|---|
| setChannelProfile | 设置频道场景。 |
| joinChannel | 设置媒体选项并加入频道。 |
| joinChannelEx | 加入频道。 |
| updateChannelMediaOptions | 加入频道后更新频道媒体选项。 |
| updateChannelMediaOptionsEx | 加入频道后更新频道媒体选项 。 |
| leaveChannel | 设置频道选项并离开频道。 |
| leaveChannelEx | 设置频道选项并离开频道。 |
| preloadChannel | 使用 token、channelId、uid 预加载频道。 |
| updatePreloadChannelToken | 更新预加载频道的通配 Token。 |
| renewToken | 更新 Token。 |
| setClientRole | 设置直播场景下的用户角色和观众端延时级别。 |
| onClientRoleChanged | 用户角色、观众端延时级别已切换回调。 |
| onClientRoleChangeFailed | 用户角色切换失败回调。 |
| onError | 发生错误回调。 |
| onJoinChannelSuccess | 成功加入频道回调。 |
| onLeaveChannel | 离开频道回调。 |
| onRejoinChannelSuccess | 成功重新加入频道回调。 |
| onRequestToken | Token 已过期回调。 |
| onRtcStats | 当前通话相关的统计信息回调。 |
| onTokenPrivilegeWillExpire | Token 即将在 30s 内过期回调。 |
| onUserJoined | 远端用户(通信场景)/主播(直播场景)加入当前频道回调。 |
| onUserOffline | 远端用户(通信场景)/主播(直播场景)离开当前频道回调。 |
发布和订阅
音频基础功能
| API | 描述 |
|---|---|
| adjustPlaybackSignalVolume | 调节本地播放的所有远端用户信号音量。 |
| adjustUserPlaybackSignalVolume | 调节本地播放的指定远端用户信号音量。 |
| adjustUserPlaybackSignalVolumeEx | 调节本地播放的指定远端用户信号音量。 |
| disableAudio | 关闭音频模块。 |
| enableAudio | 启用音频模块。 |
| enableAudioVolumeIndication | 启用用户音量提示。 |
| enableAudioVolumeIndicationEx | 启用用户音量提示。 |
| setAudioProfile | 设置音频编码属性和音频场景。 |
| setAudioScenario | 设置音频场景。 |
| setAudioSessionOperationRestriction | 设置 SDK 对 Audio Session 的操作权限。 |
| onActiveSpeaker | 监测到远端最活跃用户回调。 |
| onAudioVolumeIndication | 用户音量提示回调。 |
| onFirstLocalAudioFramePublished | 已发布本地音频首帧回调。 |
| onLocalAudioStateChanged | 本地音频状态发生改变回调。 |
| onLocalAudioStats | 通话中本地音频流的统计信息回调。 |
| onRemoteAudioStateChanged | 远端音频流状态发生改变回调。 |
| onRemoteAudioStats | 通话中远端音频流的统计信息回调。 |
| onRemoteAudioTransportStats | 通话中远端音频流传输的统计信息回调。 |
| onUserMuteAudio | 远端用户(通信场景)/主播(直播场景)停止或恢复发送音频流回调。 |
音频采集
| API | 描述 |
|---|---|
| adjustLoopbackSignalVolume | 调节声卡采集信号音量。 |
| adjustRecordingSignalVolume | 调节音频采集信号音量。 |
| enableInEarMonitoring | 开启耳返功能。 |
| enableLocalAudio | 开启或关闭本地音频采集。 |
| enableLoopbackRecording | 开启声卡采集。 |
| enableLoopbackRecordingEx | 开启声卡采集。 |
| muteRecordingSignal | 是否将录音信号静音。 |
| setInEarMonitoringVolume | 设置耳返音量。 |
人声音效
| API | 描述 |
|---|---|
| enableVoiceAITuner | 开启或关闭 AI 调音器功能。 |
| setAdvancedAudioOptions | 设置音频的高级选项。 |
| setAINSMode | 设置是否开启 AI 降噪功能并设置降噪模式。 |
| setAudioEffectParameters | 设置 SDK 预设人声音效的参数。 |
| setAudioEffectPreset | 设置 SDK 预设的人声音效。 |
| setLocalVoiceEqualization | 设置本地语音音效均衡。 |
| setLocalVoiceFormant | 设置共振峰比率以改变语音的音色。 |
| setLocalVoicePitch | 设置本地语音音调。 |
| setLocalVoiceReverb | 设置本地音效混响。 |
| setVoiceBeautifierParameters | 设置预设美声效果的参数。 |
| setVoiceBeautifierPreset | 设置预设的美声效果。 |
| setVoiceConversionPreset | 设置预设的变声效果。 |
听声辨位
| API | 描述 |
|---|---|
| enableSoundPositionIndication | 开启/关闭远端用户的语音立体声。 |
| setRemoteVoicePosition | 设置远端用户声音的 2D 位置,即水平面位置。 |
| setRemoteVoicePositionEx | 设置远端用户声音的 2D 位置,即水平面位置。 |
空间音频
| API | 描述 |
|---|---|
| initialize | 初始化 LocalSpatialAudioEngine。 |
| clearRemotePositions | 删除所有远端用户的空间位置信息。 |
| enableSpatialAudio | 开启或关闭空间音频。 |
| getLocalSpatialAudioEngine | 获取 LocalSpatialAudioEngine 对象。 |
| muteAllRemoteAudioStreams | 取消或恢复订阅所有远端用户的音频流。 |
| muteLocalAudioStream | 取消或恢复发布本地音频流。 |
| muteRemoteAudioStream | 取消或恢复订阅指定远端用户的音频流。 |
| release | 销毁 BaseSpatialAudioEngine。 |
| removeRemotePosition | 删除指定远端用户的空间位置信息。 |
| setAudioRecvRange | 设置本地用户的音频接收范围。 |
| setDistanceUnit | 设置游戏引擎单位距离的长度(米)。 |
| setHeadphoneEQParameters | 设置耳机均衡器的低频和高频参数。 |
| setHeadphoneEQPreset | 设置预设的耳机均衡效果。 |
| setMaxAudioRecvCount | 设置音频接收范围内最多可接收的音频流数。 |
| setPlayerAttenuation | 设置媒体播放器的声音衰减属性。 |
| setRemoteAudioAttenuation | 设置指定用户的声音衰减效果。 |
| setRemoteUserSpatialAudioParams | 设置远端用户的空间音频参数。 |
| setSpatialAudioParams | 开启或关闭媒体播放器的空间音频。 |
| setZones | 设置隔声区域。 |
| updatePlayerPositionInfo | 更新媒体播放器的空间位置。 |
| updateRemotePosition | 更新远端用户的空间位置信息。 |
| updateSelfPosition | 更新本地用户的空间位置。 |
本地音频合流
| API | 描述 |
|---|---|
| startLocalAudioMixer | 开启本地音频合流。 |
| stopLocalAudioMixer | 停止本地音频合流。 |
| updateLocalAudioMixerConfiguration | 更新本地音频合流的配置。 |
原始音频数据
| API | 描述 |
|---|---|
| registerAudioFrameObserver | 注册音频观测器对象。 |
| setEarMonitoringAudioFrameParameters | 设置耳返的音频数据格式。 |
| setMixedAudioFrameParameters | 设置采集和播放音频混音后的原始音频数据格式。 |
| setPlaybackAudioFrameBeforeMixingParameters | 设置混音前的原始音频播放数据格式。 |
| setPlaybackAudioFrameParameters | 设置播放的原始音频数据格式。 |
| setRecordingAudioFrameParameters | 设置采集的原始音频数据格式。 |
| unregisterAudioFrameObserver | 取消注册音频帧观测器。 |
| onEarMonitoringAudioFrame | 获得耳返的原始音频数据。 |
| onMixedAudioFrame | 获取采集和播放音频混音后的数据。 |
| onPlaybackAudioFrame | 获得播放的原始音频数据。 |
| onPlaybackAudioFrameBeforeMixing | 获取所订阅的远端用户混音前的声音。 |
| onRecordAudioFrame | 获得采集的原始音频数据。 |
已编码音频数据
| API | 描述 |
|---|---|
| registerAudioEncodedFrameObserver | 注册音频编码数据观测器。 |
| unregisterAudioEncodedFrameObserver | 取消注册音频编码数据观测器。 |
| onMixedAudioEncodedFrame | 获取本地和所有远端用户混音后的音频编码数据。 |
| onPlaybackAudioEncodedFrame | 获取所有远端用户的音频编码数据。 |
| onRecordAudioEncodedFrame | 获取本地用户的音频编码数据。 |
自定义音频采集和渲染
| API | 描述 |
|---|---|
| adjustCustomAudioPlayoutVolume | 调节自定义音频采集轨道在本地播放的音量。 |
| adjustCustomAudioPublishVolume | 调节自定义音频采集轨道在远端播放的音量。 |
| createCustomAudioTrack | 创建一个自定义音频采集轨道。 |
| destroyCustomAudioTrack | 销毁指定的音频轨道。 |
| enableCustomAudioLocalPlayback | 设置是否在本地播放外部音频源。 |
| pullAudioFrame | 拉取远端音频数据。 |
| pushAudioFrame | 推送外部音频帧。 |
| setExternalAudioSink | 设置外部音频渲染。 |
音频频谱
| API | 描述 |
|---|---|
| disableAudioSpectrumMonitor | 关闭音频频谱监测。 |
| enableAudioSpectrumMonitor | 开启音频频谱监测。 |
| registerAudioSpectrumObserver | 注册音频频谱观测器。 |
| unregisterAudioSpectrumObserver | 取消注册音频频谱观测器。 |
| onLocalAudioSpectrum | 获取本地音频频谱。 |
| onRemoteAudioSpectrum | 获取远端音频频谱。 |
视频基础功能
| API | 描述 |
|---|---|
| disableVideo | 关闭视频模块。 |
| enableLocalVideo | 开关本地视频采集。 |
| enableVideo | 启用视频模块。 |
| setVideoEncoderConfiguration | 设置视频编码属性。 |
| setVideoEncoderConfigurationEx | 设置视频编码属性。 |
| setVideoScenario | 设置视频业务场景。 |
| startPreviewWithoutSourceType | 开启视频预览。 |
| startPreview | 开启视频预览并指定预览的视频源。 |
| stopPreview | 停止视频预览。 |
| onFirstLocalVideoFrame | 已显示本地视频首帧回调。 |
| onFirstLocalVideoFramePublished | 已发布本地视频首帧回调。 |
| onFirstRemoteVideoDecoded | 已接收到远端视频并完成解码回调。 |
| onFirstRemoteVideoFrame | 渲染器已接收首帧远端视频回调。 |
| onLocalVideoStateChanged | 本地视频状态发生改变回调。 |
| onLocalVideoStats | 本地视频流统计信息回调。 |
| onRemoteVideoStateChanged | 远端视频状态发生改变回调。 |
| onRemoteVideoStats | 通话中远端视频流的统计信息回调。 |
| onUserEnableVideo | 远端用户开/关视频模块回调。 |
| onUserMuteVideo | 远端用户取消或恢复发布视频流回调。 |
| onVideoPublishStateChanged | 视频发布状态改变回调。 |
| onVideoSizeChanged | 本地或远端视频大小和旋转信息发生改变回调。 |
摄像头采集
| API | 描述 |
|---|---|
| setCameraStabilizationMode | 设置摄像头防抖模式。 |
| startCameraCapture | 开始通过摄像头采集视频。 |
| stopCameraCapture | 停止通过摄像头采集视频。 |
屏幕采集
| API | 描述 |
|---|---|
| getScreenCaptureSources | 获取可共享的屏幕和窗口对象列表。 |
| queryScreenCaptureCapability | 查询设备在屏幕共享时支持的最高帧率。 |
| setExternalMediaProjection | 设置 SDK 外部的 MediaProjection 采集屏幕视频流。 |
| setScreenCaptureContentHint | 设置屏幕共享内容类型。 |
| setScreenCaptureScenario | 设置屏幕共享的场景。 |
| startScreenCapture | 开始屏幕采集。 |
| startScreenCaptureBySourceType | 开始屏幕采集并指定视频源。 |
| startScreenCaptureByDisplayId | 开始采集指定屏幕的视频流。 |
| startScreenCaptureByWindowId | 开始采集指定窗口的视频流。 |
| stopScreenCapture | 停止屏幕采集。 |
| stopScreenCaptureBySourceType | 停止对指定的视频源进行屏幕采集。 |
| updateScreenCapture | 更新屏幕采集的参数配置。 |
| updateScreenCaptureParameters | 更新屏幕采集的参数配置。 |
| updateScreenCaptureRegion | 更新屏幕采集的区域。 |
本地截图上传
| API | 描述 |
|---|---|
| enableContentInspect | 开启/关闭本地截图上传。 |
| enableContentInspectEx | 开启/关闭本地截图上传。 |
| takeSnapshot | 对视频截图。 |
| takeSnapshotWithConfig | 在指定观测位置进行视频截图。 |
| takeSnapshotEx | 使用连接 ID 获取视频截图。 |
| takeSnapshotWithConfigEx | 使用连接 ID 获取指定观测位置的视频截图。 |
| onSnapshotTaken | 视频截图结果回调。 |
虚拟背景
| API | 描述 |
|---|---|
| enableVirtualBackground | 开启/关闭虚拟背景。 |
本地合图
| API | 描述 |
|---|---|
| startLocalVideoTranscoder | 开启本地合图。 |
| stopLocalVideoTranscoder | 停止本地合图。 |
| updateLocalTranscoderConfiguration | 更新本地合图配置。 |
| onLocalVideoTranscoderError | 本地合图发生错误回调。 |
视频增强
| API | 描述 |
|---|---|
| getFaceShapeAreaOptions | 获取美型部位选项。 |
| getFaceShapeBeautyOptions | 获取美型效果选项。 |
| setBeautyEffectOptions | 设置美颜效果选项。 |
| setColorEnhanceOptions | 设置色彩增强功能。 |
| setFaceShapeAreaOptions | 设置美型部位选项并指定媒体源。 |
| setFaceShapeBeautyOptions | 设置美型效果选项并指定媒体源。 |
| setFilterEffectOptions | 设置滤镜效果选项并指定媒体源。 |
| setLowlightEnhanceOptions | 设置暗光增强功能。 |
| setVideoDenoiserOptions | 设置视频降噪功能。 |
人脸检测
| API | 描述 |
|---|---|
| enableFaceDetection | 开启/关闭本地人脸检测。 |
| onFacePositionChanged | 报告本地人脸检测结果。 |
语音驱动
| API | 描述 |
|---|---|
| registerFaceInfoObserver | 注册一个人脸信息观测器。 |
| unregisterFaceInfoObserver | 取消注册人脸信息观测器。 |
| onFaceInfo | 报告已获取语音驱动插件处理后的人脸信息。 |
人像锁定
| API | 描述 |
|---|---|
| enableCameraCenterStage | 开启或关闭人像锁定功能。 |
| isCameraCenterStageSupported | 查询摄像头是否支持人像锁定。 |
直播水印
| API | 描述 |
|---|---|
| addVideoWatermark | 添加本地视频水印。 |
| addVideoWatermarkEx | 添加本地视频水印。 |
| clearVideoWatermarkEx | 删除已添加的视频水印。 |
| clearVideoWatermarks | 删除已添加的视频水印。 |
垫片推流
| API | 描述 |
|---|---|
| enableVideoImageSource | 设置是否开启垫片推流功能。 |
视频渲染
| API | 描述 |
|---|---|
| enableInstantMediaRendering | 开启音视频帧加速渲染。 |
| setLocalRenderMode | 更新本地视图显示模式。 |
| setLocalRenderTargetFps | 设置本地视频渲染的最大帧率。 |
| setRemoteRenderMode | 更新远端视图显示模式。 |
| setRemoteRenderModeEx | 设置远端视图显示模式。 |
| setRemoteRenderTargetFps | 设置视频在远端渲染的最大帧率。 |
| setRenderMode | 设置播放器视图的渲染模式。 |
| setupLocalVideo | 初始化本地视图。 |
| setupRemoteVideo | 初始化远端用户视图。 |
| setupRemoteVideoEx | 初始化远端用户视图。 |
| startMediaRenderingTracing | 开启视频帧渲染数据打点。 |
| startMediaRenderingTracingEx | 开启视频帧渲染数据打点。 |
| onTranscodedStreamLayoutInfo | 已接收携带布局信息的合图视频流回调。 |
| onVideoRenderingTracingResult | 视频帧渲染事件回调。 |
原始视频数据
| API | 描述 |
|---|---|
| registerVideoFrameObserver | 注册原始视频观测器对象。 |
| unregisterVideoFrameObserver | 取消注册视频帧观测器。 |
| onCaptureVideoFrame | 获取本地设备采集到的视频数据。 |
| onFrame | 已获取视频帧回调。 |
| onPreEncodeVideoFrame | 获取本地视频编码前的视频数据。 |
| onRenderVideoFrame | 获取远端发送的视频数据。 |
已编码视频数据
| API | 描述 |
|---|---|
| registerVideoEncodedFrameObserver | 为编码后的视频图像注册视频帧接收观测器。 |
| unregisterVideoEncodedFrameObserver | 为编码后的视频图像取消注册视频帧接收观测器。 |
| onEncodedVideoFrameReceived | 报告接收端已收到远端发送的待解码视频帧。 |
自定义视频采集和渲染
| API | 描述 |
|---|---|
| createCustomVideoTrack | 创建一个自定义的视频轨道。 |
| destroyCustomVideoTrack | 销毁指定的视频轨道。 |
| pushVideoFrame | 将外部原始视频帧通过自定义视频轨道发布到频道中。 |
| setExternalRemoteEglContext | 设置远端视频流渲染的 EGL 环境上下文。 |
| setExternalVideoSource | 设置外部视频源。 |
音乐文件播放
| API | 描述 |
|---|---|
| adjustAudioMixingPlayoutVolume | 调节音乐文件在本地播放的音量。 |
| adjustAudioMixingPublishVolume | 调节音乐文件远端播放音量。 |
| adjustAudioMixingVolume | 调节音乐文件的播放音量。 |
| getAudioMixingCurrentPosition | 获取音乐文件的播放进度。 |
| getAudioMixingDuration | 获取音乐文件总时长。 |
| getAudioMixingPlayoutVolume | 获取音乐文件的本地播放音量。 |
| getAudioMixingPublishVolume | 获取音乐文件的远端播放音量。 |
| getAudioTrackCount | 获取当前音乐文件的音轨索引。 |
| pauseAudioMixing | 暂停播放音乐文件。 |
| resumeAudioMixing | 恢复播放音乐文件。 |
| selectAudioTrack | 指定当前音乐文件的播放音轨。 |
| selectMultiAudioTrack | 选择本地播放和发送至远端的音轨。 |
| setAudioMixingDualMonoMode | 设置当前音频文件的声道模式。 |
| setAudioMixingPitch | 调整本地播放的音乐文件的音调。 |
| setAudioMixingPlaybackSpeed | 设置当前音乐文件的播放速度。 |
| setAudioMixingPosition | 设置音乐文件的播放位置。 |
| startAudioMixing | 开始播放音乐文件。 |
| stopAudioMixing | 停止播放音乐文件。 |
| onAudioMixingPositionChanged | 音乐文件播放进度回调。 |
| onAudioMixingStateChanged | 音乐文件的播放状态已改变回调。 |
音效文件播放
| API | 描述 |
|---|---|
| getEffectCurrentPosition | 获取指定音效文件的播放进度。 |
| getEffectDuration | 获取指定音效文件总时长。 |
| getEffectsVolume | 获取音效文件的播放音量。 |
| getVolumeOfEffect | 获取指定音效文件的播放音量。 |
| pauseAllEffects | 暂停所有音效文件播放。 |
| pauseEffect | 暂停音效文件播放。 |
| playAllEffects | 播放所有音效文件。 |
| playEffect | 播放指定的本地或在线音效文件。 |
| preloadEffect | 将音效文件加载至内存。 |
| resumeAllEffects | 恢复播放所有音效文件。 |
| resumeEffect | 恢复播放指定音效文件。 |
| setEffectPosition | 设置指定音效文件的播放位置。 |
| setEffectsVolume | 设置音效文件的播放音量。 |
| setVolumeOfEffect | 设置指定音效文件的播放音量。 |
| stopAllEffects | 停止播放所有音效文件。 |
| stopEffect | 停止播放指定音效文件。 |
| unloadAllEffects | 从内存释放所有预加载音效文件。 |
| unloadEffect | 从内存释放某个预加载的音效文件。 |
| onAudioEffectFinished | 本地音效文件播放已结束回调。 |
虚拟节拍器
| API | 描述 |
|---|---|
| configRhythmPlayer | 配置虚拟节拍器。 |
| startRhythmPlayer | 开启虚拟节拍器。 |
| stopRhythmPlayer | 关闭虚拟节拍器。 |
| onRhythmPlayerStateChanged | 虚拟节拍器状态发生改变回调。 |
初始化
| API | 描述 |
|---|---|
| createMediaPlayer | 创建媒体播放器对象。 |
| destroyMediaPlayer | 销毁媒体播放器。 |
| getMediaPlayerCacheManager | 获取 MediaPlayerCacheManager 实例。 |
媒体资源打开
| API | 描述 |
|---|---|
| open | 打开媒体资源。 |
| openWithMediaSource | 打开媒体资源并进行播放设置。 |
| preloadSrc | 预加载媒体资源。 |
| switchSrc | 切换媒体资源。 |
| unloadSrc | 释放预加载的媒体资源。 |
媒体资源播放和渲染
| API | 描述 |
|---|---|
| selectAudioTrack | 指定当前音频文件的播放音轨。 |
| setAudioDualMonoMode | 设置当前音频文件的声道模式。 |
| setAudioPitch | 调整当前播放的媒体资源的音调。 |
| setLoopCount | 设置循环播放。 |
| setPlaybackSpeed | 设置当前音频文件的播放速度。 |
| setPlayerOptionInInt | 设置媒体播放器选项。 |
| setPlayerOptionInString | 设置媒体播放器选项。 |
| setView | 设置播放器渲染视图。 |
播放器控制
| API | 描述 |
|---|---|
| adjustPlayoutVolume | 调节本地播放音量。 |
| adjustPublishSignalVolume | 调节远端用户听到的音量。 |
| mute | 设置是否静音。 |
| pause | 暂停播放。 |
| play | 播放媒体文件。 |
| playPreloadedSrc | 播放预加载的媒体资源。 |
| resume | 暂停后恢复播放。 |
| seek | 定位到媒体文件的指定播放位置。 |
| stop | 停止播放。 |
播放信息获取
| API | 描述 |
|---|---|
| getDuration | 获取媒体文件总时长。 |
| getMediaPlayerId | 获取播放器 ID。 |
| getMute | 获取当前播放的媒体文件是否静音。 |
| getPlayoutVolume | 获取当前本地播放音量。 |
| getPlayPosition | 获取当前播放进度。 |
| getPlaySrc | 获取播放的媒体资源的路径。 |
| getPublishSignalVolume | 获取远端用户听到的音量。 |
| getState | 获取播放器当前状态。 |
| getStreamCount | 获取当前媒体文件中媒体流的数量。 |
| getStreamInfo | 通过媒体流的索引值获取媒体流信息。 |
| onPlayerPlaybackStats | 报告当前播放的媒体资源的相关信息。 |
音视频观测器
| API | 描述 |
|---|---|
| registerAudioFrameObserver | 注册音频帧观测器。 |
| registerPlayerSourceObserver | 注册一个播放观测器。 |
| registerVideoFrameObserver | 注册视频帧观测器。 |
| unregisterAudioFrameObserver | 取消注册音频帧观测器。 |
| unregisterPlayerSourceObserver | 取消注册播放观测器。 |
| unregisterVideoFrameObserver | 取消注册视频帧观测器。 |
| onAudioVolumeIndication | 媒体播放器音量提示回调。 |
| onFrame | 已获取音频帧回调。 |
| onMetaData | 报告已获取媒体附属信息。 |
| onPlayBufferUpdated | 报告当前缓冲数据能播放的时间。 |
| onPlayerEvent | 报告播放器的事件。 |
| onPlayerInfoUpdated | 媒体播放器相关信息发生改变回调。 |
| onPlayerSourceStateChanged | 报告播放器状态改变。 |
| onPlayerSrcInfoChanged | 媒体资源视频码率变化回调。 |
| onPositionChanged | 报告当前媒体资源的播放进度。 |
| onPreloadEvent | 报告预加载媒体资源的事件。 |
媒体播放器缓存
| API | 描述 |
|---|---|
| enableAutoRemoveCache | 设置是否开启自动清除缓存文件功能。 |
| getCacheDir | 获取缓存文件的储存路径。 |
| getCacheFileCount | 获取当前已缓存的媒体文件的总数量。 |
| getMaxCacheFileCount | 获取所设置的缓存文件数量上限。 |
| getMaxCacheFileSize | 获取所设置的缓存文件总缓存的上限。 |
| removeAllCaches | 删除媒体播放器中所有已缓存的媒体文件。 |
| removeCacheByUri | 删除指定的已缓存媒体文件。 |
| removeOldCache | 删除媒体播放器中近期最少使用的一个缓存媒体文件。 |
| setCacheDir | 设置待缓存的媒体文件的储存路径。 |
| setMaxCacheFileCount | 设置缓存媒体文件数量的上限。 |
| setMaxCacheFileSize | 设置缓存媒体文件的总缓存大小的上限。 |
| onPlayerCacheStats | 报告当前缓存中的媒体资源的相关信息。 |
版权音乐
| API | 描述 |
|---|---|
| createMusicPlayer | 创建音乐播放器。 |
| destroyMusicPlayer | 销毁音乐播放器对象。 |
| get | 获取音乐榜单的详细信息。 |
| getCaches | 获取已缓存的音乐资源信息。 |
| getCount | 获取本次请求的音乐榜单数量。 |
| getCount | 获取本次请求的音乐数量。 |
| getInternalSongCode | 创建音乐资源的副歌片段编号。 |
| getLyric | 获取音乐资源的歌词下载地址。 |
| getMusic | 获取当前页面列表中音乐资源的详细信息。 |
| getMusicCharts | 获取全部音乐榜单。 |
| getMusicCollectionByMusicChartId | 通过音乐榜单的 ID 获取指定榜单的音乐资源列表。 |
| getMusicContentCenter | 获取 MusicContentCenter。 |
| getPage | 获取音乐资源列表当前页的页码。 |
| getPageSize | 获取 SDK 实际返回的音乐资源数量。 |
| getSongSimpleInfo | 获取某一音乐资源的详细信息。 |
| getTotal | 获取列表内音乐资源的总数量。 |
| initialize | 初始化 MusicContentCenter。 |
| isPreloaded | 检测音乐资源是否已被预加载。 |
| openWithSongCode | 通过音乐资源编号打开音乐资源。 |
| preload | 预加载音乐资源。 |
| registerEventHandler | 注册音乐内容中心回调事件。 |
| release | 释放音乐内容中心所占用的所有资源。 |
| removeCache | 删除已缓存的音乐资源。 |
| renewToken | 更新 Token。 |
| searchMusic | 搜索音乐资源。 |
| setPlayMode | 设置音乐资源的播放模式。 |
| unregisterEventHandler | 取消注册音乐内容中心事件回调。 |
| onLyricResult | 歌词下载地址回调。 |
| onMusicChartsResult | 获取音乐榜单回调。 |
| onMusicCollectionResult | 获取音乐资源列表回调。 |
| onPreLoadEvent | 报告预加载音乐资源的事件。 |
| onSongSimpleInfoResult | 音乐资源的详细信息回调。 |
音视频录制
| API | 描述 |
|---|---|
| createMediaRecorder | 创建音视频录制对象。 |
| destroyMediaRecorder | 销毁音视频录制对象。 |
| setMediaRecorderObserver | 注册 MediaRecorderObserver 观测器。 |
| startAudioRecording | 开始客户端录音并进行录音配置。 |
| startRecording | 开启音视频流录制。 |
| stopAudioRecording | 停止客户端录音。 |
| stopRecording | 停止音视频流录制。 |
| onRecorderInfoUpdated | 录制信息更新回调。 |
| onRecorderStateChanged | 录制状态发生改变回调。 |
跨频道媒体流转发
| API | 描述 |
|---|---|
| pauseAllChannelMediaRelay | 暂停向所有目标频道转发媒体流。 |
| pauseAllChannelMediaRelayEx | 暂停向所有目标频道转发媒体流。 |
| resumeAllChannelMediaRelay | 恢复向所有目标频道转发媒体流。 |
| resumeAllChannelMediaRelayEx | 恢复向所有目标频道转发媒体流。 |
| startOrUpdateChannelMediaRelay | 开始或更新跨频道媒体流转发。 |
| startOrUpdateChannelMediaRelayEx | 开始或更新跨频道媒体流转发。 |
| stopChannelMediaRelay | 停止跨频道媒体流转发。一旦停止,主播会退出所有目标频道。 |
| stopChannelMediaRelayEx | 停止跨频道媒体流转发。一旦停止,主播会退出所有目标频道。 |
| onChannelMediaRelayStateChanged | 跨频道媒体流转发状态发生改变回调。 |
旁路推流
| API | 描述 |
|---|---|
| startRtmpStreamWithoutTranscoding | 开始非转码推流。 |
| startRtmpStreamWithoutTranscodingEx | 开始非转码推流。 |
| startRtmpStreamWithTranscoding | 开始旁路推流并设置转码属性。 |
| startRtmpStreamWithTranscodingEx | 开始旁路推流并设置转码属性。 |
| stopRtmpStream | 结束旁路推流。 |
| stopRtmpStreamEx | 结束旁路推流。 |
| updateRtmpTranscoding | 更新旁路推流转码属性。 |
| updateRtmpTranscodingEx | 更新旁路推流转码属性。 |
| onRtmpStreamingEvent | 旁路推流事件回调。 |
| onRtmpStreamingStateChanged | 旁路推流状态发生改变回调。 |
| onTranscodingUpdated | 旁路推流转码设置已被更新回调。 |
直推 CDN
| API | 描述 |
|---|---|
| setDirectCdnStreamingAudioConfiguration | 设置主播端直接向 CDN 推流时的音频编码属性。 |
| setDirectCdnStreamingVideoConfiguration | 设置主播端直接向 CDN 推流时的视频编码属性。 |
| startDirectCdnStreaming | 设置主播端开始直接向 CDN 推流。 |
| stopDirectCdnStreaming | 设置主播端停止直接向 CDN 推流。 |
| onDirectCdnStreamingStateChanged | CDN 推流状态改变回调。 |
| onDirectCdnStreamingStats | CDN 推流统计数据回调。 |
数据流 Datastream
| API | 描述 |
|---|---|
| createDataStream | 创建数据流。 |
| createDataStreamEx | 创建数据流。 |
| sendStreamMessage | 发送数据流。 |
| sendStreamMessageEx | 发送数据流。 |
| onStreamMessage | 接收到对方数据流消息的回调。 |
| onStreamMessageError | 接收对方数据流消息发生错误的回调。 |
媒体流附属信息分发
| API | 描述 |
|---|---|
| registerMediaMetadataObserver | 注册媒体 metadata 观测器用于接收或发送 metadata。 |
| sendMetaData | 发送媒体附属信息。 |
| setMaxMetadataSize | 设置媒体附属信息的最大大小。 |
| unregisterMediaMetadataObserver | 取消注册媒体 metadata 观测器。 |
| onMetadataReceived | 接收端已收到 metadata。 |
音频路由
| API | 描述 |
|---|---|
| isSpeakerphoneEnabled | 检查扬声器状态启用状态。 |
| setDefaultAudioRouteToSpeakerphone | 设置默认的音频路由。 |
| setEnableSpeakerphone | 开启或关闭扬声器播放。 |
| setRouteInCommunicationMode | 选择通话音量模式下的音频路由。 |
| onAudioRoutingChanged | 音频路由已发生变化回调。 |
视频设备管理
音频设备管理
插件
| API | 描述 |
|---|---|
| enableExtension | 启用/禁用插件。 |
| getExtensionProperty | 获取插件的详细信息。 |
| loadExtensionProvider | 加载插件。 |
| registerExtension | 注册插件。 |
| setExtensionProperty | 设置插件的属性。 |
| setExtensionProviderProperty | 设置插件服务商的属性。 |
| onExtensionErrorWithContext | 插件出错回调。 |
| onExtensionEventWithContext | 插件事件回调。 |
| onExtensionStartedWithContext | 插件已启用成功回调。 |
| onExtensionStoppedWithContext | 插件已禁用回调。 |