LiteAVSDK
腾讯云音视频 SDK ,服务于数万家企业客户的高可用组件,致力于最大限度地节省您的研发成本。
TRTCCloudListener

详细描述

腾讯云实时音视频的事件回调接口

Module: TRTCCloudDelegate @ TXLiteAVSDK Function: 腾讯云实时音视频的事件回调接口


结构体说明

◆ com::tencent::trtc::TRTCCloudListener::TRTCVideoRenderListener

interface com::tencent::trtc::TRTCCloudListener::TRTCVideoRenderListener

Public 成员函数

void onRenderVideoFrame (String userId, int streamType, TRTCCloudDef.TRTCVideoFrame frame)
 

成员函数说明

◆ onRenderVideoFrame()

void onRenderVideoFrame ( String  userId,
int  streamType,
TRTCCloudDef.TRTCVideoFrame  frame 
)

自定义视频渲染回调

当您设置了本地或者远端的视频自定义渲染回调之后,SDK 就会将原本要交给渲染控件进行渲染的视频帧通过此回调接口抛送给您,以便于您进行自定义渲染。

参数
frame待渲染的视频帧信息
userId视频源的 userId,如果是本地视频回调(setLocalVideoRenderDelegate),该参数可以忽略
streamType频流类型:主路(Main)一般用于承载摄像头画面,辅路(Sub)一般用于承载屏幕分享画面。

◆ com::tencent::trtc::TRTCCloudListener::TRTCVideoFrameListener

interface com::tencent::trtc::TRTCCloudListener::TRTCVideoFrameListener

Public 成员函数

void onGLContextCreated ()
 
int onProcessVideoFrame (TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCVideoFrame dstFrame)
 
void onGLContextDestory ()
 

成员函数说明

◆ onGLContextCreated()

void onGLContextCreated ( )

SDK 内部 OpenGL 环境已经创建的通知

◆ onProcessVideoFrame()

int onProcessVideoFrame ( TRTCCloudDef.TRTCVideoFrame  srcFrame,
TRTCCloudDef.TRTCVideoFrame  dstFrame 
)

用于对接第三方美颜组件的视频处理回调

如果您选购了第三方美颜组件,就需要在 TRTCCloud 中设置第三方美颜回调,之后 TRTC 就会将原本要进行预处理的视频帧通过此回调接口抛送给您。 之后您就可以将 TRTC 抛出的视频帧交给第三方美颜组件进行图像处理,由于抛出的数据是可读且可写的,因此第三方美颜的处理结果也可以同步给 TRTC 进行后续的编码和发送。

参数
srcFrame用于承载 TRTC 采集到的摄像头画面
dstFrame用于接收第三方美颜处理过的视频画面
注意
目前仅支持 OpenGL 纹理方案( PC 仅支持 TRTCVideoBufferType_Buffer 格式)。

情况一:美颜组件自身会产生新的纹理 如果您使用的美颜组件会在处理图像的过程中产生一帧全新的纹理(用于承载处理后的图像),那请您在回调函数中将 dstFrame.textureId 设置为新纹理的 ID:

private final TRTCVideoFrameListener mVideoFrameListener = new TRTCVideoFrameListener() {
    @Override
    public void onGLContextCreated() {
        mFURenderer.onSurfaceCreated();
        mFURenderer.setUseTexAsync(true);
    }
    @Override
    public int onProcessVideoFrame(TRTCVideoFrame srcFrame, TRTCVideoFrame dstFrame) {
        dstFrame.texture.textureId = mFURenderer.onDrawFrameSingleInput(srcFrame.texture.textureId, srcFrame.width, srcFrame.height);
        return 0;
    }
    @Override
    public void onGLContextDestory() {
        mFURenderer.onSurfaceDestroyed();
    }
};

情况二:美颜组件需要您提供目标纹理 如果您使用的第三方美颜模块并不生成新的纹理,而是需要您设置给该模块一个输入纹理和一个输出纹理,则可以考虑如下方案:

uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVideoFrame * _Nonnull)dstFrame{
thirdparty_process(srcFrame.textureId, srcFrame.width, srcFrame.height, dstFrame.textureId);
return 0;
}
int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCVideoFrame dstFrame) {
thirdparty_process(srcFrame.texture.textureId, srcFrame.width, srcFrame.height, dstFrame.texture.textureId);
return 0;
}

◆ onGLContextDestory()

void onGLContextDestory ( )

SDK 内部 OpenGL 环境被销的通知

◆ com::tencent::trtc::TRTCCloudListener::TRTCAudioFrameListener

interface com::tencent::trtc::TRTCCloudListener::TRTCAudioFrameListener

Public 成员函数

void onCapturedRawAudioFrame (TRTCCloudDef.TRTCAudioFrame frame)
 
void onLocalProcessedAudioFrame (TRTCCloudDef.TRTCAudioFrame frame)
 
void onRemoteUserAudioFrame (TRTCCloudDef.TRTCAudioFrame frame, String userId)
 
void onMixedPlayAudioFrame (TRTCCloudDef.TRTCAudioFrame frame)
 
