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

详细描述

腾讯云视频通话功能的回调接口类


结构体说明

◆ trtc::ITRTCCloudCallback

class trtc::ITRTCCloudCallback

Public 成员函数

virtual ~ITRTCCloudCallback ()
 

错误事件和警告事件

virtual void onError (TXLiteAVError errCode, const char *errMsg, void *extraInfo)=0
 
virtual void onWarning (TXLiteAVWarning warningCode, const char *warningMsg, void *extraInfo)=0
 

房间事件回调

virtual void onEnterRoom (int result)=0
 
virtual void onExitRoom (int reason)=0
 
virtual void onSwitchRole (TXLiteAVError errCode, const char *errMsg)
 
virtual void onConnectOtherRoom (const char *userId, TXLiteAVError errCode, const char *errMsg)
 
virtual void onDisconnectOtherRoom (TXLiteAVError errCode, const char *errMsg)
 
virtual void onSwitchRoom (TXLiteAVError errCode, const char *errMsg)
 

成员事件回调

virtual void onRemoteUserEnterRoom (const char *userId)
 
virtual void onRemoteUserLeaveRoom (const char *userId, int reason)
 
virtual void onUserVideoAvailable (const char *userId, bool available)
 
virtual void onUserSubStreamAvailable (const char *userId, bool available)
 
virtual void onUserAudioAvailable (const char *userId, bool available)
 
virtual void onFirstVideoFrame (const char *userId, const TRTCVideoStreamType streamType, const int width, const int height)
 
virtual void onFirstAudioFrame (const char *userId)
 
virtual void onSendFirstLocalVideoFrame (const TRTCVideoStreamType streamType)
 
virtual void onSendFirstLocalAudioFrame ()
 

统计和质量回调

virtual void onNetworkQuality (TRTCQualityInfo localQuality, TRTCQualityInfo *remoteQuality, uint32_t remoteQualityCount)
 
virtual void onStatistics (const TRTCStatistics &statis)
 

服务器事件回调

virtual void onConnectionLost ()
 
virtual void onTryToReconnect ()
 
virtual void onConnectionRecovery ()
 
virtual void onSpeedTest (const TRTCSpeedTestResult &currentResult, uint32_t finishedCount, uint32_t totalCount)
 

硬件设备事件回调

virtual void onCameraDidReady ()
 
virtual void onMicDidReady ()
 
virtual void onUserVoiceVolume (TRTCVolumeInfo *userVolumes, uint32_t userVolumesCount, uint32_t totalVolume)
 
virtual void onDeviceChange (const char *deviceId, TRTCDeviceType type, TRTCDeviceState state)
 
virtual void onTestMicVolume (uint32_t volume)
 
virtual void onTestSpeakerVolume (uint32_t volume)
 
virtual void onAudioDeviceCaptureVolumeChanged (uint32_t volume, bool muted)
 
virtual void onAudioDevicePlayoutVolumeChanged (uint32_t volume, bool muted)
 

自定义消息的接收回调

virtual void onRecvCustomCmdMsg (const char *userId, int32_t cmdID, uint32_t seq, const uint8_t *message, uint32_t messageSize)
 
virtual void onMissCustomCmdMsg (const char *userId, int32_t cmdID, int32_t errCode, int32_t missed)
 
virtual void onRecvSEIMsg (const char *userId, const uint8_t *message, uint32_t messageSize)
 

CDN 旁路转推回调

virtual void onStartPublishing (int err, const char *errMsg)
 
virtual void onStopPublishing (int err, const char *errMsg)
 
virtual void onStartPublishCDNStream (int errCode, const char *errMsg)
 
virtual void onStopPublishCDNStream (int errCode, const char *errMsg)
 
virtual void onSetMixTranscodingConfig (int errCode, const char *errMsg)
 

屏幕分享回调

virtual void onScreenCaptureCovered ()
 
virtual void onScreenCaptureStarted ()
 
virtual void onScreenCapturePaused (int reason)
 
virtual void onScreenCaptureResumed (int reason)
 
virtual void onScreenCaptureStoped (int reason)
 

Windows 专有废弃方法

virtual deprecated void onUserEnter (const char *userId)
 
virtual deprecated void onUserExit (const char *userId, int reason)
 
virtual deprecated void onAudioEffectFinished (int effectId, int code)
 
