接口对比

# 腾讯8.9与阿里2.4.1接口对比

整理时间：2021年7月14日
腾讯版本：v8.9
阿里版本：2.4.1
端：android

本文统计：腾讯官网文档暴露出来的主要接口与回调151个

# 方法

# 基础方法

API	阿里	描述	对齐
sharedInstance (opens new window)	getInstance (opens new window)	创建 TRTCCloud (opens new window) 单例。	是
destroySharedInstance (opens new window)	destroy (opens new window)	销毁 TRTCCloud (opens new window) 单例。	是
setListener (opens new window)	setRtcEngineEventListener (opens new window)/setRtcEngineNotify (opens new window)	设置回调接口 TRTCCloudListener，用户获得来自 TRTCCloud (opens new window) 的各种状态通知。	是
setListenerHandler (opens new window)	(opens new window)	设置驱动 TRTCCloudListener (opens new window) 回调的队列。	否

# 房间相关接口函数

API	阿里	描述	对齐
enterRoom (opens new window)	joinChannel (opens new window)	进入房间。	是
exitRoom (opens new window)	leaveChannel (opens new window)	离开房间。	是
switchRole (opens new window)	setClientRole (opens new window)	切换角色，仅适用于直播场景（TRTC_APP_SCENE_LIVE 和 TRTC_APP_SCENE_VOICE_CHATROOM）。	是
ConnectOtherRoom (opens new window)	startChannelRelay (opens new window)	请求跨房通话（主播 PK）。	是
DisconnectOtherRoom (opens new window)	stopChannelRelay (opens new window)	退出跨房通话。	是
setDefaultStreamRecvMode (opens new window)	setDefaultSubscribeAllRemoteAudioStreams (opens new window)/setDefaultSubscribeAllRemoteVideoStreams (opens new window)	设置音视频数据接收模式，需要在进房前设置才能生效。	否
createSubCloud (opens new window)	createChannel (opens new window)	创建子 TRTCCloud (opens new window)实例。	是
destroySubCloud (opens new window)	destroyChannel (opens new window)	销毁子 TRTCCloud (opens new window)实例。	是
switchRoom (opens new window)	switchChannel (opens new window)	切换房间。	是

# CDN 相关接口函数

API	阿里	描述	对齐
startPublishing (opens new window)	-	开始向腾讯云的直播 CDN 推流。	否
stopPublishing (opens new window)	-	停止向腾讯云的直播 CDN 推流。	否
startPublishCDNStream (opens new window)	startPublishLiveStream (opens new window)	开始向友商云的直播 CDN 转推。	是
stopPublishCDNStream (opens new window)	stopPublishLiveStream (opens new window)	停止向非腾讯云地址转推。	是
setMixTranscodingConfig (opens new window)	setLiveStreamingViewConfig (opens new window)	设置云端的混流转码参数。	是

# 视频相关接口函数

API	阿里	描述	对齐
startLocalPreview (opens new window)	startPreview (opens new window)	开启摄像头预览。	是
stopLocalPreview (opens new window)	stopPreview (opens new window)	停止摄像头预览。	是
muteLocalVideo (opens new window)	muteLocalCamera (opens new window)	暂停/恢复推送本地的视频数据。	是
setVideoMuteImage (opens new window)	-	设置暂停推送本地视频时要推送的图片。	是
startRemoteView (opens new window)	setRemoteViewConfig (opens new window)	开始拉取并显示指定用户的远端画面。	是
stopRemoteView (opens new window)	-	停止显示远端视频画面，同时不再拉取该远端用户的视频数据流。	否
stopAllRemoteView (opens new window)	-	停止显示所有远端视频画面，同时不再拉取远端用户的视频数据流。	否
muteRemoteVideoStream (opens new window)	subscribeRemoteAudioStream (opens new window)/subscribeRemoteVideoStream (opens new window)	暂停/恢复接收指定的远端视频流。	是
muteAllRemoteVideoStreams (opens new window)	subscribeAllRemoteAudioStreams (opens new window)/subscribeAllRemoteVideoStreams (opens new window)	暂停/恢复接收所有远端视频流。	是
setVideoEncoderParam (opens new window)	-	设置视频编码器相关参数。	否
setSubStreamEncoderParam (opens new window)	-	设置辅路视频的编码器参数。	否
setNetworkQosParam (opens new window)	publishLocalDualStream (opens new window)	设置网络流控相关参数。	是
setLocalRenderParams (opens new window)	setLocalViewConfig (opens new window)	设置本地图像的渲染模式。	是
setRemoteRenderParams (opens new window)	-	设置远端图像相关参数。	否
setVideoEncoderRotation (opens new window)	setCameraCapturerConfiguration (opens new window)	设置视频编码输出的画面方向，即设置远端用户观看到的和服务器录制的画面方向。	是
setVideoEncoderMirror (opens new window)	setCameraCapturerConfiguration (opens new window)	设置编码器输出的画面镜像模式。	是
setGSensorMode (opens new window)	-	设置重力感应的适应模式。	否
enableEncSmallVideoStream (opens new window)	publishLocalDualStream (opens new window)	开启大小画面双路编码模式。	是
setRemoteVideoStreamType (opens new window)	setRemoteViewConfig (opens new window)	切换指定远端用户的大小画面。	是
setPriorRemoteVideoStreamType (opens new window)	publishLocalDualStream (opens new window)	设定观看方优先选择的视频质量。	是
snapshotVideo (opens new window)	snapshotVideo (opens new window)	视频画面截图。	是
startLocalPreview (opens new window)	enableLocalVideo (opens new window)	开启摄像头预览。	是

