Only the Chinese version of this page is provided currently. The English version will be provided soon.
Help & Documentation>Tencent Real-Time Communication

API 概览

Last updated: 2025-12-09 17:53:32

API OVERVIEW

创建实例和事件回调

函数列表
描述
创建 TRTCCloud 实例(单例模式)。
销毁 TRTCCloud 实例(单例模式)。
添加 TRTC 事件回调。
移除 TRTC 事件回调。

房间相关接口函数

函数列表
描述
进入房间。
离开房间。
切换角色。
切换房间。
请求跨房通话。
退出跨房通话。
设置订阅模式(需要在进入房前设置才能生效)。
创建子房间实例(用于多房间并发观看)。
销毁子房间实例。

CDN 相关接口函数

函数列表
描述
开始发布媒体流。
更新发布媒体流。
停止发布媒体流。

视频相关接口函数

函数列表
描述
开启本地摄像头的预览画面(移动端)。
停止摄像头预览。
暂停/恢复发布本地的视频流。
订阅远端用户的视频流,并绑定视频渲染控件。
停止订阅远端用户的视频流,并释放渲染控件。
停止订阅所有远端用户的视频流,并释放全部渲染资源。
暂停/恢复订阅远端用户的视频流。
暂停/恢复订阅所有远端用户的视频流。
设置视频编码器的编码参数。
设置网络质量控制的相关参数。
设置本地画面的渲染参数。
设置远端画面的渲染模式。
开启大小画面双路编码模式。
切换指定远端用户的大小画面。
设置重力感应的适配模式(11.7 及以上版本)。

音频相关接口函数

函数列表
描述
开启本地音频的采集和发布。
停止本地音频的采集和发布。
暂停/恢复发布本地的音频流。
暂停/恢复播放远端的音频流。
暂停/恢复播放所有远端用户的音频流。
设定某一个远端用户的声音播放音量。
设定本地音频的采集音量。
获取本地音频的采集音量。
设定远端音频的播放音量。
获取远端音频的播放音量。
启用音量大小提示。
开启本地媒体录制。
停止本地媒体录制。

设备管理相关接口

函数列表
描述
获取设备管理类(TXDeviceManager)。

美颜特效和图像水印

函数列表
描述
设置美颜、美白、红润等特效。
添加水印。

背景音乐和声音特效

函数列表
描述
获取音效管理类(TXAudioEffectManager)。
开启系统声音采集(iOS 端暂未支持)。
停止系统声音采集(iOS 端暂未支持)。

屏幕分享相关接口

函数列表
描述
启动屏幕分享。
停止屏幕分享。
暂停屏幕分享。
恢复屏幕分享。
选取要分享的屏幕或窗口(该接口仅支持桌面系统)。
设置屏幕分享(即辅路)的视频编码参数(桌面系统和移动系统均已支持)。

自定义采集和自定义渲染

函数列表
描述
启用/关闭视频自定义采集模式。
向 SDK 投送自己采集的视频帧。
启用音频自定义采集模式。
向 SDK 投送自己采集的音频数据。
启用/关闭自定义音轨。
.1 开启视频第三方美颜。
.2 设置第三方美颜的视频数据回调。
设置本地视频自定义渲染回调。
设置远端视频自定义渲染回调。
设置音频数据自定义回调。
设置本地麦克风采集出的音频帧回调格式。
设置经过前处理后的本地音频帧回调格式。
设置最终要由系统播放出的音频帧回调格式。

自定义消息发送接口

函数列表
描述
使用 UDP 通道发送自定义消息给房间内所有用户。
使用 SEI 通道发送自定义消息给房间内所有用户。

网络测试接口

函数列表
描述
开始进行网速测试(进入房间前使用)。
停止网络测速。

调试相关接口

函数列表
描述
获取 unity SDK 版本信息。
获取 SDK 版本信息。
设置 Log 输出级别。
启用/禁用控制台日志打印。
启用/禁用日志的本地压缩。
设置本地日志的保存路径。
设置日志回调。
调用实验性接口。

错误和警告事件

函数列表
描述
错误事件回调。
警告事件回调。

房间相关事件回调

函数列表
描述
进入房间成功与否的事件回调。
离开房间的事件回调。
切换角色的事件回调。
切换房间的结果回调。
请求跨房通话的结果回调。
结束跨房通话的结果回调。

用户相关事件回调

函数列表
描述
有用户加入当前房间。
有用户离开当前房间。
某远端用户发布/取消了主路视频画面。
某远端用户发布/取消了辅路视频画面。
某远端用户发布/取消了自己的音频。
SDK 开始渲染自己本地或远端用户的首帧画面。
SDK 开始播放远端用户的首帧音频。
自己本地的首个视频帧已被发布出去。
自己本地的首个音频帧已被发布出去。

