简介

最近更新时间:2025-07-23 16:43:10

我的收藏

概述

腾讯实时音视频(Tencent Real-Time Communication,TRTC),将腾讯超过20年在网络与音视频技术上的深度积累,以多人音视频通话和低延时互动直播两大场景化方案,通过腾讯云服务向开发者开放,致力于帮助开发者快速搭建低成本、低延时、高品质的音视频互动解决方案。
本章节介绍的实时音视频 API 接口均为 API 3.0 接口。
您可以调用 API 对实时音视频进行操作,例如进行房间管理、开启云端录制、查询相关用量等。
实时音视频支持的所有接口信息,请参见 API 概览

术语表

实时音视频 API 接口的常见术语请参见下表:

术语 描述
SDKAppID SDKAppID 是腾讯云后台用来区分不同 TRTC 应用的唯一标识,在 TRTC 控制台创建应用时自动生成。不同 SDKAppID 之间的数据不互通。
UserID UserID(用户标识)用于在一个 TRTC 应用中唯一标识一个用户,由开发者自行指定。
房间 房间是一个音视频空间,同一房间内的用户可以互相接收对方的实时音视频数据。
RoomID RoomID(房间号/房间 ID)是用于在一个 TRTC 应用中唯一标识一个房间。RoomID 区分数字类型(roomId)和字符串类型(strRoomId),注意 strRoomId 和 roomId 不可以混用,“123” 和 123 在 TRTC 后台服务看来并不是同一个房间。
UserSig UserSig(用户签名)是腾讯云设计的一种安全保护签名,用于对一个用户进行登录鉴权认证,确认用户是否真实,阻止恶意攻击者盗用您的云服务使用权。详情请参见 UserSig 相关问题 文档。
推送 推送指用户将本地的音视频数据上传给 TRTC 服务端的操作,对应“推流”。
订阅 订阅指用户向 TRTC 服务端请求拉取指定用户音视频数据的操作,对应“拉流”。
角色 TRTC 支持主播(TRTCRoleAnchor)和观众(TRTCRoleAudience)两种角色,二者区别在于:主播角色既支持向服务端推送自己的音视频数据,也支持从服务端订阅并播放其他主播角色的音视频数据。观众角色仅支持从服务端订阅并播放主播角色的音视频数据。在通话模式下,所有进房用户都是主播角色。在直播模式下,您可以根据实际业务场景将进房用户分为主播和观众两种角色,同一个用户可以随时切换角色。
CDN 直播观看 CDN 直播观看,又称 “CDN 旁路直播”。TRTC 在云端使用旁路转码集群,将 TRTC 所使用的 UDP 协议转换为标准的直播 RTMP 协议,把 TRTC 的音视频数据推送到标准的云直播系统中,再经由 CDN 进行分发,从而实现 CDN 直播观看。区分详情请参见 实现 CDN 直播观看 文档。
云端录制 自2022年08月01日起新创建的应用(SdkAppId)录制功能类型为新版云端录制,同一个应用只可使用一种录制能力,区分详情请参见 云端录制能力类型 对比。
云端混流转码 在 CDN 直播观看和云端录制等应用场景中,可能需要将 TRTC 房间里的多路音视频流混合成一路,您可以使用 TRTC 云服务后台的 MCU 混流转码集群来完成该项工作。MCU 集群能将多路音视频流进行按需混合,并将最终生成的视频流分发给直播 CDN 和云端录制系统。

API 快速入门

您可以使用 API Explorer 工具在线调用 API。
本文以解散房间为例,通过 API Explorer 工具调用 API 接口的步骤如下:

  1. 进入 API Explorer 工具页面。更多 API Explorer 工具使用信息,请参见 使用 API Explorer
  2. 调用房间管理相关接口-解散房间 DismissRoom,实现解散房间的目的。
  3. 选择 Region: 华南地区(广州)。
  4. 输入您的 SDKAppID。
  5. 输入需要解散的房间 ID(数字房间号)。
  6. 发起调用即可。