# 音频相关接口函数

API	阿里	描述	对齐
startLocalAudio (opens new window)	startAudioCapture (opens new window)+muteLocalMic (opens new window)	开启本地音频的采集和上行。	否
stopLocalAudio (opens new window)	stopAudioCapture (opens new window)+muteLocalMic (opens new window)	关闭本地音频的采集和上行。	否
muteLocalAudio (opens new window)	muteLocalMic (opens new window)	静音/取消静音本地的音频。	是
setAudioRoute (opens new window)	-	设置音频路由。	否
muteRemoteAudio (opens new window)	muteRemoteAudioPlaying (opens new window)	静音/取消静音指定的远端用户的声音。	是
muteAllRemoteAudio (opens new window)	muteAllRemoteAudioPlaying (opens new window)	静音/取消静音所有用户的声音。	是
setRemoteAudioVolume (opens new window)	setRemoteAudioVolume (opens new window)	设置某个远程用户的播放音量。	是
setAudioCaptureVolume (opens new window)	-	设置 SDK 采集音量。	否
getAudioCaptureVolume (opens new window)	-	获取 SDK 采集音量。	否
setAudioPlayoutVolume (opens new window)	setPlayoutVolume (opens new window)	设置 SDK 播放音量。	是
getAudioPlayoutVolume (opens new window)	-	获取 SDK 播放音量。	否
enableAudioVolumeEvaluation (opens new window)	enableAudioVolumeIndication (opens new window)	启用音量大小提示。	是
startAudioRecording (opens new window)	startRecord (opens new window)	开始录音。	是
stopAudioRecording (opens new window)	stopRecord (opens new window)	停止录音。	是
setSystemVolumeType (opens new window)	setAudioProfile (opens new window)	设置通话时使用的系统音量类型。	是
enableAudioEarMonitoring (opens new window)	enableEarBack (opens new window)	开启耳返。	是
startLocalRecording (opens new window)	startRecord (opens new window)	开启本地录制。	是
stopLocalRecording (opens new window)	stopRecord (opens new window)	停止本地录制。	是

# 设备管理接口

API	阿里	描述	对齐（备注）
getDeviceManager (opens new window)	-	获取设备管理类 TXDeviceManager。	否（功能阿里也有，就是设计不一样）

# 美颜特效和变脸特效

API	阿里	描述	对齐
getBeautyManager (opens new window)	-	获取美颜管理对象。	否（阿里美颜：setBeautyEffect (opens new window)）
setWatermark (opens new window)	addVideoWatermark (opens new window)	添加水印。	是

# 音乐特效和人声特效

API	阿里	描述	对齐
getAudioEffectManager (opens new window)	-	获取音效管理类 TXAudioEffectManager。	否（阿里没有单独的类，但是这个类的功能都有）

# 辅流相关接口函数

API	阿里	描述	对齐
startScreenCapture (opens new window)	startScreenShare (opens new window)	启动屏幕分享。	是
stopScreenCapture (opens new window)	stopScreenShare (opens new window)	停止屏幕采集。	是
pauseScreenCapture (opens new window)	-	暂停屏幕分享。	否
resumeScreenCapture (opens new window)	-	恢复屏幕分享。	否