virtual deprecated void onPlayBGMBegin (TXLiteAVError errCode)
 
virtual deprecated void onPlayBGMProgress (uint32_t progressMS, uint32_t durationMS)
 
virtual deprecated void onPlayBGMComplete (TXLiteAVError errCode)
 

构造及析构函数说明

◆ ~ITRTCCloudCallback()

virtual ~ITRTCCloudCallback ( )
inlinevirtual

成员函数说明

◆ onError()

virtual void onError ( TXLiteAVError  errCode,
const char *  errMsg,
void *  extraInfo 
)
pure virtual

错误回调:SDK 不可恢复的错误,一定要监听,并分情况给用户适当的界面提示。

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

◆ onWarning()

virtual void onWarning ( TXLiteAVWarning  warningCode,
const char *  warningMsg,
void *  extraInfo 
)
pure virtual

警告回调:用于告知您一些非严重性问题,例如出现了卡顿或者可恢复的解码失败。

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

◆ onEnterRoom()

virtual void onEnterRoom ( int  result)
pure virtual

已加入房间的回调

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

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

◆ onExitRoom()

virtual void onExitRoom ( int  reason)
pure virtual

离开房间的事件回调

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

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

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

◆ onSwitchRole()

virtual void onSwitchRole ( TXLiteAVError  errCode,
const char *  errMsg 
)
inlinevirtual

切换角色的事件回调

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

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

◆ onConnectOtherRoom()

virtual void onConnectOtherRoom ( const char *  userId,
TXLiteAVError  errCode,
const char *  errMsg 
)
inlinevirtual

请求跨房通话(主播 PK)的结果回调

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

参数
userId要 PK 的目标主播 userId。
errCode错误码,ERR_NULL 代表切换成功,其他请参见错误码
errMsg错误信息。

◆ onDisconnectOtherRoom()

virtual void onDisconnectOtherRoom ( TXLiteAVError  errCode,
const char *  errMsg 
)
inlinevirtual

结束跨房通话(主播 PK)的结果回调

◆ onSwitchRoom()

virtual void onSwitchRoom ( TXLiteAVError  errCode,
const char *  errMsg 
)
inlinevirtual

切换房间 (switchRoom) 的结果回调

◆ onRemoteUserEnterRoom()

virtual void onRemoteUserEnterRoom ( const char *  userId)
inlinevirtual

有用户加入当前房间

出于性能方面的考虑,在两种不同的应用场景下,该通知的行为会有差别:

  • 通话场景(TRTCAppSceneVideoCall 和 TRTCAppSceneAudioCall):该场景下用户没有角色的区别,任何用户进入房间都会触发该通知。
  • 直播场景(TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom):该场景不限制观众的数量,如果任何用户进出都抛出回调会引起很大的性能损耗,所以该场景下只有主播进入房间时才会触发该通知,观众进入房间不会触发该通知。
注意
注意 onRemoteUserEnterRoom 和 onRemoteUserLeaveRoom 只适用于维护当前房间里的“成员列表”,如果需要显示远程画面,建议使用监听 onUserVideoAvailable() 事件回调。
参数
userId用户标识

◆ onRemoteUserLeaveRoom()

virtual void onRemoteUserLeaveRoom ( const char *  userId,
int  reason 
)
inlinevirtual

有用户离开当前房间

与 onRemoteUserEnterRoom 相对应,在两种不同的应用场景下,该通知的行为会有差别:

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

◆ onUserVideoAvailable()

virtual void onUserVideoAvailable ( const char *  userId,
bool  available 
)
inlinevirtual

用户是否开启摄像头视频

当您收到 onUserVideoAvailable(userId, YES) 通知时,表示该路画面已经有可用的视频数据帧到达。 此时,您需要调用 startRemoteView(userId) 接口加载该用户的远程画面。 然后,您还会收到名为 onFirstVideoFrame(userId) 的首帧画面渲染回调。

当您收到 onUserVideoAvailable(userId, NO) 通知时,表示该路远程画面已被关闭, 可能由于该用户调用了 muteLocalVideo() 或 stopLocalPreview()。

参数
userId用户标识
available画面是否开启

◆ onUserSubStreamAvailable()

virtual void onUserSubStreamAvailable ( const char *  userId,
bool  available 
)
inlinevirtual

用户是否开启屏幕分享

参数
userId用户标识
available屏幕分享是否开启