网络和技术指标统计回调

函数列表
描述
网络质量的实时统计回调。
音视频技术指标的实时统计回调。
网速测试的结果回调。

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

函数列表
描述
SDK 与云端的连接已经断开。
SDK 正在尝试重新连接到云端。
SDK 与云端的连接已经恢复。

硬件设备相关事件回调

函数列表
描述
摄像头准备就绪。
麦克风准备就绪。
当前音频路由发生变化(仅适用于移动设备)。
音量大小的反馈回调。
本地设备的通断状态发生变化(仅适用于桌面系统)。
当前麦克风的系统采集音量发生变化。
当前系统的播放音量发生变化。
测试麦克风时的音量回调。
测试扬声器时的音量回调。

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

函数列表
描述
收到自定义消息的事件回调。
自定义消息丢失的事件回调。
收到 SEI 消息的回调。

CDN 相关事件回调

函数列表
描述
开始向腾讯云直播 CDN 上发布音视频流的事件回调。
停止向腾讯云直播 CDN 上发布音视频流的事件回调。
设置云端混流的排版布局和转码参数的事件回调。
开始发布媒体流的事件回调。
更新媒体流的事件回调。
停止媒体流的事件回调。
RTMP/RTMPS 推流状态发生改变回调。

屏幕分享相关事件回调

函数列表
描述
屏幕分享开启的事件回调。
屏幕分享暂停的事件回调。
屏幕分享恢复的事件回调。
屏幕分享停止的事件回调。

视频数据自定义回调

函数列表
描述
自定义视频渲染回调。
SDK 内部 OpenGL 环境已经创建的通知。
用于对接第三方美颜组件的视频处理回调。
SDK 内部 OpenGL 环境被销毁的通知。

音频数据自定义回调

函数列表
描述
本地采集并经过音频模块前处理后的音频数据回调。
本地采集并经过音频模块前处理、音效处理和混 BGM 后的音频数据回调。
混音前的每一路远程用户的音频数据。
将各路待播放音频混合之后并在最终提交系统播放之前的数据回调。

更多事件回调接口

函数列表
描述
本地 LOG 的打印回调。

背景音乐预加载事件回调

函数列表
描述
背景音乐预加载进度
背景音乐预加载出错

背景音乐的播放事件回调

函数列表
描述
背景音乐开始播放
背景音乐的播放进度
背景音乐已经播放完毕

人声相关的特效接口

函数列表
描述
开启耳返。
设置耳返音量。
设置人声的混响效果。
设置人声的变声特效。
设置语音音量。
设置语音音调。

背景音乐的相关接口

函数列表
描述
设置背景音乐的事件回调接口。
开始播放背景音乐。
停止播放背景音乐。
暂停播放背景音乐。
恢复播放背景音乐。
设置所有背景音乐的本地音量和远端音量的大小。
设置某一首背景音乐的远端音量的大小。
设置某一首背景音乐的本地音量的大小。
调整背景音乐的音调高低。
调整背景音乐的变速效果。
获取背景音乐的播放进度(单位:毫秒)。
获取背景音乐的总时长(单位:毫秒)。
设置背景音乐的播放进度(单位:毫秒)。
调整搓碟的变速效果。
设置预加载事件回调。
预加载背景音乐。
获取背景音乐的音轨数量。
指定背景音乐的播放音轨。

音视频设备相关的类型定义

函数列表
描述
本地设备的通断状态发生变化(仅适用于桌面系统)。

设备操作接口

函数列表
描述
判断当前是否为前置摄像头(仅适用于移动端)。
切换前置或后置摄像头(仅适用于移动端)。
获取摄像头的最大缩放倍数(仅适用于移动端)。
设置摄像头的缩放倍数(仅适用于移动端)。
查询是否支持自动识别人脸位置(仅适用于移动端)。
开启自动对焦功能(仅适用于移动端)。
设置摄像头的对焦位置(仅适用于移动端)。
开启/关闭闪光灯,也就是手电筒模式(仅适用于移动端)。
设置音频路由(仅适用于移动端)。
设置当前要使用的设备(仅适用于桌面端)。
获取当前正在使用的设备(仅适用于桌面端)。
开始麦克风测试(仅适用于桌面端)。
结束麦克风测试(仅适用于桌面端)。
开始扬声器测试(仅适用于桌面端)。
结束扬声器测试(仅适用于桌面端)。

弃用接口

函数列表
描述
设置系统音量类型(仅适用于移动端)。