# 自定义采集和渲染

API	阿里	描述	对齐
enableCustomVideoCapture (opens new window)	-	启用视频自定义采集模式。可以选择推送辅流、主画面视频流、小画面视频流。	否
sendCustomVideoData (opens new window)	setExternalVideoSource (opens new window)	向 SDK 投送自己采集的视频数据。	是（应该是同一个功能）
enableCustomAudioCapture (opens new window)	pushExternalVideoFrame (opens new window)	启用音频自定义采集模式。	是
sendCustomAudioData (opens new window)	setExternalAudioSource (opens new window)	投送自己采集的音频数据。	是
enableMixExternalAudioFrame (opens new window)	setMixedWithMic (opens new window)	控制外部音频是否要混入推流和混入播放。	是
mixExternalAudioFrame (opens new window)	pushExternalAudioFrameRawData (opens new window)	向 SDK 投送音频数据。	是
generateCustomPTS (opens new window)	-	生成自定义采集时间戳。	否
setLocalVideoProcessListener (opens new window)	registerLocalVideoTextureObserver (opens new window)	第三方美颜的视频数据回调。	是
setLocalVideoRenderListener (opens new window)	-	设置本地视频的自定义渲染回调。	否
setRemoteVideoRenderListener (opens new window)	-	设置远端视频的自定义渲染回调。	否
setAudioFrameListener (opens new window)	registerAudioObserver (opens new window)	设置音频数据回调。	是
setCapturedRawAudioFrameCallbackFormat (opens new window)	-	设置本地麦克风采集回调出来的 AudioFrame 格式。	否
setLocalProcessedAudioFrameCallbackFormat (opens new window)	-	设置本地采集并经过音频模块前处理后的音频数据回调出来的 AudioFrame 格式。	否
setMixedPlayAudioFrameCallbackFormat (opens new window)	-	设置送入扬声器播放的音频数据回调的 AudioFrame 格式。	否
enableCustomAudioRendering (opens new window)	-	开启音频自定义播放。	否
getCustomAudioRenderingFrame (opens new window)	-	获取可播放的音频数据。	否

# 自定义消息发送

API	阿里	描述	对齐
sendCustomCmdMsg (opens new window)	-	发送自定义消息给房间内所有用户。	否
sendSEIMsg (opens new window)	sendMediaExtensionMsg (opens new window)	将小数据量的自定义数据嵌入视频帧中。	是

# 设备和网络测试

API	阿里	描述	对齐
startSpeedTest (opens new window)	startNetworkQualityProbeTest (opens new window)	开始进行网络测速（视频通话期间请勿测试，以免影响通话质量）。	是
stopSpeedTest (opens new window)	stopNetworkQualityProbeTest (opens new window)	停止服务器测速。	是

# Log 相关接口函数

API	阿里	描述	对齐
getSDKVersion (opens new window)	getSDKVersion (opens new window)	获取 SDK 版本信息。	是
setLogLevel (opens new window)	setLogLevel (opens new window)	设置 Log 输出级别。	是
setConsoleEnabled (opens new window)	-	启用或禁用控制台日志打印。	否
setLogCompressEnabled (opens new window)	-	启用或禁用 Log 的本地压缩。	否
setLogDirPath (opens new window)	setLogDirPath (opens new window)	修改日志保存路径。	是
setLogListener (opens new window)	-	设置日志回调。	否
showDebugView (opens new window)	-	显示仪表盘。	否
setDebugViewMargin (opens new window)	-	设置仪表盘的边距。	否
callExperimentalAPI (opens new window)	-	调用实验性 API 接口。	否

# 播放背景音乐的回调接口

API	阿里	描述	对齐
onBGMStart (opens new window)	onAudioPlayingStateChanged (opens new window)	音乐播放开始的回调通知。	是
onBGMProgress (opens new window)	-	音乐播放进度的回调通知。	否
onBGMComplete (opens new window)	-	音乐播放结束的回调通知。	否

# 回调

# TRTCCloudDelegate @ TXLiteAVSDK

# 错误事件和警告事件

