Copyright (c) 2021 Tencent. All rights reserved.
Module: TRTCCloudListener @ TXLiteAVSDK
Function: 腾讯云实时音视频的事件回调接口
TRTCCloudListener
TRTCVideoRenderListener
函数列表 | 描述 |
自定义视频渲染回调 |
TRTCVideoFrameListener
函数列表 | 描述 |
SDK 内部 OpenGL 环境已经创建的通知 | |
用于对接第三方美颜组件的视频处理回调 | |
SDK 内部 OpenGL 环境被销毁的通知 |
TRTCAudioFrameListener
函数列表 | 描述 |
本地采集并经过音频模块前处理后的音频数据回调 | |
本地采集并经过音频模块前处理、音效处理和混 BGM 后的音频数据回调 | |
混音前的每一路远程用户的音频数据 | |
将各路待播放音频混合之后并在最终提交系统播放之前的数据回调 | |
SDK 所有音频混合后的音频数据(包括采集到的和待播放的) | |
耳返的音频数据 |
TRTCLogListener
函数列表 | 描述 |
本地 LOG 的打印回调 |
TRTCCloudListener
函数列表 | 描述 |
错误事件回调 | |
警告事件回调 | |
进入房间成功与否的事件回调 | |
离开房间的事件回调 | |
切换角色的事件回调 | |
切换房间的结果回调 | |
请求跨房通话的结果回调 | |
结束跨房通话的结果回调 | |
更改跨房主播上行能力的结果回调 | |
有用户加入当前房间 | |
有用户离开当前房间 | |
某远端用户发布/取消了主路视频画面 | |
某远端用户发布/取消了辅路视频画面 | |
某远端用户发布/取消了自己的音频 | |
SDK 开始渲染自己本地或远端用户的首帧画面 | |
SDK 开始播放远端用户的首帧音频 | |
自己本地的首个视频帧已被发布出去 | |
自己本地的首个音频帧已被发布出去 | |
远端视频状态变化的事件回调 | |
远端音频状态变化的事件回调 | |
用户视频大小发生改变回调 | |
网络质量的实时统计回调 | |
音视频技术指标的实时统计回调 | |
网速测试的结果回调 | |
SDK 与云端的连接已经断开 | |
SDK 正在尝试重新连接到云端 | |
SDK 与云端的连接已经恢复 | |
摄像头准备就绪 | |
麦克风准备就绪 | |
当前音频路由发生变化(仅适用于移动设备) | |
音量大小的反馈回调 | |
收到自定义消息的事件回调 | |
自定义消息丢失的事件回调 | |
收到 SEI 消息的回调 | |
开始向腾讯云直播 CDN 上发布音视频流的事件回调 | |
停止向腾讯云直播 CDN 上发布音视频流的事件回调 | |
开始向非腾讯云 CDN 上发布音视频流的事件回调 | |
停止向非腾讯云 CDN 上发布音视频流的事件回调 | |
设置云端混流的排版布局和转码参数的事件回调 | |
开始发布媒体流的事件回调 | |
更新媒体流的事件回调 | |
停止媒体流的事件回调 | |
RTMP/RTMPS 推流状态发生改变回调 | |
屏幕分享开启的事件回调 | |
屏幕分享暂停的事件回调 | |
屏幕分享恢复的事件回调 | |
屏幕分享停止的事件回调 | |
本地录制任务已经开始的事件回调 | |
本地录制任务正在进行中的进展事件回调 | |
本地录制分片的事件回调 | |
本地录制任务已经结束的事件回调 | |
本地截图完成的事件回调 | |
有主播加入当前房间(已废弃) | |
有主播离开当前房间(已废弃) | |
音效播放已结束(已废弃) | |
服务器测速的结果回调(已废弃) |
onRenderVideoFrame
onRenderVideoFrame
void onRenderVideoFrame | (String userId |
| int streamType |
|
自定义视频渲染回调
当您设置了本地或者远端的视频自定义渲染回调之后,SDK 就会将原本要交给渲染控件进行渲染的视频帧通过此回调接口抛送给您,以便于您进行自定义渲染。
参数 | 描述 |
frame | 待渲染的视频帧信息。 |
streamType | 频流类型:主路(Main)一般用于承载摄像头画面,辅路(Sub)一般用于承载屏幕分享画面。 |
userId | 视频源的 userId,如果是本地视频回调(setLocalVideoRenderDelegate),该参数可以忽略。 |
onGLContextCreated
onGLContextCreated
SDK 内部 OpenGL 环境已经创建的通知
onProcessVideoFrame
onProcessVideoFrame
int onProcessVideoFrame | |
|
用于对接第三方美颜组件的视频处理回调
如果您选购了第三方美颜组件,就需要在 TRTCCloud 中设置第三方美颜回调,之后 TRTC 就会将原本要进行预处理的视频帧通过此回调接口抛送给您。
之后您就可以将 TRTC 抛出的视频帧交给第三方美颜组件进行图像处理,由于抛出的数据是可读且可写的,因此第三方美颜的处理结果也可以同步给 TRTC 进行后续的编码和发送。
情况一:美颜组件自身会产生新的纹理。
如果您使用的美颜组件会在处理图像的过程中产生一帧全新的纹理(用于承载处理后的图像),那请您在回调函数中将 dstFrame.textureId 设置为新纹理的 ID:
private final TRTCVideoFrameListener mVideoFrameListener = new TRTCVideoFrameListener() {@Overridepublic void onGLContextCreated() {mFURenderer.onSurfaceCreated();mFURenderer.setUseTexAsync(true);}@Overridepublic int onProcessVideoFrame(TRTCVideoFrame srcFrame, TRTCVideoFrame dstFrame) {dstFrame.texture.textureId = mFURenderer.onDrawFrameSingleInput(srcFrame.texture.textureId, srcFrame.width, srcFrame.height);return 0;}@Overridepublic void onGLContextDestory() {mFURenderer.onSurfaceDestroyed();}};
情况二:美颜组件需要您提供目标纹理。
如果您使用的第三方美颜模块并不生成新的纹理,而是需要您设置给该模块一个输入纹理和一个输出纹理,则可以考虑如下方案:
int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCVideoFrame dstFrame) {thirdparty_process(srcFrame.texture.textureId, srcFrame.width, srcFrame.height, dstFrame.texture.textureId);return 0;}
参数 | 描述 |
dstFrame | 用于接收第三方美颜处理过的视频画面。 |
srcFrame | 用于承载 TRTC 采集到的摄像头画面。 |
注意
目前仅支持 OpenGL 纹理方案( PC 仅支持 TRTCVideoBufferType_Buffer 格式)。
onGLContextDestory
onGLContextDestory
SDK 内部 OpenGL 环境被销毁的通知
onCapturedAudioFrame
onCapturedAudioFrame
void onCapturedAudioFrame |
本地采集并经过音频模块前处理后的音频数据回调
当您设置完音频数据自定义回调之后,SDK 内部会把刚采集到并经过前处理(ANS、AEC、AGC)之后的数据,以 PCM 格式的形式通过本接口回调给您。
此接口回调出的音频时间帧长固定为0.02s,格式为 PCM 格式。
由时间帧长转化为字节帧长的公式为
采样率 × 时间帧长 × 声道数 × 采样点位宽
。 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为
48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节
。参数 | 描述 |
frame | PCM 格式的音频数据帧。 |
注意
1. 请不要在此回调函数中做任何耗时操作,由于 SDK 每隔 20ms 就要处理一帧音频数据,如果您的处理时间超过 20ms,就会导致声音异常。
2. 此接口回调出的音频数据是可读写的,也就是说您可以在回调函数中同步修改音频数据,但请保证处理耗时。
3. 此接口回调出的音频数据已经经过了前处理(ANS、AEC、AGC),但不包含背景音、音效、混响等前处理效果,延迟较低。
onLocalProcessedAudioFrame
onLocalProcessedAudioFrame
void onLocalProcessedAudioFrame |
本地采集并经过音频模块前处理、音效处理和混 BGM 后的音频数据回调
当您设置完音频数据自定义回调之后,SDK 内部会把刚采集到并经过前处理、音效处理和混 BGM 之后的数据,在最终进行网络编码之前,以 PCM 格式的形式通过本接口回调给您。
此接口回调出的音频时间帧长固定为0.02s,格式为 PCM 格式。
由时间帧长转化为字节帧长的公式为
采样率 × 时间帧长 × 声道数 × 采样点位宽
。 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为
48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节
。
特殊说明:
您可以通过设置接口中的
TRTCAudioFrame.extraData
字段,达到传输信令的目的。由于音频帧头部的数据块不能太大,建议您写入 extraData
时,尽量将信令控制在几个字节的大小,如果超过 100 个字节,写入的数据不会被发送。
房间内其他用户可以通过 TRTCAudioFrameListener 中的
onRemoteUserAudioFrame
中的 TRTCAudioFrame.extraData
字段回调接收数据。参数 | 描述 |
frame | PCM 格式的音频数据帧。 |
注意
1. 请不要在此回调函数中做任何耗时操作,由于 SDK 每隔 20ms 就要处理一帧音频数据,如果您的处理时间超过 20ms,就会导致声音异常。
2. 此接口回调出的音频数据是可读写的,也就是说您可以在回调函数中同步修改音频数据,但请保证处理耗时。
onRemoteUserAudioFrame
onRemoteUserAudioFrame
void onRemoteUserAudioFrame | |
| String userId) |
混音前的每一路远程用户的音频数据
当您设置完音频数据自定义回调之后,SDK 内部会把远端的每一路原始数据,在最终混音之前,以 PCM 格式的形式通过本接口回调给您。
此接口回调出的音频时间帧长固定为0.02s,格式为 PCM 格式。
由时间帧长转化为字节帧长的公式为
采样率 × 时间帧长 × 声道数 × 采样点位宽
。 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为
48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节
。参数 | 描述 |
frame | PCM 格式的音频数据帧。 |
userId | 用户标识。 |
注意
此接口回调出的音频数据是只读的,不支持修改。
onMixedPlayAudioFrame
onMixedPlayAudioFrame
void onMixedPlayAudioFrame |
将各路待播放音频混合之后并在最终提交系统播放之前的数据回调
当您设置完音频数据自定义回调之后,SDK 内部会把各路待播放的音频混合之后的音频数据,在提交系统播放之前,以 PCM 格式的形式通过本接口回调给您。
此接口回调出的音频时间帧长固定为0.02s,格式为 PCM 格式。
由时间帧长转化为字节帧长的公式为
采样率 × 时间帧长 × 声道数 × 采样点位宽
。 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为
48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节
。参数 | 描述 |
frame | PCM 格式的音频数据帧。 |
注意
1. 请不要在此回调函数中做任何耗时操作,由于 SDK 每隔 20ms 就要处理一帧音频数据,如果您的处理时间超过 20ms,就会导致声音异常。
2. 此接口回调出的音频数据是可读写的,也就是说您可以在回调函数中同步修改音频数据,但请保证处理耗时。
3. 此接口回调出的是对各路待播放音频数据的混合,但其中并不包含耳返的音频数据。
onMixedAllAudioFrame
onMixedAllAudioFrame
void onMixedAllAudioFrame |
SDK 所有音频混合后的音频数据(包括采集到的和待播放的)
当您设置完音频数据自定义回调之后,SDK 内部会把所有采集到的和待播放的音频数据混合起来,以 PCM 格式的形式通过本接口回调给您,便于您进行自定义录制。
此接口回调出的音频时间帧长固定为0.02s,格式为 PCM 格式。
由时间帧长转化为字节帧长的公式为
采样率 × 时间帧长 × 声道数 × 采样点位宽
。 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为
48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节
。参数 | 描述 |
frame | PCM 格式的音频数据帧。 |
注意
1. 此接口回调出的是SDK所有音频数据的混合数据,包括:经过 3A 前处理、特效叠加以及背景音乐混音后的本地音频,所有远端音频,但不包括耳返音频。
2. 此接口回调出的音频数据不支持修改。
onVoiceEarMonitorAudioFrame
onVoiceEarMonitorAudioFrame
void onVoiceEarMonitorAudioFrame |
耳返的音频数据
当您设置完音频数据自定义回调之后,SDK 内部会把耳返的音频数据在播放之前以 PCM 格式的形式通过本接口回调给您。
此接口回调出的音频时间帧长不固定,格式为 PCM 格式。
由时间帧长转化为字节帧长的公式为
采样率 × 时间帧长 × 声道数 × 采样点位宽
。 以 TRTC 默认的音频录制格式 48000 采样率、单声道、16采样点位宽为例,0.02s 的音频数据字节帧长为
48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节
。参数 | 描述 |
frame | PCM 格式的音频数据帧。 |
注意
1. 请不要在此回调函数中做任何耗时操作,否则会导致声音异常。
2. 此接口回调出的音频数据是可读写的,也就是说您可以在回调函数中同步修改音频数据,但请保证处理耗时。
onLog
onLog
void onLog | (String log |
| int level |
| String module) |
本地 LOG 的打印回调
如果您希望捕获 SDK 的本地日志打印行为,可以通过设置日志回调,让 SDK 将要打印的日志都通过本回调接口抛送给您。
参数 | 描述 |
level | 日志等级请参见 TRTC_LOG_LEVEL。 |
log | 日志内容。 |
module | 保留字段,暂无具体意义,目前为固定值 TXLiteAVSDK。 |
onError
onError
void onError | (int errCode |
| String errMsg |
| Bundle extraInfo) |
错误事件回调
错误事件,表示 SDK 抛出的不可恢复的错误,比如进入房间失败或设备开启失败等。
参数 | 描述 |
errCode | 错误码 |
errMsg | 错误信息 |
extInfo | 扩展信息字段,个别错误码可能会带额外的信息帮助定位问题 |
onWarning
onWarning
void onWarning | (int warningCode |
| String warningMsg |
| Bundle extraInfo) |
警告事件回调
警告事件,表示 SDK 抛出的提示性问题,比如视频出现卡顿或 CPU 使用率太高等。
参数 | 描述 |
extInfo | 扩展信息字段,个别警告码可能会带额外的信息帮助定位问题 |
warningCode | 警告码 |
warningMsg | 警告信息 |
onEnterRoom
onEnterRoom
void onEnterRoom | (long result) |
进入房间成功与否的事件回调
调用 TRTCCloud 中的 enterRoom() 接口执行进房操作后,会收到来自 TRTCCloudListener 的 onEnterRoom(result) 回调:
如果加入成功,回调 result 会是一个正数(result > 0),代表进入房间所消耗的时间,单位是毫秒(ms)。
如果加入失败,回调 result 会是一个负数(result < 0),代表失败原因的错误码。
参数 | 描述 |
result | result > 0 时为进房耗时(ms),result < 0 时为进房错误码。 |
注意
1. 在 Ver6.6 之前的版本,只有进房成功会抛出 onEnterRoom(result) 回调,进房失败由 onError() 回调抛出。
2. 在 Ver6.6 之后的版本:无论进房成功或失败,均会抛出 onEnterRoom(result) 回调,同时进房失败也会有 onError() 回调抛出。
onExitRoom
onExitRoom
void onExitRoom | (int reason) |
离开房间的事件回调
调用 TRTCCloud 中的 exitRoom 接口会执行退出房间的相关逻辑,例如释放音视频设备资源和编解码器资源等。
待 SDK 占用的所有资源释放完毕后,SDK 会抛出 onExitRoom() 回调通知到您。
如果您要再次调用 enterRoom 或者切换到其他的音视频 SDK,请等待 onExitRoom 回调到来后再执行相关操作。否则可能会遇到例如摄像头、麦克风设备被强占等各种异常问题。
参数 | 描述 |
reason | 离开房间原因,0:主动调用 exitRoom 退出房间;1:被服务器踢出当前房间;2:当前房间整个被解散。 |
onSwitchRole
onSwitchRole
void onSwitchRole | (final int errCode |
| final String errMsg) |
切换角色的事件回调
调用 TRTCCloud 中的 switchRole() 接口会切换主播和观众的角色,该操作会伴随一个线路切换的过程,待 SDK 切换完成后,会抛出 onSwitchRole() 事件回调。
参数 | 描述 |
errCode | |
errMsg | 错误信息。 |
onSwitchRoom
onSwitchRoom
void onSwitchRoom | (final int errCode |
| final String errMsg) |
切换房间的结果回调
调用 TRTCCloud 中的 switchRoom() 接口可以让用户快速地从一个房间切换到另一个房间,待 SDK 切换完成后,会抛出 onSwitchRoom() 事件回调。
参数 | 描述 |
errCode | |
errMsg | 错误信息。 |
onConnectOtherRoom
onConnectOtherRoom
void onConnectOtherRoom | (final String userId |
| final int errCode |
| final String errMsg) |
请求跨房通话的结果回调
调用 TRTCCloud 中的 connectOtherRoom() 接口会将两个不同房间中的主播拉通视频通话,也就是所谓的“主播PK”功能。
调用者会收到 onConnectOtherRoom() 回调来获知跨房通话是否成功,
如果成功,两个房间中的所有用户都会收到来自另一个房间中的 PK 主播的 onUserVideoAvailable() 回调。
参数 | 描述 |
errCode | |
errMsg | 错误信息。 |
userId | 要跨房通话的另一个房间中的主播的用户 ID。 |
onDisConnectOtherRoom
onDisConnectOtherRoom
void onDisConnectOtherRoom | (final int errCode |
| final String errMsg) |
结束跨房通话的结果回调
onUpdateOtherRoomForwardMode
onUpdateOtherRoomForwardMode
void onUpdateOtherRoomForwardMode | (final int errCode |
| final String errMsg) |
更改跨房主播上行能力的结果回调
onRemoteUserEnterRoom
onRemoteUserEnterRoom
void onRemoteUserEnterRoom | (String userId) |
有用户加入当前房间
出于性能方面的考虑,在 TRTC 两种不同的应用场景(即 AppScene,在 enterRoom 时通过第二个参数指定)下,该通知的行为会有差别:
直播类场景(TRTC_APP_SCENE_LIVE 和 TRTC_APP_SCENE_VOICE_CHATROOM):该场景下的用户区分主播和观众两种角色,只有主播进入房间时才会触发该通知,观众进入房间时不会触发该通知。
通话类场景(TRTC_APP_SCENE_VIDEOCALL 和 TRTC_APP_SCENE_AUDIOCALL):该场景下的用户没有角色的区分(可认为都是主播),任何用户进入房间都会触发该通知。
参数 | 描述 |
userId | 远端用户的用户标识。 |
注意
1. 事件回调 onRemoteUserEnterRoom 和 onRemoteUserLeaveRoom 只适用于维护当前房间里的“用户列表”,有此事件回调不代表一定有视频画面。
2. 如果需要显示远程画面,请监听代表某个用户是否有视频画面的 onUserVideoAvailable() 事件回调。
onRemoteUserLeaveRoom
onRemoteUserLeaveRoom
void onRemoteUserLeaveRoom | (String userId |
| int reason) |
有用户离开当前房间
与 onRemoteUserEnterRoom 相对应,在两种不同的应用场景(即 AppScene,在 enterRoom 时通过第二个参数指定)下,该通知的行为会有差别:
直播类场景(TRTC_APP_SCENE_LIVE 和 TRTC_APP_SCENE_VOICE_CHATROOM):只有主播离开房间时才会触发该通知,观众离开房间不会触发该通知。
通话类场景(TRTC_APP_SCENE_VIDEOCALL 和 TRTC_APP_SCENE_AUDIOCALL):该场景下用户没有角色的区别,任何用户的离开都会触发该通知。
参数 | 描述 |
reason | 离开原因,0表示用户主动退出房间,1表示用户超时退出,2表示被踢出房间,3表示主播因切换到观众退出房间。 |
userId | 远端用户的用户标识。 |
onUserVideoAvailable
onUserVideoAvailable
void onUserVideoAvailable | (String userId |
| boolean available) |
某远端用户发布/取消了主路视频画面
主路画面 一般被用于承载摄像头画面。当您收到 onUserVideoAvailable(userId, true) 通知时,表示该路画面已经有可播放的视频帧到达。
当您收到 onUserVideoAvailable(userId, false) 通知时,表示该路远程画面已经被关闭,关闭的原因可能是该用户调用了 muteLocalVideo 或 stopLocalPreview。
参数 | 描述 |
available | 该用户是否发布(或取消发布)了主路视频画面,true:发布;false:取消发布。 |
userId | 远端用户的用户标识。 |
onUserSubStreamAvailable
onUserSubStreamAvailable
void onUserSubStreamAvailable | (String userId |
| boolean available) |
某远端用户发布/取消了辅路视频画面
“辅路画面”一般被用于承载屏幕分享的画面。当您收到 onUserSubStreamAvailable(userId, true) 通知时,表示该路画面已经有可播放的视频帧到达。
参数 | 描述 |
available | 该用户是否发布(或取消发布)了辅路视频画面,true: 发布;false:取消发布。 |
userId | 远端用户的用户标识。 |
注意
onUserAudioAvailable
onUserAudioAvailable
void onUserAudioAvailable | (String userId |
| boolean available) |
某远端用户发布/取消了自己的音频
当您收到 onUserAudioAvailable(userId, true) 通知时,表示该用户发布了自己的声音,此时 SDK 的表现为:
在自动订阅模式下,您无需做任何操作,SDK 会自动播放该用户的声音。
在手动订阅模式下,您可以通过 muteRemoteAudio(userid, false) 来播放该用户的声音。
参数 | 描述 |
available | 该用户是否发布(或取消发布)了自己的音频,true: 发布;false:取消发布。 |
userId | 远端用户的用户标识。 |
注意
onFirstVideoFrame
onFirstVideoFrame
void onFirstVideoFrame | (String userId |
| int streamType |
| int width |
| int height) |
SDK 开始渲染自己本地或远端用户的首帧画面
SDK 会在渲染自己本地或远端用户的首帧画面时抛出该事件,您可以通过回调事件中的 userId 参数来判断事件来自于“本地”还是来自于“远端”。
如果 userId 为空值,代表 SDK 已经开始渲染自己本地的视频画面,不过前提是您已经调用了 startLocalPreview 或 startScreenCapture。
如果 userId 不为空,代表 SDK 已经开始渲染远端用户的视频画面,不过前提是您已经调用了 startRemoteView 订阅了该用户的视频画面。
参数 | 描述 |
height | 画面的高度。 |
streamType | 视频流类型:主路(Main)一般用于承载摄像头画面,辅路(Sub)一般用于承载屏幕分享画面。 |
userId | 本地或远端的用户标识,如果 userId 为空值代表自己本地的首帧画面已到来,userId 不为空则代表远端用户的首帧画面已到来。 |
width | 画面的宽度。 |
注意
onFirstAudioFrame
onFirstAudioFrame
void onFirstAudioFrame | (String userId) |
SDK 开始播放远端用户的首帧音频
SDK 会在播放远端用户的首帧音频时抛出该事件,本地音频的首帧事件暂不抛出。
参数 | 描述 |
userId | 远端用户的用户标识。 |
onSendFirstLocalVideoFrame
onSendFirstLocalVideoFrame
void onSendFirstLocalVideoFrame | (int streamType) |
自己本地的首个视频帧已被发布出去
当您成功进入房间并通过 startLocalPreview 或 startScreenCapture 开启本地视频采集之后(开启采集和进入房间的先后顺序无影响),SDK 就会开始进行视频编码,并通过自身的网络模块向云端发布自己本地的视频数据。当 SDK 成功地向云端送出自己的第一帧视频数据帧以后,就会抛出 onSendFirstLocalVideoFrame 事件回调。
参数 | 描述 |
streamType | 视频流类型:主路(Main)一般用于承载摄像头画面,辅路(Sub)一般用于承载屏幕分享画面。 |
onSendFirstLocalAudioFrame
onSendFirstLocalAudioFrame
自己本地的首个音频帧已被发布出去
当您成功进入房间并通过 startLocalAudio 开启本地音频采集之后(开启采集和进入房间的先后顺序无影响),SDK 就会开始进行音频编码,并通过自身的网络模块向云端发布自己本地的音频数据。当 SDK 成功地向云端送出自己的第一帧音频数据帧以后,就会抛出 onSendFirstLocalAudioFrame 事件回调。
onRemoteVideoStatusUpdated
onRemoteVideoStatusUpdated
void onRemoteVideoStatusUpdated | (String userId |
| int streamType |
| int status |
| int reason |
| Bundle extraInfo) |
远端视频状态变化的事件回调
您可以通过此事件回调获取远端每一路画面的播放状态(包括 Playing、Loading 和 Stopped 三种状态),从而进行相应的 UI 展示。
参数 | 描述 |
extrainfo | 额外信息。 |
reason | 视频状态改变的原因。 |
status | 视频状态:包括 Playing、Loading 和 Stopped 三种状态。 |
streamType | 视频流类型:主路(Main)一般用于承载摄像头画面,辅路(Sub)一般用于承载屏幕分享画面。 |
userId | 用户标识。 |
onRemoteAudioStatusUpdated
onRemoteAudioStatusUpdated
void onRemoteAudioStatusUpdated | (String userId |
| int status |
| int reason |
| Bundle extraInfo) |
远端音频状态变化的事件回调
您可以通过此事件回调获取远端每一路音频的播放状态(包括 Playing、Loading 和 Stopped 三种状态),从而进行相应的 UI 展示。
参数 | 描述 |
extrainfo | 额外信息。 |
reason | 音频状态改变的原因。 |
status | 音频状态:包括 Playing、Loading 和 Stopped 三种状态。 |
userId | 用户标识。 |
onUserVideoSizeChanged
onUserVideoSizeChanged
void onUserVideoSizeChanged | (String userId |
| int streamType |
| int newWidth |
| int newHeight) |
用户视频大小发生改变回调
当您收到 onUserVideoSizeChanged(userId, streamtype, newWidth, newHeight) 通知时,表示该路画面大小发生了调整,调整的原因可能是该用户调用了 setVideoEncoderParam 或者 setSubStreamEncoderParam 重新设置了画面尺寸。
参数 | 描述 |
newHeight | 视频流的高度(像素)。 |
newWidth | 视频流的宽度(像素)。 |
streamType | 视频流类型:主路(Main)一般用于承载摄像头画面,辅路(Sub)一般用于承载屏幕分享画面。 |
userId | 用户标识。 |
onNetworkQuality
onNetworkQuality
void onNetworkQuality | |
|
网络质量的实时统计回调
该统计回调每间隔2秒抛出一次,用于通知 SDK 感知到的当前网络的上行和下行质量。
SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽大小以及稳定情况进行评估,并计算出一个评估结果:如果评估结果为 1(Excellent) 代表当前的网络情况非常好,如果评估结果为 6(Down)代表当前网络无法支撑 TRTC 的正常通话。
参数 | 描述 |
localQuality | 上行网络质量。 |
remoteQuality | 下行网络质量,代表数据流历经“远端->云端->本端”这样一条完整的传输链路后,最终在本端统计到的数据质量。因此,这里的下行网络质量代表的是远端上行链路与本端下行链路共同影响的结果。 |
注意
暂时无法通过该接口单独判定远端用户的上行质量。
onStatistics
onStatistics
void onStatistics |
音视频技术指标的实时统计回调
视频统计信息:视频的分辨率(resolution)、帧率(FPS)和比特率(bitrate)等信息。
音频统计信息:音频的采样率(samplerate)、声道(channel)和比特率(bitrate)等信息。
网络统计信息:SDK 和云端一次往返(SDK > Cloud > SDK)的网络耗时(rtt)、丢包率(loss)、上行流量(sentBytes)和下行流量(receivedBytes)等信息。
参数 | 描述 |
statistics |
注意
onSpeedTestResult
onSpeedTestResult
void onSpeedTestResult |
网速测试的结果回调
该统计回调由 startSpeedTest: 触发。
参数 | 描述 |
result |
onConnectionLost
onConnectionLost
SDK 与云端的连接已经断开
SDK 会在跟云端的连接断开时抛出此事件回调,导致断开的原因大多是网络不可用或者网络切换所致,比如用户在通话中走进电梯时就可能会遇到此事件。
所以,SDK 会在如下三个连接相关的事件中按如下规律切换:
onTryToReconnect
onTryToReconnect
SDK 正在尝试重新连接到云端
onConnectionRecovery
onConnectionRecovery
SDK 与云端的连接已经恢复
onCameraDidReady
onCameraDidReady
摄像头准备就绪
当您调用 startLocalPreivew 之后,SDK 会尝试启动摄像头,如果摄像头能够启动成功就会抛出本事件。
如果启动失败,大概率是因为当前应用没有获得访问摄像头的权限,或者摄像头当前正在被其他程序独占使用中。
onMicDidReady
onMicDidReady
麦克风准备就绪
如果启动失败,大概率是因为当前应用没有获得访问麦克风的权限,或者麦克风当前正在被其他程序独占使用中。
onAudioRouteChanged
onAudioRouteChanged
void onAudioRouteChanged | (int newRoute |
| int oldRoute) |
当前音频路由发生变化(仅适用于移动设备)
所谓“音频路由”,是指声音是从手机的扬声器还是从听筒中播放出来,音频路由变化也就是声音的播放位置发生了变化。
当音频路由为听筒时,声音比较小,只有将耳朵凑近才能听清楚,隐私性较好,适合用于接听电话。
当音频路由为扬声器时,声音比较大,不用将手机贴脸也能听清,因此可以实现“免提”的功能。
当音频路由为有线耳机。
当音频路由为蓝牙耳机。
当音频路由为USB专业声卡设备。
参数 | 描述 |
fromRoute | 变更前的音频路由。 |
route | 音频路由,即声音由哪里输出(扬声器、听筒)。 |
onUserVoiceVolume
onUserVoiceVolume
void onUserVoiceVolume | |
| int totalVolume) |
音量大小的反馈回调
SDK 可以评估每一路音频的音量大小,并每隔一段时间抛出该事件回调,您可以根据音量大小在 UI 上做出相应的提示,比如
波形图
或 音量槽
。需要补充说明的是,无论当前房间中是否有人说话,SDK 都会按照您设定的时间间隔定时抛出此事件回调。
参数 | 描述 |
totalVolume | 所有远端用户的总音量大小,取值范围 0 - 100。 |
userVolumes | 是一个数组,用于承载所有正在说话的用户的音量大小,取值范围 0 - 100。 |
注意
userVolumes 为一个数组,对于数组中的每一个元素,当 userId 为空时表示本地麦克风采集的音量大小,当 userId 不为空时代表远端用户的音量大小。
onRecvCustomCmdMsg
onRecvCustomCmdMsg
void onRecvCustomCmdMsg | (String userId |
| int cmdID |
| int seq |
| byte[] message) |
收到自定义消息的事件回调
参数 | 描述 |
cmdID | 命令 ID。 |
message | 消息数据。 |
seq | 消息序号。 |
userId | 用户标识。 |
onMissCustomCmdMsg
onMissCustomCmdMsg
void onMissCustomCmdMsg | (String userId |
| int cmdID |
| int errCode |
| int missed) |
自定义消息丢失的事件回调
在发送端设置了可靠运输(reliable)后,SDK 都会通过此回调通知过去时间段内(通常为5s)传输途中丢失的自定义消息数量统计信息。
参数 | 描述 |
cmdID | 命令 ID。 |
errCode | 错误码。 |
missed | 丢失的消息数量。 |
userId | 用户标识。 |
注意
只有在发送端设置了可靠传输(reliable),接收方才能收到消息的丢失回调。
onRecvSEIMsg
onRecvSEIMsg
void onRecvSEIMsg | (String userId |
| byte[] data) |
收到 SEI 消息的回调
参数 | 描述 |
message | 数据。 |
userId | 用户标识。 |
onStartPublishing
onStartPublishing
void onStartPublishing | (int err |
| String errMsg) |
开始向腾讯云直播 CDN 上发布音视频流的事件回调
当您调用 startPublishing 开始向腾讯云直播 CDN 上发布音视频流时,SDK 会立刻将这一指令同步给云端服务器。
随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。
参数 | 描述 |
err | 0表示成功,其余值表示失败。 |
errMsg | 具体错误原因。 |
onStopPublishing
onStopPublishing
void onStopPublishing | (int err |
| String errMsg) |
停止向腾讯云直播 CDN 上发布音视频流的事件回调
当您调用 stopPublishing 停止向腾讯云直播 CDN 上发布音视频流时,SDK 会立刻将这一指令同步给云端服务器。
随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。
参数 | 描述 |
err | 0表示成功,其余值表示失败。 |
errMsg | 具体错误原因。 |
onStartPublishCDNStream
onStartPublishCDNStream
void onStartPublishCDNStream | (int err |
| String errMsg) |
开始向非腾讯云 CDN 上发布音视频流的事件回调
当您调用 startPublishCDNStream 开始向非腾讯云直播 CDN 上发布音视频流时,SDK 会立刻将这一指令同步给云端服务器。随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。
参数 | 描述 |
err | 0表示成功,其余值表示失败。 |
errMsg | 具体错误原因。 |
注意
当您收到成功的事件回调时,只是说明您的发布指令已经同步到腾讯云后台服务器,但如果目标 CDN 厂商的服务器不接收该条视频流,依然可能导致发布失败。
onStopPublishCDNStream
onStopPublishCDNStream
void onStopPublishCDNStream | (int err |
| String errMsg) |
停止向非腾讯云 CDN 上发布音视频流的事件回调
当您调用 stopPublishCDNStream 开始向非腾讯云直播 CDN 上发布音视频流时,SDK 会立刻将这一指令同步给云端服务器。随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。
参数 | 描述 |
err | 0表示成功,其余值表示失败。 |
errMsg | 具体错误原因。 |
onSetMixTranscodingConfig
onSetMixTranscodingConfig
void onSetMixTranscodingConfig | (int err |
| String errMsg) |
设置云端混流的排版布局和转码参数的事件回调
当您调用 setMixTranscodingConfig 调整云端混流的排版布局和转码参数时,SDK 会立刻将这一调整指令同步给云端服务器。随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。
参数 | 描述 |
err | 错误码:0表示成功,其余值表示失败。 |
errMsg | 具体的错误原因。 |
onStartPublishMediaStream
onStartPublishMediaStream
void onStartPublishMediaStream | (String taskId |
| int code |
| String message |
| Bundle extraInfo) |
开始发布媒体流的事件回调
当您调用 startPublishMediaStream 开始向 TRTC 后台服务发布媒体流时,SDK 会立刻将这一指令同步给云端服务器,随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。
参数 | 描述 |
code | 回调结果,0 表示成功,其余值表示失败。 |
extraInfo | 扩展信息字段,个别错误码可能会带额外的信息帮助定位问题。 |
message | 具体回调信息。 |
taskId | 当请求成功时,TRTC 后台会在回调中提供给您这项任务的 taskId,后续您可以通过该 taskId 结合 updatePublishMediaStream 和 stopPublishMediaStream 进行更新和停止。 |
onUpdatePublishMediaStream
onUpdatePublishMediaStream
void onUpdatePublishMediaStream | (String taskId |
| int code |
| String message |
| Bundle extraInfo) |
更新媒体流的事件回调
当您调用媒体流发布接口 (updatePublishMediaStream) 开始向 TRTC 后台服务更新媒体流时,SDK 会立刻将这一指令同步给云端服务器,随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。
参数 | 描述 |
code | 回调结果,0 表示成功,其余值表示失败。 |
extraInfo | 扩展信息字段,个别错误码可能会带额外的信息帮助定位问题。 |
message | 具体回调信息。 |
taskId |
onStopPublishMediaStream
onStopPublishMediaStream
void onStopPublishMediaStream | (String taskId |
| int code |
| String message |
| Bundle extraInfo) |
停止媒体流的事件回调
当您调用停止发布媒体流 (stopPublishMediaStream) 开始向 TRTC 后台服务停止媒体流时,SDK 会立刻将这一指令同步给云端服务器,随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。
参数 | 描述 |
code | 回调结果,0 表示成功,其余值表示失败。 |
extraInfo | 扩展信息字段,个别错误码可能会带额外的信息帮助定位问题。 |
message | 具体回调信息。 |
taskId |
onCdnStreamStateChanged
onCdnStreamStateChanged
void onCdnStreamStateChanged | (String cdnUrl |
| int status |
| int code |
| String msg |
| Bundle extraInfo) |
RTMP/RTMPS 推流状态发生改变回调
参数 | 描述 |
cdnUrl | |
code | 推流结果,0 表示成功,其余值表示出错。 |
extraInfo | 扩展信息字段,个别错误码可能会带额外的信息帮助定位问题。 |
message | 具体推流信息。 |
status | 推流状态。 0:推流未开始或者已结束。在您调用 stopPublishMediaStream 时会返回该状态。 1:正在连接 TRTC 服务器和 CDN 服务器。若无法立刻成功,TRTC 后台服务会多次重试尝试推流,并返回该状态(5s回调一次)。如成功进行推流,则进入状态 2;如服务器出错或 60 秒内未成功推流,则进入状态 4。 2:CDN 推流正在进行。在成功推流后,会返回该状态。 3:TRTC 服务器和 CDN 服务器推流中断,正在恢复。当 CDN 出现异常,或推流短暂中断时,TRTC 后台服务会自动尝试恢复推流,并返回该状态(5s回调一次)。如成功恢复推流,则进入状态 2;如服务器出错或 60 秒内未成功恢复,则进入状态 4。 4:TRTC 服务器和 CDN 服务器推流中断,且恢复或连接超时。即此时推流失败,你可以再次调用 updatePublishMediaStream 尝试推流。 5:正在断开 TRTC 服务器和 CDN 服务器。在您调用 stopPublishMediaStream 时,TRTC 后台服务会依次同步状态 5 和状态 0。 |
onScreenCaptureStarted
onScreenCaptureStarted
屏幕分享开启的事件回调
onScreenCapturePaused
onScreenCapturePaused
屏幕分享暂停的事件回调
onScreenCaptureResumed
onScreenCaptureResumed
屏幕分享恢复的事件回调
onScreenCaptureStopped
onScreenCaptureStopped
void onScreenCaptureStopped | (int reason) |
屏幕分享停止的事件回调
参数 | 描述 |
reason | 停止原因,0:用户主动停止;1:屏幕窗口关闭导致停止;2:表示屏幕分享的显示屏状态变更(如接口被拔出、投影模式变更等)。 |
onLocalRecordBegin
onLocalRecordBegin
void onLocalRecordBegin | (int errCode |
| String storagePath) |
本地录制任务已经开始的事件回调
参数 | 描述 |
errCode | 状态码。 0:录制任务启动成功。 -1:内部错误导致录制任务启动失败。 -2:文件后缀名有误(比如不支持的录制格式)。 -6:录制已经启动,需要先停止录制。 -7:录制文件已存在,需要先删除文件。 -8:录制目录无写入权限,请检查目录权限问题。 |
storagePath | 录制文件存储路径。 |
onLocalRecording
onLocalRecording
void onLocalRecording | (long duration |
| String storagePath) |
本地录制任务正在进行中的进展事件回调
您可通过捕获该事件回调来获知录制任务的健康状况。
参数 | 描述 |
duration | 已经录制的累计时长,单位毫秒。 |
storagePath | 录制文件存储路径。 |
onLocalRecordFragment
onLocalRecordFragment
void onLocalRecordFragment | (String storagePath) |
本地录制分片的事件回调
当您开启分片录制时,每完成一个分片,都会通过此接口回调。
参数 | 描述 |
storagePath | 分片文件存储路径。 |
onLocalRecordComplete
onLocalRecordComplete
void onLocalRecordComplete | (int errCode |
| String storagePath) |
本地录制任务已经结束的事件回调
参数 | 描述 |
errCode | 状态码。 0:结束录制任务成功。 -1:录制失败。 -2:切换分辨率或横竖屏导致录制结束。 -3:录制时间太短,或未采集到任何视频或音频数据,请检查录制时长,或是否已开启音、视频采集。 |
storagePath | 录制文件存储路径。 |
onSnapshotComplete
onSnapshotComplete
void onSnapshotComplete | (Bitmap bmp) |
本地截图完成的事件回调
参数 | 描述 |
bmp | 截图结果,如果 bmp 为 null 代表本次截图操作失败。 |
data | 截图数据,为 nullptr 表示截图失败。 |
format | 截图数据格式,目前只支持 TRTCVideoPixelFormat_BGRA32。 |
height | 截图画面的高度。 |
length | 截图数据长度,对于BGRA32而言,length = width * height * 4。 |
type | 视频流类型。 |
userId | 用户标识,如果 userId 为空字符串,则代表截取的是本地画面。 |
width | 截图画面的宽度。 |
注意
全平台 C++ 接口和 Java 接口在参数上是不一样的,C++ 接口用 7 个参数描述一个截图画面,Java 接口只用一个 Bitmap 描述一个截图画面。
onUserEnter
onUserEnter
void onUserEnter | (String userId) |
有主播加入当前房间(已废弃)
onUserExit
onUserExit
void onUserExit | (String userId |
| int reason) |
有主播离开当前房间(已废弃)
onAudioEffectFinished
onAudioEffectFinished
void onAudioEffectFinished | (int effectId |
| int code) |
音效播放已结束(已废弃)
@deprecated 新版本开始不推荐使用,建议使用 ITXAudioEffectManager 接口替代之。
onSpeedTest
onSpeedTest
void onSpeedTest | |
| int finishedCount |
| int totalCount) |