void onMixedAllAudioFrame (TRTCCloudDef.TRTCAudioFrame frame)
 

成员函数说明

◆ onCapturedRawAudioFrame()

void onCapturedRawAudioFrame ( TRTCCloudDef.TRTCAudioFrame  frame)

本地麦克风采集到的原始音频数据回调

当您设置完音频数据自定义回调之后,SDK 内部会把刚从麦克风采集到的原始音频数据,以 PCM 格式的形式通过本接口回调给您。

  • 此接口回调出的音频时间帧长固定为0.02s,格式为 PCM 格式。
  • 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
  • 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
参数
framePCM 格式的音频数据帧
注意
  1. 请不要在此回调函数中做任何耗时操作,由于 SDK 每隔 20ms 就要处理一帧音频数据,如果您的处理时间超过 20ms,就会导致声音异常。
  2. 此接口回调出的音频数据是可读写的,也就是说您可以在回调函数中同步修改音频数据,但请保证处理耗时。
  3. 此接口回调出的音频数据**不包含**背景音、音效、混响等前处理效果,延迟极低。

◆ onLocalProcessedAudioFrame()

void onLocalProcessedAudioFrame ( TRTCCloudDef.TRTCAudioFrame  frame)

本地采集并经过音频模块前处理后的音频数据回调

当您设置完音频数据自定义回调之后,SDK 内部会把刚采集到并经过前处理(ANS、AEC、AGC)之后的数据,以 PCM 格式的形式通过本接口回调给您。

  • 此接口回调出的音频时间帧长固定为0.02s,格式为 PCM 格式。
  • 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
  • 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。

特殊说明: 您可以通过设置接口中的 TRTCAudioFrame.extraData 字段,达到传输信令的目的。 由于音频帧头部的数据块不能太大,建议您写入 extraData 时,尽量将信令控制在几个字节的大小,如果超过 100 个字节,写入的数据不会被发送。 房间内其他用户可以通过 TRTCAudioFrameDelegate 中的 onRemoteUserAudioFrame 中的 TRTCAudioFrame.extraData 字段回调接收数据。

参数
framePCM 格式的音频数据帧
注意
  1. 请不要在此回调函数中做任何耗时操作,由于 SDK 每隔 20ms 就要处理一帧音频数据,如果您的处理时间超过 20ms,就会导致声音异常。
  2. 此接口回调出的音频数据是可读写的,也就是说您可以在回调函数中同步修改音频数据,但请保证处理耗时。
  3. 此接口回调出的数据已经经过了回声抑制(AEC)处理,但声音的延迟相比于 onCapturedRawAudioFrame 要高一些。

◆ onRemoteUserAudioFrame()

void onRemoteUserAudioFrame ( TRTCCloudDef.TRTCAudioFrame  frame,
String  userId 
)

混音前的每一路远程用户的音频数据

当您设置完音频数据自定义回调之后,SDK 内部会把远端的每一路原始数据,在最终混音之前,以 PCM 格式的形式通过本接口回调给您。

  • 此接口回调出的音频时间帧长固定为0.02s,格式为 PCM 格式。
  • 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
  • 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
参数
framePCM 格式的音频数据帧
userId用户标识
注意
此接口回调出的音频数据是只读的,不支持修改

◆ onMixedPlayAudioFrame()

void onMixedPlayAudioFrame ( TRTCCloudDef.TRTCAudioFrame  frame)

将各路待播放音频混合之后并在最终提交系统播放之前的数据回调

当您设置完音频数据自定义回调之后,SDK 内部会把各路待播放的音频混合之后的音频数据,在提交系统播放之前,以 PCM 格式的形式通过本接口回调给您。

  • 此接口回调出的音频时间帧长固定为0.02s,格式为 PCM 格式。
  • 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
  • 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
参数
framePCM 格式的音频数据帧
注意
  1. 请不要在此回调函数中做任何耗时操作,由于 SDK 每隔 20ms 就要处理一帧音频数据,如果您的处理时间超过 20ms,就会导致声音异常。
  2. 此接口回调出的音频数据是可读写的,也就是说您可以在回调函数中同步修改音频数据,但请保证处理耗时。
  3. 此接口回调出的是对各路待播放音频数据的混合,但其中并不包含耳返的音频数据。

◆ onMixedAllAudioFrame()

void onMixedAllAudioFrame ( TRTCCloudDef.TRTCAudioFrame  frame)

SDK 所有音频混合后的音频数据(包括采集到的和待播放的)

当您设置完音频数据自定义回调之后,SDK 内部会把所有采集到的和待播放的音频数据混合起来,以 PCM 格式的形式通过本接口回调给您,便于您进行自定义录制。

  • 此接口回调出的音频时间帧长固定为0.02s,格式为 PCM 格式。
  • 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
  • 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
参数
framePCM 格式的音频数据帧
注意
  1. 此接口回调出的是SDK所有音频数据的混合数据,包括:经过 3A 前处理、特效叠加以及背景音乐混音后的本地音频,所有远端音频,但不包括耳返音频。
  2. 此接口回调出的音频数据不支持修改。