API	阿里	描述	对齐
onError (opens new window)	onOccurError (opens new window)	错误回调，表示 SDK 不可恢复的错误，一定要监听并分情况给用户适当的界面提示。	是
onWarning (opens new window)	onOccurWarning (opens new window)	警告回调，用于告知您一些非严重性问题，例如出现卡顿或者可恢复的解码失败。	是

# 房间事件回调

API	阿里	描述	对齐
onEnterRoom (opens new window)	onJoinChannelResult (opens new window)	已加入房间的回调。	是
onExitRoom (opens new window)	onLeaveChannelResult (opens new window)	离开房间的事件回调。	是
onSwitchRole (opens new window)	onUpdateRoleNotify (opens new window)	切换角色的事件回调。	是
onConnectOtherRoom (opens new window)	onChannelRelayStateChanged (opens new window)	请求跨房通话（主播 PK）的结果回调。	否
onDisConnectOtherRoom (opens new window)	onChannelRelayStateChanged (opens new window)	结束跨房通话（主播 PK）的结果回调。	否
onSwitchRoom (opens new window)	-	切换房间 (switchRoom) 的结果回调。	否（阿里：SDK会先触发离开原频道的onLeaveChannelResult (opens new window)回调，再返回加入新频道的onJoinChannelResult回调。）

# 成员事件回调

API	阿里	描述	对齐
onRemoteUserEnterRoom (opens new window)	onRemoteUserOnLineNotify (opens new window)	有用户加入当前房间。	是
onRemoteUserLeaveRoom (opens new window)	onRemoteUserOffLineNotify (opens new window)	有用户离开当前房间。	是
onUserVideoAvailable (opens new window)	onVideoSubscribeStateChanged (opens new window)	远端用户是否存在可播放的主路画面（一般用于摄像头）。	是
onUserSubStreamAvailable (opens new window)	onSubscribeStreamTypeChanged (opens new window)	远端用户是否存在可播放的辅路画面（一般用于屏幕分享）。	是
onUserAudioAvailable (opens new window)	onAudioSubscribeStateChanged (opens new window)	远端用户是否存在可播放的音频数据。	是
onFirstVideoFrame (opens new window)	onFirstLocalVideoFrameDrawn (opens new window)/onFirstRemoteVideoFrameDrawn (opens new window)	开始渲染本地或远程用户的首帧画面。	是
onFirstAudioFrame (opens new window)	-	开始播放远程用户的首帧音频（本地声音暂不通知）。	否（阿里：onFirstAudioPacketReceived (opens new window)）
onSendFirstLocalVideoFrame (opens new window)	onFirstVideoPacketSent (opens new window)	首帧本地视频数据已经被送出。	是
onSendFirstLocalAudioFrame (opens new window)	onFirstAudioPacketSent (opens new window)	首帧本地音频数据已经被送出。	是

# 统计和质量回调

API	阿里	描述	对齐
onNetworkQuality (opens new window)	onNetworkQualityChanged (opens new window)	网络质量，该回调每2秒触发一次，统计当前网络的上行和下行质量。	是
onStatistics (opens new window)	onAliRtcStats (opens new window)	技术指标统计回调。	是

# 服务器事件回调

API	阿里	描述	对齐
onConnectionLost (opens new window)	onConnectionLost (opens new window)	SDK 跟服务器的连接断开。	是
onTryToReconnect (opens new window)	onTryToReconnect (opens new window)	SDK 尝试重新连接到服务器。	是
onConnectionRecovery (opens new window)	onConnectionRecovery (opens new window)	SDK 跟服务器的连接恢复。	是
onSpeedTest (opens new window)	-	服务器测速的回调，SDK 对多个服务器 IP 做测速，每个 IP 的测速结果通过这个回调通知。	否

# 硬件设备事件回调

API	阿里	描述	对齐
onCameraDidReady (opens new window)	-	摄像头准备就绪。	否
onMicDidReady (opens new window)	-	麦克风准备就绪。	否
onAudioRouteChanged (opens new window)	onAudioRouteChanged (opens new window)	音频路由发生变化，音频路由即声音由哪里输出（扬声器或听筒）。	是
onUserVoiceVolume (opens new window)	onAudioVolume (opens new window)	用于提示音量大小的回调，包括每个 userId 的音量和远端总音量。	是

# 自定义消息的接收回调