◆ onUserAudioAvailable()

virtual void onUserAudioAvailable ( const char *  userId,
bool  available 
)
inlinevirtual

用户是否开启音频上行

参数
userId用户标识
available声音是否开启

◆ onFirstVideoFrame()

virtual void onFirstVideoFrame ( const char *  userId,
const TRTCVideoStreamType  streamType,
const int  width,
const int  height 
)
inlinevirtual

开始渲染本地或远程用户的首帧画面

如果 userId 为 null,表示开始渲染本地采集的摄像头画面,需要您先调用 startLocalPreview 触发。 如果 userId 不为 null,表示开始渲染远程用户的首帧画面,需要您先调用 startRemoteView 触发。

注意
只有当您调用 startLocalPreview()、startRemoteView() 或 startRemoteSubStreamView() 之后,才会触发该回调。
参数
userId本地或远程用户 ID,如果 userId == null 代表本地,userId != null 代表远程。
streamType视频流类型:摄像头或屏幕分享。
width画面宽度
height画面高度

◆ onFirstAudioFrame()

virtual void onFirstAudioFrame ( const char *  userId)
inlinevirtual

开始播放远程用户的首帧音频(本地声音暂不通知)

参数
userId远程用户 ID。

◆ onSendFirstLocalVideoFrame()

virtual void onSendFirstLocalVideoFrame ( const TRTCVideoStreamType  streamType)
inlinevirtual

首帧本地视频数据已经被送出

SDK 会在 enterRoom() 并 startLocalPreview() 成功后开始摄像头采集,并将采集到的画面进行编码。 当 SDK 成功向云端送出第一帧视频数据后,会抛出这个回调事件。

参数
streamType视频流类型,主画面、小画面或辅流画面(屏幕分享)

◆ onSendFirstLocalAudioFrame()

virtual void onSendFirstLocalAudioFrame ( )
inlinevirtual

首帧本地音频数据已经被送出

SDK 会在 enterRoom() 并 startLocalAudio() 成功后开始麦克风采集,并将采集到的声音进行编码。 当 SDK 成功向云端送出第一帧音频数据后,会抛出这个回调事件。

◆ onNetworkQuality()

virtual void onNetworkQuality ( TRTCQualityInfo  localQuality,
TRTCQualityInfo remoteQuality,
uint32_t  remoteQualityCount 
)
inlinevirtual

网络质量:该回调每2秒触发一次,统计当前网络的上行和下行质量

注意
userId == null 代表自己当前的视频质量
参数
localQuality上行网络质量
remoteQuality下行网络质量
remoteQualityCount下行网络质量的数组大小

◆ onStatistics()

virtual void onStatistics ( const TRTCStatistics statis)
inlinevirtual

技术指标统计回调

如果您是熟悉音视频领域相关术语,可以通过这个回调获取 SDK 的所有技术指标。 如果您是首次开发音视频相关项目,可以只关注 onNetworkQuality 回调。

参数
statis统计数据,包括本地和远程的
注意
每2秒回调一次

◆ onConnectionLost()

virtual void onConnectionLost ( )
inlinevirtual

SDK 跟服务器的连接断开

◆ onTryToReconnect()

virtual void onTryToReconnect ( )
inlinevirtual

SDK 尝试重新连接到服务器

◆ onConnectionRecovery()

virtual void onConnectionRecovery ( )
inlinevirtual

SDK 跟服务器的连接恢复

◆ onSpeedTest()

virtual void onSpeedTest ( const TRTCSpeedTestResult currentResult,
uint32_t  finishedCount,
uint32_t  totalCount 
)
inlinevirtual

服务器测速的回调,SDK 对多个服务器 IP 做测速,每个 IP 的测速结果通过这个回调通知

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

◆ onCameraDidReady()

virtual void onCameraDidReady ( )
inlinevirtual

摄像头准备就绪

◆ onMicDidReady()

virtual void onMicDidReady ( )
inlinevirtual

麦克风准备就绪

◆ onUserVoiceVolume()

virtual void onUserVoiceVolume ( TRTCVolumeInfo userVolumes,
uint32_t  userVolumesCount,
uint32_t  totalVolume 
)
inlinevirtual

用于提示音量大小的回调,包括每个 userId 的音量和远端总音量