◆ com::tencent::trtc::TRTCCloudListener::TRTCLogListener

class com::tencent::trtc::TRTCCloudListener::TRTCLogListener

Public 成员函数

abstract void onLog (String log, int level, String module)
 

成员函数说明

◆ onLog()

abstract void onLog ( String  log,
int  level,
String  module 
)
abstract

本地 LOG 的打印回调

如果您希望捕获 SDK 的本地日志打印行为,可以通过设置日志回调,让 SDK 将要打印的日志都通过本回调接口抛送给您。

参数
log日志内容
level日志等级 参见 TRTC_LOG_LEVEL
module保留字段,暂无具体意义,目前为固定值 TXLiteAVSDK

◆ com::tencent::trtc::TRTCCloudListener::TRTCSnapshotListener

interface com::tencent::trtc::TRTCCloudListener::TRTCSnapshotListener

Public 成员函数

void onSnapshotComplete (Bitmap bmp)
 

成员函数说明

◆ onSnapshotComplete()

void onSnapshotComplete ( Bitmap  bmp)

截图完成时回调

参数
bmp截图结果,如果 bmp 为 null 代表本次截图操作失败。

◆ com::tencent::trtc::TRTCCloudListener

class com::tencent::trtc::TRTCCloudListener

错误和警告事件

void onError (int errCode, String errMsg, Bundle extraInfo)
 
void onWarning (int warningCode, String warningMsg, Bundle extraInfo)
 

房间相关事件回调

void onEnterRoom (long result)
 
void onExitRoom (int reason)
 
void onSwitchRole (final int errCode, final String errMsg)
 
void onSwitchRoom (final int errCode, final String errMsg)
 
void onConnectOtherRoom (final String userId, final int errCode, final String errMsg)
 
void onDisConnectOtherRoom (final int errCode, final String errMsg)
 

用户相关事件回调

void onRemoteUserEnterRoom (String userId)
 
void onRemoteUserLeaveRoom (String userId, int reason)
 
void onUserVideoAvailable (String userId, boolean available)
 
void onUserSubStreamAvailable (String userId, boolean available)
 
void onUserAudioAvailable (String userId, boolean available)
 
void onFirstVideoFrame (String userId, int streamType, int width, int height)
 
void onFirstAudioFrame (String userId)
 
void onSendFirstLocalVideoFrame (int streamType)
 
void onSendFirstLocalAudioFrame ()
 
void onRemoteVideoStatusUpdated (String userId, int streamType, int status, int reason, Bundle extraInfo)
 

网络和技术指标统计回调

void onNetworkQuality (TRTCCloudDef.TRTCQuality localQuality, ArrayList< TRTCCloudDef.TRTCQuality > remoteQuality)
 
void onStatistics (TRTCStatistics statistics)
 

与云端连接情况的事件回调

void onConnectionLost ()
 
void onTryToReconnect ()
 
void onConnectionRecovery ()
 
void onSpeedTest (TRTCCloudDef.TRTCSpeedTestResult currentResult, int finishedCount, int totalCount)
 

硬件设备相关事件回调

void onCameraDidReady ()
 
void onMicDidReady ()
 
void onAudioRouteChanged (int newRoute, int oldRoute)
 
void onUserVoiceVolume (ArrayList< TRTCCloudDef.TRTCVolumeInfo > userVolumes, int totalVolume)
 

自定义消息的接收事件回调

void onRecvCustomCmdMsg (String userId, int cmdID, int seq, byte[] message)
 
void onMissCustomCmdMsg (String userId, int cmdID, int errCode, int missed)
 
void onRecvSEIMsg (String userId, byte[] data)
 

CDN 相关事件回调

void onStartPublishing (int err, String errMsg)
 
void onStopPublishing (int err, String errMsg)
 
void onStartPublishCDNStream (int err, String errMsg)
 
void onStopPublishCDNStream (int err, String errMsg)
 
void onSetMixTranscodingConfig (int err, String errMsg)
 

屏幕分享相关事件回调

void onScreenCaptureStarted ()
 
void onScreenCapturePaused ()
 
void onScreenCaptureResumed ()
 
void onScreenCaptureStopped (int reason)
 

本地录制和本地截图的事件回调

void onLocalRecordBegin (int errCode, String storagePath)
 
void onLocalRecording (long duration, String storagePath)
 
void onLocalRecordComplete (int errCode, String storagePath)
 

废弃的事件回调(建议使用对应的新回调)

void onUserEnter (String userId)
 
void onUserExit (String userId, int reason)
 
void onAudioEffectFinished (int effectId, int code)
 

成员函数说明

◆ onError()

void onError ( int  errCode,
String  errMsg,
Bundle  extraInfo 
)
inline

错误事件回调

错误事件,表示 SDK 抛出的不可恢复的错误,比如进入房间失败或设备开启失败等。 参考文档:错误码表

参数
errCode错误码
errMsg错误信息
extInfo扩展信息字段,个别错误码可能会带额外的信息帮助定位问题

◆ onWarning()

void onWarning ( int  warningCode,
String  warningMsg,
Bundle  extraInfo 
)
inline

