- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 客户端API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 客户端API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
实时音视频是什么？
腾讯实时音视频（Tencent Real-Time Communication，TRTC），将腾讯多年来在网络与音视频技术上的深度积累，以多人音视频通话和低延时互动直播两大场景化方案，通过腾讯云服务向开发者开放，致力于帮助开发者快速搭建低成本、低延时、高品质的音视频互动解决方案，详细说明请参见 产品概述。
实时音视频 Demo 怎么体验？
实时音视频如何快速入门？
实时音视频 RoomID 是什么？取值区间值是多少？
RoomID 即房间号，用于唯一标识一个房间。房间号取值区间为1 - 4294967295，由开发者自行维护和分配。
TRTC 进房 UserID 是什么？取值范围是多少？
UserID 即用户ID，用于在一个实时音视频应用中唯一标识一个用户。取值范围长度建议不超过32字节。请使用英文字母、数字或下划线，区分大小写。
TRTC 房间的生命周期是多久？
第一个加入房间的用户为当前房间的所有者，但该用户无法主动解散房间。
通话模式下：所有用户都主动退房时，后台立即解散房间。
直播模式下：最后一个退房的用户是主播角色时，后台立即解散房间；最后一个退房的用户是观众角色时，后台等待10分钟后解散房间。
如果房间内的单个用户异常掉线，90秒后服务端会将该用户清理出当前房间。如果房间内的所有用户都异常掉线，90秒后服务端会自动解散当前房间。用户异常掉线等待时长会被纳入计费用时统计。
当用户要加入的房间不存在时，后台会自动创建一个房间。
TRTC 是否支持不订阅音视频流？
为了实现“秒开”效果，默认是进房自动订阅流，可以通过 setDefaultStreamRecvMode 接口切换手动订阅模式。
TRTC 是否支持自定义旁路推流的流 ID？
支持，您可以通过 enterRoom 的参数 TRTCParams 指定 streamId，也可以调用 startPublishing 接口传参数 streamId。
TRTC 直播支持什么角色？有什么区别？
直播场景（TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom）支持 TRTCRoleAnchor（主播）和 TRTCRoleAudience（观众）两种角色，区别是主播角色可以同时上行、下行音视频数据，观众角色只支持下行播放其他人的数据。您可以通过调用 switchRole() 进行角色切换。
怎么理解 TRTC 的角色 Role？
只有在直播场景下，可以设置主播和观众角色。主播角色 TRTCRoleAnchor 具有上行和下行音视频的权限，最高并发支持50人，观众 TRTCRoleAudience 只具有下行音视频的权限，最高并发支持10万人。
TRTC 房间支持哪些应用场景?
支持以下场景：
TRTCAppSceneVideoCall ：视频通话场景，适合1对1视频通话、300人视频会议、在线问诊、视频聊天、远程面试等。
TRTCAppSceneLIVE ：视频互动直播，适合视频低延时直播、十万人互动课堂、视频直播 PK、视频相亲房、互动课堂、远程培训、超大型会议等。
TRTCAppSceneAudioCall ：语音通话场景，适合1对1语音通话、300人语音会议、语音聊天、语音会议、在线狼人杀等。
TRTCAppSceneVoiceChatRoom：语音互动直播，适合：语音低延时直播、语音直播连麦、语聊房、K 歌房、FM 电台等。
TRTC 支持哪些平台？
TRTC 精简版和全功能版的区别？
实时音视频支持直播连麦吗?
支持，具体操作指南请参考：
实时音视频最多可以同时创建多少个房间？
支持同时并发存在4294967294个房间，累计房间数量无限制。
如何创建房间？
房间是由腾讯云后台在客户端进房时自动创建的，您无需手动创建房间，只需调用客户端的相关接口“进入房间”即可：
Windows（C++） > enterRoom
实时音视频的视频服务端最大支持带宽是多少？
没有限制。
实时音视频是否支持私有化部署？
实时音视频私有化部署未完全开放。若您需咨询或使用私有化服务，请联系：colleenyu@tencent.com。
实时音视频开通旁路直播，域名是否需要进行备案使用？
如需开通旁路直播，依据国家相关部门要求，播放域名需要备案才能使用。
实时音视频延时大约多少？
全球端到端平均延时小于300ms。
实时音视频是否支持主动呼叫功能？
实时音视频双人视频通话是否支持蓝牙耳机？
支持。
实时音视频接入 PC 端是否支持屏幕分享功能？
支持，您可以参考如下文档：
是否支持将本地视频文件分享到实时音视频中？
实时音视频能否把直播视频录制后存储在手机本地？
不支持直接存储在手机本地，录制后视频文件默认存储在云点播平台，您可以自行下载并保存到手机中。
实时音视频是否支持单纯的实时音频？
支持纯音频。
一个房间里可以同时有多路屏幕分享吗？
目前一个房间只能有一路辅流的屏幕分享。
指定窗口分享（SourceTypeWindow），当窗口大小变化时，视频流的分辨率会不会也跟着变化？
默认情况下，SDK 内部会自动根据分享的窗口大小进行编码参数的调整。
如需固定分辨率，需调用 setSubStreamEncoderParam 接口设置屏幕分享的编码参数，或在调用 startScreenCapture 时指定对应的编码参数。
TRTC 是否支持1080P？
支持，您可以通过 SDK 的视频编码参数 setVideoEncoderParam 对分辨率进行设置。
TRTC 是否可以自定义采集数据？
TRTC 可以跟互动直播 SDK 通信吗？
不可以。
TRTC 是否可以与移动直播通信？
TRTC 与移动直播后台方案架构不同，所以不支持直接相互通信，仅可从 TRTC 后台旁路推流到 CDN。
TRTC 进房模式 AppScene 有什么区别？
TRTC 支持四种不同的进房模式，其中视频通话（VideoCall）和语音通话（VoiceCall）统称为通话模式，视频互动直播（Live）和语音互动直播（VoiceChatRoom）统称为 直播模式。
通话模式下的 TRTC，支持单个房间最多300人同时在线，支持最多50人同时发言。适合1对1视频通话、300人视频会议、在线问诊、远程面试、视频客服、在线狼人杀等应用场景。
直播模式下的 TRTC，支持单个房间最多10万人同时在线，具备小于300ms的连麦延迟和小于1000ms的观看延迟，以及平滑上下麦切换技术。适用低延时互动直播、十万人互动课堂、视频相亲、在线教育、远程培训、超大型会议等应用场景。
TRTC 是否支持音视频通话免提模式？
支持，免提模式通过设置音频路由实现，Native SDK 通过 setAudioRoute 接口切换。
TRTC 是否支持音量大小提示？
支持，通过 enableAudioVolumeEvaluation 接口启用。
TRTC 是否支持设置镜像画面？
支持，通过 setLocalViewMirror 接口设置本地摄像头预览画面的镜像模式，或通过 setVideoEncoderMirror 接口设置编码器输出的画面镜像模式。
TRTC 是否支持录制通话过程中的音频到本地文件？
支持，通过 startAudioRecording 接口可以将通话过程中的所有音频（包括本地音频，远端音频，BGM 等）录制到一个文件里，目前支持的音频格式有 PCM, WAV, AAC。
TRTC 是否支持音视频互通过程中的视频录制成文件？
TRTC 是否支持类似微信视频通话的悬浮窗、大小画面切换等功能？
此类功能属于 UI 布局逻辑，SDK 并不限制 UI 上的展示处理。在官方 Demo 中提供了画面前后堆叠和九宫格布局模式的示例代码，并且支持悬浮窗、大小画面切换和画面拖动，更多详情请参考 官方 Demo。
TRTC 怎么实现纯音频通话？
TRTC 没有音频和视频通道的区分，只调用 startLocalAudio 不调用 startLocalPreview 时即为纯音频通话模式。
TRTC 纯音频通话怎么实现旁路推流和录制？
6.9以前版本：进房时需要构造
json{\\"Str_uc_params\\":{\\"pure_audio_push_mod\\":1}} 传入 TRTCParams.businessInfo 中，1表示旁路推流 2表示旁路推流+录制。TRTC SDK 6.9及以后版本：在进房时选择场景参数为 TRTCAppSceneAudioCall 或 TRTCAppSceneVoiceChatRoom 即可。
TRTC 房间支不支持踢人、禁止发言、静音？
支持。
如果是简单的信令操作，可以使用 TRTC 的自定义信令接口 sendCustomCmdMsg，开发者自己定义相应的控制信令，收到控制信令的通话方执行对应操作即可。例如，踢人就是定义一个踢人的信令，收到此信令的用户就自行退出房间。
如果是需要实现更完善的操作逻辑，建议开发者通过 即时通信 IM 来实现相关逻辑，将 TRTC 的房间与 IM 群组进行映射，在 IM 群组中收发自定义消息来实现相应的操作。
TRTC 支持拉流播放 RTMP/FLV 流吗？
支持，目前 TRTC SDK 中已打包 TXLivePlayer。如果有更多播放器功能需求，可以直接使用 LiteAVSDK_Professional 版本，包含了全部功能。
实时音视频最多可以支持多少个人同时通话？
通话模式下，单个房间最多支持300人同时在线，最多支持50人同时开启摄像头或麦克风。
直播模式下，单个房间支持10万人以观众身份在线观看，最多支持50人以主播身份开启摄像头或麦克风。
TRTC 怎么实现直播场景类应用？
TRTC 专门针对在线直播场景推出了10万人低延时互动直播解决方案，能保证主播与连麦主播的最低延时到200ms，普通观众的延时在1s以内，并且超强的抗弱网能力适应移动端复杂的网络环境。
具体操作指引请参考 跑通直播模式。
能用 TRTC 发送自定义消息接口实现聊天室、弹幕等功能吗？
TRTC SDK 播放背景音是否支持循环播放？是否支持调整背景音的播放进度？
支持，循环播放可以在完成回调里面重新调用播放，播放进度可以通过 TXAudioEffectManager seekMusicToPosInMS 设置。
说明：
setBGMPosition() 在 v7.3 版本废弃，通过 TXAudioEffectManager seekMusicToPosInMS 替代。
TRTC 有没有房间成员进出房间的监听回调？onUserEnter/onUserExit 是否可以用？
有，TRTC 使用 onRemoteUserEnterRoom/onRemoteUserLeaveRoom 监听房间成员进出房间（有上行音视频权限的用户才会触发）。
说明：
onUserEnter/onUserExit 在 6.8 版本废弃，通过 onRemoteUserEnterRoom/onRemoteUserLeaveRoom 替代。
TRTC 怎么监测断网和重连？
通过以下监听回调监听：
onConnectionLost：SDK 跟服务器的连接断开。
onTryToReconnect：SDK 尝试重新连接到服务器。
onConnectionRecovery：SDK 跟服务器的连接恢复。
TRTC SDK 是否支持断线重连?
SDK 支持用户断线情况下自动重连（若持续30分钟都未重连成功，则自动退房并返回-3301错误码），连接过程中具体的连接状态和处理逻辑如下说明。下图展示了从用户 Userid1 加入频道，到连接中断，再到重新加入房间过程中，收到的监听回调事件：
具体说明：
T1：用户侧发起调用
enterRoom 接口发起进房请求。T2：用户 Userid1 收到
onEnterRoom 回调，Userid2 感知 Userid1 存在延迟，大约300ms后，Userid2 收到 onRemoteUserEnterRoom 回调。T3：Userid1 客户端因网络问题断网，SDK 会尝试重新加入房间。
T4：Userid1 如果连续8秒没有连接上服务端，Userid1 收到
onConnectionLost 断连回调。T5：Userid1 接着隔3秒没有连接上服务端，Userid1 收到
onTryToReconnect 重试回调。T6：Userid1 接着每隔24秒，收到 onTryToReconnect 重试回调。
T7：Userid2 会在收到 Userid1 掉线通知90s后，SDK 判断远端用户 Userid1 掉线，Userid2 收到
onRemoteUserLeaveRoom 回调。T8：如果 Userid1 断连期间任意时刻重连成功，Userid1 收到
onConnectionRecovery 恢复回调。TRTC 有没有首帧渲染回调？能否监听画面开始渲染，声音开始播放？
支持，通过 onFirstVideoFrame/onFirstAudioFrame 可以监听。
TRTC 是否支持视频画面截图功能？
目前在 iOS/Android 端调用 snapshotVideo() 支持本地及远端视频画面截图。
TRTC 接入蓝牙耳机等外设异常？
目前 TRTC 有对主流的蓝牙耳机和外设做兼容，但是还会遇到某些设备上有兼容问题。建议使用官方 Demo 以及QQ音视频通话测试对比下是否都正常。
TRTC 音视频过程中的上下行码率、分辨率、丢包率、音频采样率等信息怎么获取到？
可以通过 SDK 接口 onStatistics() 获取到这些统计信息。
TRTC 播放背景音乐接口 playBGM() 是否支持在线音乐？
目前只支持本地音乐，可以先下载至本地再调用 playBGM() 播放。
TRTC 是否支持设置本地采集音量？是否支持设置每个远端用户的播放音量？
支持，通过 setAudioCaptureVolume() 接口可以设置 SDK 的采集音量，通过 setRemoteAudioVolume() 接口可以设置某个远程用户的播放音量。
stopLocalPreview 和 muteLocalVideo 有什么区别？
stopLocalPreview 是停止本地视频采集，调用该接口后自己本地和远端画面都将是黑屏。
muteLocalVideo 是设置是否向后台发送自己的视频画面，调用该接口后其他用户观看的画面将变成黑屏，自己本地的预览还是能看到画面。
stopLocalAudio 和 muteLocalAudio 的区别是什么？
stopLocalAudio 是关闭本地音频的采集和上行。
muteLocalAudio 并不会停止发送音视频数据，而是会继续发送码率极低的静音包。
TRTC SDK 都支持哪些分辨率？
TRTC SDK 怎么设置上行视频码率、分辨率、帧率？
可以通过 TRTCCloud 的 setVideoEncoderParam() 接口设置 TRTCVideoEncParam 参数中 videoResolution（分辨率）、videoFps（帧率）、videoBitrate（码率）。
SDK 控制画面角度与方向是如何实现的？
怎样实现横屏视频通话？
TRTC 本地和远端画面方向不一致怎么调整？
TRTC 有没有推荐的画面质量（码率、分辨率、帧率）相关参数配置？
TRTC 是否支持对网络测速？如何操作？
TRTC 是否支持对房间进行权限校验，例如会员才能进入的场景？
TRTC 音视频流是否支持通过 CDN 拉流观看？
支持。
TRTC 自定义渲染支持哪些格式？
iOS 端支持 i420、NV12 和 BGRA。
Android 端支持 I420 和 texture2d。
实时音视频是什么？
腾讯实时音视频（Tencent Real-Time Communication，TRTC），将腾讯多年来在网络与音视频技术上的深度积累，以多人音视频通话和低延时互动直播两大场景化方案，通过腾讯云服务向开发者开放，致力于帮助开发者快速搭建低成本、低延时、高品质的音视频互动解决方案，详细说明请参见 产品概述。
实时音视频 Demo 怎么体验？
实时音视频如何快速入门？
实时音视频如何实现云端录制与回放？
TRTC 支不支持美颜?
支持美颜功能。TRTC 提供基于人脸识别技术的 AI 美颜、美妆、微整形、绿幕等各类型多种特效。
Web 端请参见 开启美颜。
客户端 AI 美颜属于增值服务，由 腾讯特效 SDK 收取相关费用。
说明：
只有全功能版支持美颜特效组件，现阶段 iOS 和 Android 平台有这个功能。
是否支持在非大陆地区使用？
TRTC 支持在国外和香港使用。
说明：
提供覆盖全球的高连通、高可靠、强安全的网络连接通道，自研多重最优寻址算法，具有全网调度能力。丰富的高带宽资源储备，全球节点布局，保证国际链路端到端平均时延 < 300ms。
由于国际链路问题，具体使用时也会受地区与实际使用场景等因素影响。
是否支持实时不良画面检测？
关于涉黄、涉政、敏感信息等，会自动进行拦截关闭，不会允许出现在直播间中。
如何查询当前房间所有用户信息？
TRTC 可以接收其它的 RTSP 推流吗？
TRTC 支持双声道编码吗？
支持双声道。
TRTC 推流过程是先封装还是先编码？
TRTC 采集后先进行编码，再进行封装。
TRTC SDK 是 swift 版本吗？
TRTC 目前 Model 层是 OC 版本，UI 层是 Swift 版本。
个人账号可以用 TRTC 吗？
TRTC 支持个人账户使用。
TRTC SDK 支持 IPv6 吗？
支持，建议升级到 10.6 及之上版本，进一步优化了 IPv6 进房速度。
TRTC 包月套餐中的兴趣区域视频编码功能如何使用？
//设置 ROI 参数{"api":"UpdateRoiConfig","params":{"roiConfigArray":[{"stream":1,"x":0,"y":0,"width":100,"height":100,"level":2},{"stream":1,"x":20,"y":200,"width":100,"height":100,"level":2}]}}
字段名 | 说明 |
stream | 流类型：0大流，1小流，2辅流。 |
x,y,w,h | roi 区域坐标点，以编码输出的分辨率为参考。 |
level | [0, 12] , 就是 roi 的强度， 值越大，roi 区域的效果更明显，但非 roi 区域可能会更模糊。 |
是
否
本页内容是否解决了您的问题？