您可以通过调用 TRTCCloud 中的 enableAudioVolumeEvaluation 接口来开关这个回调或者设置它的触发间隔。 需要注意的是,调用 enableAudioVolumeEvaluation 开启音量回调后,无论频道内是否有人说话,都会按设置的时间间隔调用这个回调, 如果没有人说话,则 userVolumes 为空,totalVolume 为0。

参数
userVolumes所有正在说话的房间成员的音量,取值范围0 - 100。
userVolumesCount房间成员数量
totalVolume所有远端成员的总音量, 取值范围0 - 100。
注意
userId 为 null 时表示自己的音量,userVolumes 内仅包含正在说话(音量不为0)的用户音量信息。

◆ onDeviceChange()

virtual void onDeviceChange ( const char *  deviceId,
TRTCDeviceType  type,
TRTCDeviceState  state 
)
inlinevirtual

本地设备通断回调

参数
deviceId设备 ID
type设备类型
state事件类型

◆ onTestMicVolume()

virtual void onTestMicVolume ( uint32_t  volume)
inlinevirtual

麦克风测试音量回调

麦克风测试接口 startMicDeviceTest 会触发这个回调

参数
volume音量值,取值范围0 - 100

◆ onTestSpeakerVolume()

virtual void onTestSpeakerVolume ( uint32_t  volume)
inlinevirtual

扬声器测试音量回调

扬声器测试接口 startSpeakerDeviceTest 会触发这个回调

参数
volume音量值,取值范围0 - 100

◆ onAudioDeviceCaptureVolumeChanged()

virtual void onAudioDeviceCaptureVolumeChanged ( uint32_t  volume,
bool  muted 
)
inlinevirtual

当前音频采集设备音量变化通知

注意
使用 enableAudioVolumeEvaluation(interval>0)开启,(interval==0)关闭
参数
volume音量值,取值范围0 - 100
muted当前采集音频设备是否被静音,true:静音;false:取消静音

◆ onAudioDevicePlayoutVolumeChanged()

virtual void onAudioDevicePlayoutVolumeChanged ( uint32_t  volume,
bool  muted 
)
inlinevirtual

当前音频播放设备音量变化通知

注意
使用 enableAudioVolumeEvaluation(interval>0)开启,(interval==0)关闭
参数
volume音量值,取值范围0 - 100
muted当前音频播放设备是否被静音,true:静音;false:取消静音

◆ onRecvCustomCmdMsg()

virtual void onRecvCustomCmdMsg ( const char *  userId,
int32_t  cmdID,
uint32_t  seq,
const uint8_t *  message,
uint32_t  messageSize 
)
inlinevirtual

收到自定义消息回调

当房间中的某个用户使用 sendCustomCmdMsg 发送自定义消息时,房间中的其它用户可以通过 onRecvCustomCmdMsg 接口接收消息

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

◆ onMissCustomCmdMsg()

virtual void onMissCustomCmdMsg ( const char *  userId,
int32_t  cmdID,
int32_t  errCode,
int32_t  missed 
)
inlinevirtual

自定义消息丢失回调

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

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

◆ onRecvSEIMsg()

virtual void onRecvSEIMsg ( const char *  userId,
const uint8_t *  message,
uint32_t  messageSize 
)
inlinevirtual

收到 SEI 消息的回调

当房间中的某个用户使用 sendSEIMsg 发送数据时,房间中的其它用户可以通过 onRecvSEIMsg 接口接收数据。

参数
userId用户标识
message数据
messageSize数据大小

◆ onStartPublishing()

virtual void onStartPublishing ( int  err,
const char *  errMsg 
)
inlinevirtual

开始向腾讯云的直播 CDN 推流的回调,对应于 TRTCCloud 中的 startPublishing() 接口

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

◆ onStopPublishing()

virtual void onStopPublishing ( int  err,
const char *  errMsg 
)
inlinevirtual

停止向腾讯云的直播 CDN 推流的回调,对应于 TRTCCloud 中的 stopPublishing() 接口

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

◆ onStartPublishCDNStream()

virtual void onStartPublishCDNStream ( int  errCode,
const char *  errMsg 
)
inlinevirtual

启动旁路推流到 CDN 完成的回调

对应于 TRTCCloud 中的 startPublishCDNStream() 接口

注意
Start 回调如果成功,只能说明转推请求已经成功告知给腾讯云,如果目标 CDN 有异常,还是有可能会转推失败。