警告事件回调

警告事件,表示 SDK 抛出的提示性问题,比如视频出现卡顿或 CPU 使用率太高等。 参考文档:错误码表

参数
warningCode警告码
warningMsg警告信息
extInfo扩展信息字段,个别警告码可能会带额外的信息帮助定位问题

◆ onEnterRoom()

void onEnterRoom ( long  result)
inline

进入房间成功与否的事件回调

调用 TRTCCloud 中的 enterRoom() 接口执行进房操作后,会收到来自 TRTCCloudDelegate 的 onEnterRoom(result) 回调:

  • 如果加入成功,回调 result 会是一个正数(result > 0),代表进入房间所消耗的时间,单位是毫秒(ms)。
  • 如果加入失败,回调 result 会是一个负数(result < 0),代表失败原因的错误码。 进房失败的错误码含义请参见错误码表
注意
  1. 在 Ver6.6 之前的版本,只有进房成功会抛出 onEnterRoom(result) 回调,进房失败由 onError() 回调抛出。
  2. 在 Ver6.6 之后的版本:无论进房成功或失败,均会抛出 onEnterRoom(result) 回调,同时进房失败也会有 onError() 回调抛出。
参数
resultresult > 0 时为进房耗时(ms),result < 0 时为进房错误码。

◆ onExitRoom()

void onExitRoom ( int  reason)
inline

离开房间的事件回调

调用 TRTCCloud 中的 exitRoom() 接口会执行退出房间的相关逻辑,例如释放音视频设备资源和编解码器资源等。 待 SDK 占用的所有资源释放完毕后,SDK 会抛出 onExitRoom() 回调通知到您。

如果您要再次调用 enterRoom() 或者切换到其他的音视频 SDK,请等待 onExitRoom() 回调到来后再执行相关操作。 否则可能会遇到例如摄像头、麦克风设备被强占等各种异常问题。

参数
reason离开房间原因,0:主动调用 exitRoom 退出房间;1:被服务器踢出当前房间;2:当前房间整个被解散。

◆ onSwitchRole()

void onSwitchRole ( final int  errCode,
final String  errMsg 
)
inline

切换角色的事件回调

调用 TRTCCloud 中的 switchRole() 接口会切换主播和观众的角色,该操作会伴随一个线路切换的过程, 待 SDK 切换完成后,会抛出 onSwitchRole() 事件回调。

参数
errCode错误码,ERR_NULL 代表切换成功,其他请参见错误码
errMsg错误信息。

◆ onSwitchRoom()

void onSwitchRoom ( final int  errCode,
final String  errMsg 
)
inline

切换房间的结果回调

调用 TRTCCloud 中的 switchRoom() 接口可以让用户快速地从一个房间切换到另一个房间, 待 SDK 切换完成后,会抛出 onSwitchRoom() 事件回调。

参数
errCode错误码,ERR_NULL 代表切换成功,其他请参见错误码
errMsg错误信息。

◆ onConnectOtherRoom()

void onConnectOtherRoom ( final String  userId,
final int  errCode,
final String  errMsg 
)
inline

请求跨房通话的结果回调

调用 TRTCCloud 中的 connectOtherRoom() 接口会将两个不同房间中的主播拉通视频通话,也就是所谓的“主播PK”功能。 调用者会收到 onConnectOtherRoom() 回调来获知跨房通话是否成功, 如果成功,两个房间中的所有用户都会收到来自另一个房间中的 PK 主播的 onUserVideoAvailable() 回调。

参数
userId要跨房通话的另一个房间中的主播的用户 ID。
errCode错误码,ERR_NULL 代表切换成功,其他请参见错误码
errMsg错误信息。

◆ onDisConnectOtherRoom()

void onDisConnectOtherRoom ( final int  errCode,
final String  errMsg 
)
inline

结束跨房通话的结果回调

◆ onRemoteUserEnterRoom()

void onRemoteUserEnterRoom ( String  userId)
inline

有用户加入当前房间

出于性能方面的考虑,在 TRTC 两种不同的应用场景(即 AppScene,在 enterRoom 时通过第二个参数指定)下,该通知的行为会有差别:

  • 直播类场景(TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom):该场景下的用户区分主播和观众两种角色,只有主播进入房间时才会触发该通知,观众进入房间时不会触发该通知。
  • 通话类场景(TRTCAppSceneVideoCall 和 TRTCAppSceneAudioCall):该场景下的用户没有角色的区分(可认为都是主播),任何用户进入房间都会触发该通知。
注意
  1. 事件回调 onRemoteUserEnterRoom 和 onRemoteUserLeaveRoom 只适用于维护当前房间里的“用户列表”,有此事件回调不代表一定有视频画面。
  2. 如果需要显示远程画面,请监听代表某个用户是否有视频画面的 onUserVideoAvailable() 事件回调。
参数
userId远端用户的用户标识

◆ onRemoteUserLeaveRoom()

void onRemoteUserLeaveRoom ( String  userId,
int  reason 
)
inline

有用户离开当前房间