API	阿里	描述	对齐
onRecvCustomCmdMsg (opens new window)	-	收到自定义消息回调。	否
onMissCustomCmdMsg (opens new window)	-	自定义消息丢失回调。	否
onRecvSEIMsg (opens new window)	onMediaExtensionMsgReceived (opens new window)	收到 SEI 消息的回调。	是

# CDN 旁路转推回调

API	阿里	描述	对齐
onStartPublishing (opens new window)	-	开始向腾讯云的直播 CDN 推流的回调，对应于 TRTCCloud (opens new window) 中的 startPublishing() 接口。	否
onStopPublishing (opens new window)	-	停止向腾讯云的直播 CDN 推流的回调，对应于 TRTCCloud (opens new window) 中的 stopPublishing() 接口。	否
onStartPublishCDNStream (opens new window)	onPublishLiveStreamStateChanged (opens new window)/onPublishTaskStateChanged (opens new window)	启动旁路推流到 CDN 完成的回调。	否
onStopPublishCDNStream (opens new window)	-	停止旁路推流到 CDN 完成的回调。	否
onSetMixTranscodingConfig (opens new window)	-	设置云端的混流转码参数的回调，对应于 TRTCCloud (opens new window) 中的 setMixTranscodingConfig() 接口。	否

# 屏幕分享回调

API	阿里	描述	对齐
onScreenCaptureStarted (opens new window)	onScreenSharePublishStateChanged (opens new window)	当屏幕分享开始时，SDK 会通过此回调通知。	否
onScreenCapturePaused (opens new window)	onScreenSharePublishStateChanged (opens new window)	当屏幕分享调用 TRTCCloud.pauseScreenCapture() (opens new window) 暂停时，SDK 会通过此回调通知。	否
onScreenCaptureResumed (opens new window)	onScreenSharePublishStateChanged (opens new window)	当屏幕分享调用 TRTCCloud.resumeScreenCapture() (opens new window) 恢复时，SDK 会通过此回调通知。	否
onScreenCaptureStopped (opens new window)	onScreenSharePublishStateChanged (opens new window)	当屏幕分享停止时，SDK 会通过此回调通知。	否

# 本地录制回调

API	阿里	描述	对齐
onLocalRecordBegin (opens new window)	onMediaRecordEvent (opens new window)	录制任务已经开始。	否
onLocalRecording (opens new window)	onMediaRecordEvent (opens new window)	录制任务进行中。	否
onLocalRecordComplete (opens new window)	onMediaRecordEvent (opens new window)	录制任务已结束。	否

# 视频数据帧的自定义渲染回调

API	阿里	描述	对齐
onRenderVideoFrame (opens new window)	-	自定义视频渲染回调。	否

# 第三方美颜回调

API	阿里	描述	对齐
onGLContextCreated (opens new window)	onTextureCreate (opens new window)	SDK 内部的 OpenGL 环境的创建通知。	是
onProcessVideoFrame (opens new window)	onTextureUpdate (opens new window)	第三方美颜的视频数据回调，需要使用 TRTCCloud (opens new window) 中的 setLocalVideoProcessListener 接口进行设置。	是
onGLContextDestory (opens new window)	onTextureDestroy (opens new window)	SDK 内部的 OpenGL 环境的销毁通知。	是

# 声音数据帧的自定义处理回调

API	阿里	描述	对齐
onCapturedRawAudioFrame (opens new window)	onCaptureRawData (opens new window)	本地麦克风采集到的音频数据回调。	是
onLocalProcessedAudioFrame (opens new window)	onCaptureData (opens new window)	本地采集并经过音频模块前处理后的音频数据回调。	是
onRemoteUserAudioFrame (opens new window)	onPlaybackAudioFrameBeforeMixing (opens new window)	混音前的每一路远程用户的音频数据，即混音前的各路原始数据。例如，对某一路音频进行文字转换时，您必须使用该路音频的原始数据。	是
onMixedPlayAudioFrame (opens new window)	-	各路音频数据混合后送入喇叭播放的音频数据。	否
onMixedAllAudioFrame (opens new window)	-	SDK所有音频数据混合后的数据回调（包括采集音频数据和所有播放音频数据）。	否

# 日志相关回调

API	阿里	描述	对齐
onLog (opens new window)	-	有日志打印时的回调。	否

# 截图回调

API	阿里	描述	对齐
onSnapshotComplete (opens new window)	onSnapshotComplete (opens new window)	截图完成时回调。	是