◆ onStopPublishCDNStream()

virtual void onStopPublishCDNStream ( int  errCode,
const char *  errMsg 
)
inlinevirtual

停止旁路推流到 CDN 完成的回调

对应于 TRTCCloud 中的 stopPublishCDNStream() 接口

◆ onSetMixTranscodingConfig()

virtual void onSetMixTranscodingConfig ( int  errCode,
const char *  errMsg 
)
inlinevirtual

设置云端的混流转码参数的回调,对应于 TRTCCloud 中的 setMixTranscodingConfig() 接口

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

◆ onScreenCaptureCovered()

virtual void onScreenCaptureCovered ( )
inlinevirtual

当屏幕分享窗口被遮挡无法正常捕获时,SDK 会通过此回调通知,可在此回调里通知用户移开遮挡窗口 目前只支持Windows平台

◆ onScreenCaptureStarted()

virtual void onScreenCaptureStarted ( )
inlinevirtual

当屏幕分享开始时,SDK 会通过此回调通知

◆ onScreenCapturePaused()

virtual void onScreenCapturePaused ( int  reason)
inlinevirtual

当屏幕分享暂停时,SDK 会通过此回调通知

参数
reason停止原因,0:表示用户主动暂停;1:表示设置屏幕分享参数导致的暂停;2:表示屏幕分享窗口被最小化导致的暂停;3:表示屏幕分享窗口被隐藏导致的暂停

◆ onScreenCaptureResumed()

virtual void onScreenCaptureResumed ( int  reason)
inlinevirtual

当屏幕分享恢复时,SDK 会通过此回调通知

参数
reason停止原因,0:表示用户主动恢复,1:表示屏幕分享参数设置完毕后自动恢复;2:表示屏幕分享窗口从最小化被恢复;3:表示屏幕分享窗口从隐藏被恢复

◆ onScreenCaptureStoped()

virtual void onScreenCaptureStoped ( int  reason)
inlinevirtual

当屏幕分享停止时,SDK 会通过此回调通知

参数
reason停止原因,0:表示用户主动停止;1:表示屏幕分享窗口被关闭

◆ onUserEnter()

virtual deprecated void onUserEnter ( const char *  userId)
inlinevirtual

废弃接口:有主播加入当前房间

该回调接口可以被看作是 onRemoteUserEnterRoom 的废弃版本,不推荐使用。请使用 onUserVideoAvailable 或 onRemoteUserEnterRoom 进行替代。

注意
该接口已被废弃,不推荐使用
参数
userId用户标识

◆ onUserExit()

virtual deprecated void onUserExit ( const char *  userId,
int  reason 
)
inlinevirtual

废弃接口:有主播离开当前房间

该回调接口可以被看作是 onRemoteUserLeaveRoom 的废弃版本,不推荐使用。请使用 onUserVideoAvailable 或 onRemoteUserLeaveRoom 进行替代。

注意
该接口已被废弃,不推荐使用
参数
userId用户标识
reason离开原因。

◆ onAudioEffectFinished()

virtual deprecated void onAudioEffectFinished ( int  effectId,
int  code 
)
inlinevirtual

废弃接口:播放音效结束回调

参数
effectId音效id
code0表示播放正常结束;其他表示异常结束

◆ onPlayBGMBegin()

virtual deprecated void onPlayBGMBegin ( TXLiteAVError  errCode)
inlinevirtual

废弃接口:开始播放背景音乐

参数
errCode错误码

◆ onPlayBGMProgress()

virtual deprecated void onPlayBGMProgress ( uint32_t  progressMS,
uint32_t  durationMS 
)
inlinevirtual

废弃接口:播放背景音乐的进度

参数
progressMS已播放时间
durationMS总时间

◆ onPlayBGMComplete()

virtual deprecated void onPlayBGMComplete ( TXLiteAVError  errCode)
inlinevirtual

废弃接口:播放背景音乐结束

参数
errCode错误码

◆ trtc::ITRTCVideoRenderCallback

class trtc::ITRTCVideoRenderCallback

Public 成员函数

virtual ~ITRTCVideoRenderCallback ()
 
virtual void onRenderVideoFrame (const char *userId, TRTCVideoStreamType streamType, TRTCVideoFrame *frame)
 

构造及析构函数说明

◆ ~ITRTCVideoRenderCallback()