与 onRemoteUserEnterRoom 相对应,在两种不同的应用场景(即 AppScene,在 enterRoom 时通过第二个参数指定)下,该通知的行为会有差别:

  • 直播类场景(TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom):只有主播离开房间时才会触发该通知,观众离开房间不会触发该通知。
  • 通话类场景(TRTCAppSceneVideoCall 和 TRTCAppSceneAudioCall):该场景下用户没有角色的区别,任何用户的离开都会触发该通知。
参数
userId远端用户的用户标识
reason离开原因,0表示用户主动退出房间,1表示用户超时退出,2表示被踢出房间。

◆ onUserVideoAvailable()

void onUserVideoAvailable ( String  userId,
boolean  available 
)
inline

某远端用户发布/取消了主路视频画面

“主路画面”一般被用于承载摄像头画面。当您收到 onUserVideoAvailable(userId, true) 通知时,表示该路画面已经有可播放的视频帧到达。 此时,您需要调用 startRemoteView 接口订阅该用户的远程画面,订阅成功后,您会继续收到该用户的首帧画面渲染回调 onFirstVideoFrame(userid)。

当您收到 onUserVideoAvailable(userId, false) 通知时,表示该路远程画面已经被关闭,关闭的原因可能是该用户调用了 muteLocalVideostopLocalPreview

参数
userId远端用户的用户标识
available该用户是否发布(或取消发布)了主路视频画面,true: 发布;false:取消发布。

◆ onUserSubStreamAvailable()

void onUserSubStreamAvailable ( String  userId,
boolean  available 
)
inline

某远端用户发布/取消了辅路视频画面

“辅路画面”一般被用于承载屏幕分享的画面。当您收到 onUserSubStreamAvailable(userId, true) 通知时,表示该路画面已经有可播放的视频帧到达。 此时,您需要调用 startRemoteSubStreamView 接口订阅该用户的远程画面,订阅成功后,您会继续收到该用户的首帧画面渲染回调 onFirstVideoFrame(userid)。

注意
显示辅路画面使用的函数是 startRemoteSubStreamView 而非 startRemoteView
参数
userId远端用户的用户标识
available该用户是否发布(或取消发布)了辅路视频画面,true: 发布;false:取消发布。

◆ onUserAudioAvailable()

void onUserAudioAvailable ( String  userId,
boolean  available 
)
inline

某远端用户发布/取消了自己的音频

当您收到 onUserAudioAvailable(userId, true) 通知时,表示该用户发布了自己的声音,此时 SDK 的表现为:

  • 在自动订阅模式下,您无需做任何操作,SDK 会自动播放该用户的声音。
  • 在手动订阅模式下,您可以通过 muteRemoteAudio(userid, false) 来播放该用户的声音。
注意
SDK 默认使用自动订阅模式,您可以通过 setDefaultStreamRecvMode 设置为手动订阅,但需要在您进入房间之前调用才生效。
参数
userId远端用户的用户标识
available该用户是否发布(或取消发布)了自己的音频,true: 发布;false:取消发布。

◆ onFirstVideoFrame()

void onFirstVideoFrame ( String  userId,
int  streamType,
int  width,
int  height 
)
inline

SDK 开始渲染自己本地或远端用户的首帧画面

SDK 会在渲染自己本地或远端用户的首帧画面时抛出该事件,您可以通过回调事件中的 userId 参数来判断事件来自于“本地”还是来自于“远端”。

  • 如果 userId 为空值,代表 SDK 已经开始渲染自己本地的视频画面,不过前提是您已经调用了 startLocalPreviewstartScreenCapture
  • 如果 userId 不为空,代表 SDK 已经开始渲染远端用户的视频画面,不过前提是您已经调用了 startRemoteView 订阅了该用户的视频画面。
注意
  1. 只有当您调用了 startLocalPreviewstartScreenCapture 之后,才会触发自己本地的首帧画面事件回调。
  2. 只有当您调用了 startRemoteViewstartRemoteSubStreamView 之后,才会触发远端用户的首帧画面事件回调。
参数
userId本地或远端的用户标识,如果 userId 为空值代表自己本地的首帧画面已到来,userId 不为空则代表远端用户的首帧画面已到来。
streamType视频流类型:主路(Main)一般用于承载摄像头画面,辅路(Sub)一般用于承载屏幕分享画面。
width画面的宽度。
height画面的高度。

◆ onFirstAudioFrame()

void onFirstAudioFrame ( String  userId)
inline

SDK 开始播放远端用户的首帧音频

SDK 会在播放远端用户的首帧音频时抛出该事件,本地音频的首帧事件暂不抛出。

参数
userId远端用户的用户标识

◆ onSendFirstLocalVideoFrame()

void onSendFirstLocalVideoFrame ( int  streamType)
inline

自己本地的首个视频帧已被发布出去

当您成功进入房间并通过 startLocalPreviewstartScreenCapture 开启本地视频采集之后(开启采集和进入房间的先后顺序无影响), SDK 就会开始进行视频编码,并通过自身的网络模块向云端发布自己本地的视频数据。 当 SDK 成功地向云端送出自己的第一帧视频数据帧以后,就会抛出 onSendFirstLocalVideoFrame 事件回调。

参数
streamType视频流类型:主路(Main)一般用于承载摄像头画面,辅路(Sub)一般用于承载屏幕分享画面。

◆ onSendFirstLocalAudioFrame()

void onSendFirstLocalAudioFrame ( )
inline

自己本地的首个音频帧已被发布出去

当您成功进入房间并通过 startLocalAudio 开启本地音频采集之后(开启采集和进入房间的先后顺序无影响), SDK 就会开始进行音频编码,并通过自身的网络模块向云端发布自己本地的音频数据。 当 SDK 成功地向云端送出自己的第一帧音频数据帧以后,就会抛出 onSendFirstLocalAudioFrame 事件回调。

◆ onRemoteVideoStatusUpdated()

void onRemoteVideoStatusUpdated ( String  userId,
int  streamType,
int  status,
int  reason,
Bundle  extraInfo 
)
inline

远端视频状态变化的事件回调

您可以通过此事件回调获取远端每一路画面的播放状态(包括 Playing、Loading 和 Stopped 三种状态),从而进行相应的 UI 展示。

参数
userId用户标识
streamType视频流类型:主路(Main)一般用于承载摄像头画面,辅路(Sub)一般用于承载屏幕分享画面。
status视频状态:包括 Playing、Loading 和 Stopped 三种状态。
reason视频状态改变的原因
extrainfo额外信息

◆ onNetworkQuality()

void onNetworkQuality ( TRTCCloudDef.TRTCQuality  localQuality,
ArrayList< TRTCCloudDef.TRTCQuality remoteQuality 
)
inline

网络质量的实时统计回调

该统计回调每间隔2秒抛出一次,用于通知 SDK 感知到的当前网络的上行和下行质量。 SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽大小以及稳定情况进行评估,并计算出一个的评估结果: 如果评估结果为 1(Excellent) 代表当前的网络情况非常好,如果评估结果为 6(Down)代表当前网络无法支撑 TRTC 的正常通话。

注意
回调参数 localQuality 和 remoteQuality 中的 userId 如果为空置,代表本组数据统计的是自己本地的网络质量,否则是代表远端用户的网络质量。
参数
localQuality上行网络质量
remoteQuality下行网络质量

◆ onStatistics()

void onStatistics ( TRTCStatistics  statistics)
inline

音视频技术指标的实时统计回调

该统计回调每间隔2秒抛出一次,用于通知 SDK 内部音频、视频以及网络相关的专业技术指标,这些信息在 TRTCStatistics 均有罗列:

  • 视频统计信息:视频的分辨率(resolution)、帧率(FPS)和比特率(bitrate)等信息。
  • 音频统计信息:音频的采样率(samplerate)、声道(channel)和比特率(bitrate)等信息。
  • 网络统计信息:SDK 和云端一次往返(SDK => Cloud => SDK)的网络耗时(rtt)、丢包率(loss)、上行流量(sentBytes)和下行流量(receivedBytes)等信息。
注意
如果您只需要获知当前网络质量的好坏,并不需要花太多时间研究本统计回调,更推荐您使用 onNetworkQuality 来解决问题。
参数
statistics统计数据,包括自己本地的统计信息和远端用户的统计信息,详情请参考 TRTCStatistics

◆ onConnectionLost()

void onConnectionLost ( )
inline

SDK 与云端的连接已经断开

SDK 会在跟云端的连接断开时抛出此事件回调,导致断开的原因大多是网络不可用或者网络切换所致,比如用户在通话中走进电梯时就可能会遇到此事件。 在抛出此事件之后,SDK 会努力跟云端重新建立连接,重连过程中会抛出 onTryToReconnect,连接恢复后会抛出 onConnectionRecovery 。 所以,SDK 会在如下三个连接相关的事件中按如下规律切换:

        [onConnectionLost] =====> [onTryToReconnect] =====> [onConnectionRecovery]
              /|\                                                     |
               |------------------------------------------------------|

◆ onTryToReconnect()

void onTryToReconnect ( )
inline

SDK 正在尝试重新连接到云端

SDK 会在跟云端的连接断开时抛出 onConnectionLost,之后会努力跟云端重新建立连接并抛出本事件,连接恢复后会抛出 onConnectionRecovery

◆ onConnectionRecovery()

void onConnectionRecovery ( )
inline

SDK 与云端的连接已经恢复

SDK 会在跟云端的连接断开时抛出 onConnectionLost,之后会努力跟云端重新建立连接并抛出onTryToReconnect,连接恢复后会抛出本事件回调。

◆ onSpeedTest()

void onSpeedTest ( TRTCCloudDef.TRTCSpeedTestResult  currentResult,
int  finishedCount,
int  totalCount 
)
inline

服务器测速的结果回调

当您调用 startSpeedTest 启动服务器测速后,SDK 多次抛出测速的结果回调。 SDK 会对多台云端服务器的 IP 进行测速,每个 IP 对应的测速结果都会通过本回调接口通知给您。