virtual ~ITRTCVideoRenderCallback ( )
inlinevirtual

成员函数说明

◆ onRenderVideoFrame()

virtual void onRenderVideoFrame ( const char *  userId,
TRTCVideoStreamType  streamType,
TRTCVideoFrame frame 
)
inlinevirtual

自定义视频渲染回调

可以通过 setLocalVideoRenderCallback 和 setRemoteVideoRenderCallback 接口设置自定义渲染回调

参数
userId用户标识
streamType流类型:即摄像头还是屏幕分享
frame视频帧数据
注意
- 在iOS和Mac平台上回调的视频帧为TRTCVideoBufferType_Buffer类型

◆ trtc::ITRTCAudioFrameCallback

class trtc::ITRTCAudioFrameCallback

Public 成员函数

virtual ~ITRTCAudioFrameCallback ()
 
virtual void onCapturedAudioFrame (TRTCAudioFrame *frame)
 
virtual void onLocalProcessedAudioFrame (TRTCAudioFrame *frame)
 
virtual void onPlayAudioFrame (TRTCAudioFrame *frame, const char *userId)
 
virtual void onMixedPlayAudioFrame (TRTCAudioFrame *frame)
 

构造及析构函数说明

◆ ~ITRTCAudioFrameCallback()

virtual ~ITRTCAudioFrameCallback ( )
inlinevirtual

成员函数说明

◆ onCapturedAudioFrame()

virtual void onCapturedAudioFrame ( TRTCAudioFrame frame)
inlinevirtual

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

参数
frame音频数据
注意
- 请不要在此回调函数中做任何耗时操作,建议直接拷贝到另一线程进行处理,否则会导致各种声音问题。
- 此接口回调出的音频数据支持修改。
- 此接口回调出的音频时间帧长固定为0.02s。 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。 以SDK默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
- 此接口回调出的音频数据包含背景音、音效、混响等前处理效果。

◆ onLocalProcessedAudioFrame()

virtual void onLocalProcessedAudioFrame ( TRTCAudioFrame frame)
inlinevirtual

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

参数
frame音频数据
注意
- 请不要在此回调函数中做任何耗时操作,建议直接拷贝到另一线程进行处理,否则会导致各种声音问题。
- 此接口回调出的音频数据包含背景音、音效、混响等前处理效果,延迟较高。
- 此接口回调出的音频数据支持修改。
- 此接口回调出的音频时间帧长固定为0.02s。 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。 以SDK默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。

◆ onPlayAudioFrame()

virtual void onPlayAudioFrame ( TRTCAudioFrame frame,
const char *  userId 
)
inlinevirtual

混音前的每一路远程用户的音频数据(例如您要对某一路的语音进行文字转换,必须要使用这里的原始数据,而不是混音之后的数据)

参数
frame音频数据
userId用户标识
注意
- 请不要在此回调函数中做任何耗时操作,建议直接拷贝到另一线程进行处理,否则会导致各种声音问题。
  • 此接口回调出的音频数据是只读的,不支持修改。

◆ onMixedPlayAudioFrame()

virtual void onMixedPlayAudioFrame ( TRTCAudioFrame frame)
inlinevirtual

各路音频数据混合后送入喇叭播放的音频数据

参数
frame音频数据
注意
- 请不要在此回调函数中做任何耗时操作,建议直接拷贝到另一线程进行处理,否则会导致各种声音问题。
- 此接口回调出的音频数据支持修改。
- 此接口回调出的音频时间帧长固定为0.02s。 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。 以SDK默认的音频播放格式48000采样率、双声道、16采样点位宽为例,字节帧长为【48000 × 0.02s × 2 × 16bit = 30720bit = 3840字节】。
- 此接口回调出的音频数据是各路音频播放数据的混合,不包含耳返的音频数据。

◆ trtc::ITRTCLogCallback

class trtc::ITRTCLogCallback

Public 成员函数

virtual ~ITRTCLogCallback ()
 
virtual void onLog (const char *log, TRTCLogLevel level, const char *module)
 

构造及析构函数说明

◆ ~ITRTCLogCallback()

virtual ~ITRTCLogCallback ( )
inlinevirtual

成员函数说明

◆ onLog()

virtual void onLog ( const char *  log,
TRTCLogLevel  level,
const char *  module 
)
inlinevirtual

有日志打印时的回调

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