参数
currentResult当前完成的测速结果
finishedCount已完成测速的服务器数量
totalCount需要测速的服务器总数量

◆ onCameraDidReady()

void onCameraDidReady ( )
inline

摄像头准备就绪

当您调用 startLocalPreivew 之后,SDK 会尝试启动摄像头,如果摄像头能够启动成功就会抛出本事件。 如果启动失败,大概率是因为当前应用没有获得访问摄像头的权限,或者摄像头当前正在被其他程序独占使用中。 您可以通过捕获 onError 事件回调获知这些异常情况并通过 UI 界面提示用户。

◆ onMicDidReady()

void onMicDidReady ( )
inline

麦克风准备就绪

当您调用 startLocalAudio 之后,SDK 会尝试启动麦克风,如果麦克风能够启动成功就会抛出本事件。 如果启动失败,大概率是因为当前应用没有获得访问麦克风的权限,或者麦克风当前正在被其他程序独占使用中。 您可以通过捕获 onError 事件回调获知这些异常情况并通过 UI 界面提示用户。

◆ onAudioRouteChanged()

void onAudioRouteChanged ( int  newRoute,
int  oldRoute 
)
inline

当前音频路由发生变化(仅适用于移动设备)

所谓“音频路由”,是指声音是从手机的扬声器还是从听筒中播放出来,音频路由变化也就是声音的播放位置发生了变化。

  • 当音频路由为听筒时,声音比较小,只有将耳朵凑近才能听清楚,隐私性较好,适合用于接听电话。
  • 当音频路由为扬声器时,声音比较大,不用将手机贴脸也能听清,因此可以实现“免提”的功能。
参数
route音频路由,即声音由哪里输出(扬声器、听筒)。
fromRoute变更前的音频路由。

◆ onUserVoiceVolume()

void onUserVoiceVolume ( ArrayList< TRTCCloudDef.TRTCVolumeInfo >  userVolumes,
int  totalVolume 
)
inline

音量大小的反馈回调

SDK 可以评估每一路音频的音量大小,并每隔一段时间抛出该事件回调,您可以根据音量大小在 UI 上做出相应的提示,比如“波形图”或“音量槽”。 要完成这个功能, 您需要先调用 enableAudioVolumeEvaluation 开启这个能力并设定事件抛出的时间间隔。 需要补充说明的是,无论当前房间中是否有人说话,SDK 都会按照您设定的时间间隔定时抛出此事件回调,只不过当没有人说话时,userVolumes 为空,totalVolume 为 0。

注意
userVolumes 为一个数组,对于数组中的每一个元素,当 userId 为空时表示本地麦克风采集的音量大小,当 userId 不为空时代表远端用户的音量大小。
参数
userVolumes是一个数组,用于承载所有正在说话的用户的音量大小,取值范围 0 - 100。
totalVolume所有远端用户的总音量大小, 取值范围 0 - 100。

◆ onRecvCustomCmdMsg()

void onRecvCustomCmdMsg ( String  userId,
int  cmdID,
int  seq,
byte[]  message 
)
inline

收到自定义消息的事件回调

当房间中的某个用户使用 sendCustomCmdMsg 发送自定义 UDP 消息时,房间中的其它用户可以通过 onRecvCustomCmdMsg 事件回调接收到该条消息。

参数
userId用户标识
cmdID命令 ID
seq消息序号
message消息数据

◆ onMissCustomCmdMsg()

void onMissCustomCmdMsg ( String  userId,
int  cmdID,
int  errCode,
int  missed 
)
inline

自定义消息丢失的事件回调

当您使用 sendCustomCmdMsg 发送自定义 UDP 消息时,即使设置了可靠传输(reliable),也无法确保100%不丢失,只是丢消息概率极低,能满足常规可靠性要求。 在发送端设置了可靠运输(reliable)后,SDK 都会通过此回调通知过去时间段内(通常为5s)传输途中丢失的自定义消息数量统计信息。

注意
只有在发送端设置了可靠传输(reliable),接收方才能收到消息的丢失回调
参数
userId用户标识
cmdID命令 ID
errCode错误码
missed丢失的消息数量

◆ onRecvSEIMsg()

void onRecvSEIMsg ( String  userId,
byte[]  data 
)
inline

收到 SEI 消息的回调

当房间中的某个用户使用 sendSEIMsg 借助视频数据帧发送 SEI 消息时,房间中的其它用户可以通过 onRecvSEIMsg 事件回调接收到该条消息。

参数
userId用户标识
message数据

◆ onStartPublishing()

void onStartPublishing ( int  err,
String  errMsg 
)
inline

开始向腾讯云直播 CDN 上发布音视频流的事件回调

当您调用 startPublishing 开始向腾讯云直播 CDN 上发布音视频流时,SDK 会立刻将这一指令同步给云端服务器。 随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。

参数
err0表示成功,其余值表示失败
errMsg具体错误原因

◆ onStopPublishing()

void onStopPublishing ( int  err,
String  errMsg 
)
inline

停止向腾讯云直播 CDN 上发布音视频流的事件回调

当您调用 stopPublishing 停止向腾讯云直播 CDN 上发布音视频流时,SDK 会立刻将这一指令同步给云端服务器。 随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。

参数
err0表示成功,其余值表示失败
errMsg具体错误原因

◆ onStartPublishCDNStream()

void onStartPublishCDNStream ( int  err,
String  errMsg 
)
inline

开始向非腾讯云 CDN 上发布音视频流的事件回调

当您调用 startPublishCDNStream 开始向非腾讯云直播 CDN 上发布音视频流时,SDK 会立刻将这一指令同步给云端服务器。 随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。

注意
当您收到成功的事件回调时,只是说明您的发布指令已经同步到腾讯云后台服务器,但如果目标 CDN 厂商的服务器不接收该条视频流,依然可能导致发布失败。
参数
err0表示成功,其余值表示失败
errMsg具体错误原因

◆ onStopPublishCDNStream()

void onStopPublishCDNStream ( int  err,
String  errMsg 
)
inline

停止向非腾讯云 CDN 上发布音视频流的事件回调

当您调用 stopPublishCDNStream 开始向非腾讯云直播 CDN 上发布音视频流时,SDK 会立刻将这一指令同步给云端服务器。 随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。

参数
err0表示成功,其余值表示失败
errMsg具体错误原因

◆ onSetMixTranscodingConfig()

void onSetMixTranscodingConfig ( int  err,
String  errMsg 
)
inline

设置云端混流的排版布局和转码参数的事件回调

当您调用 setMixTranscodingConfig 调整云端混流的排版布局和转码参数时,SDK 会立刻将这一调整指令同步给云端服务器。 随后 SDK 会收到来自云端服务器的处理结果,并将指令的执行结果通过本事件回调通知给您。

参数
err错误码:0表示成功,其余值表示失败。
errMsg具体的错误原因。

◆ onScreenCaptureStarted()

void onScreenCaptureStarted ( )
inline

屏幕分享开启的事件回调

当您通过 startScreenCapture 等相关接口启动屏幕分享时,SDK 便会抛出此事件回调。

◆ onScreenCapturePaused()

void onScreenCapturePaused ( )
inline

屏幕分享暂停的事件回调

当您通过 pauseScreenCapture 暂停屏幕分享时,SDK 便会抛出此事件回调。

◆ onScreenCaptureResumed()

void onScreenCaptureResumed ( )
inline

屏幕分享恢复的事件回调

当您通过 resumeScreenCapture 恢复屏幕分享时,SDK 便会抛出此事件回调。

◆ onScreenCaptureStopped()

void onScreenCaptureStopped ( int  reason)
inline

屏幕分享停止的事件回调

当您通过 stopScreenCapture 停止屏幕分享时,SDK 便会抛出此事件回调。

参数
reason停止原因,0:用户主动停止;1:屏幕窗口关闭导致停止;2:表示屏幕分享的显示屏状态变更(如接口被拔出、投影模式变更等)。

◆ onLocalRecordBegin()

void onLocalRecordBegin ( int  errCode,
String  storagePath 
)
inline

本地录制任务已经开始的事件回调

当您调用 startLocalRecording 启动本地媒体录制任务时,SDK 会抛出该事件回调,用于通知您录制任务是否已经顺利启动。

参数
errCode错误码 0:初始化录制成功;-1:初始化录制失败;-2: 文件后缀名有误。
storagePath录制文件存储路径

◆ onLocalRecording()

void onLocalRecording ( long  duration,
String  storagePath 
)
inline

本地录制任务正在进行中的进展事件回调

当您调用 startLocalRecording 成功启动本地媒体录制任务后,SDK 变会定时地抛出本事件回调。 您可通过捕获该事件回调来获知录制任务的健康状况。 您可以在 startLocalRecording 时设定本事件回调的抛出间隔。

参数
duration已经录制的累计时长,单位毫秒
storagePath录制文件存储路径

◆ onLocalRecordComplete()

void onLocalRecordComplete ( int  errCode,
String  storagePath 
)
inline

本地录制任务已经结束的事件回调

当您调用 stopLocalRecording 停止本地媒体录制任务时,SDK 会抛出该事件回调,用于通知您录制任务的最终结果。

参数
errCode错误码 0:录制成功;-1:录制失败;-2:切换分辨率或横竖屏导致录制结束。
storagePath录制文件存储路径

◆ onUserEnter()

void onUserEnter ( String  userId)
inline

有主播加入当前房间(已废弃)

弃用:
新版本开始不推荐使用,建议使用 onRemoteUserEnterRoom 替代之。

◆ onUserExit()

void onUserExit ( String  userId,
int  reason 
)
inline

有主播离开当前房间(已废弃)

弃用:
新版本开始不推荐使用,建议使用 onRemoteUserLeaveRoom 替代之。

◆ onAudioEffectFinished()

void onAudioEffectFinished ( int  effectId,
int  code 
)
inline

音效播放已结束(已废弃)

弃用:
新版本开始不推荐使用,建议使用 ITXAudioEffectManager 接口替代之。 新的接口中不再区分背景音乐和音效,而是统一用 startPlayMusic 取代之。