词汇表

最近更新时间:2019-08-26 14:34:32

APPID

腾讯云账号的 APPID,请在腾讯云控制台的 账号信息 中查看。

应用

应用是由开发者在 实时音视频控制台 创建的服务应用,不同应用下的数据不互通。详细创建应用流程可参阅 开通服务 中创建应用的步骤。

说明:

一个腾讯云账号允许创建多个实时音视频应用。

SDKAPPID

SDKAPPID(应用标识)是腾讯云后台用来区分不同实时音视频应用的唯一标识,在 实时音视频控制台 创建应用时自动生成。不同 SDKAPPID 之间的数据不互通。

UserID

UserID(用户标识)用于在一个实时音视频应用中唯一标识一个用户。

  • 用户标识是用户登录开发者业务系统的帐号在腾讯云上的映射。通常情况下,开发者可直接使用用户名作为 UserID。
  • 长度建议不超过32字节。请使用英文字符、数字或下划线,不能全为数字,大小写不敏感。

UserSig

UserSig(用户签名)用于对一个用户进行登录鉴权认证,确认用户是否真实。用户签名生成方法可参考 生成签名 文档。

房间

房间是一个音视频空间,同一房间内的用户可以互相接收对方的实时音视频。

  • 实时音视频使用房间这个虚拟的概念,用于用户之间的相互隔离。
  • 只有在同一个房间里的用户才可以相互接收音视频。
  • 一个用户同一时间只能在一个房间内。如果要进入另一个房间,必须从前一个房间内退出。
注意:

  • 第一个创建房间的用户即这个房间的所有者,但该用户无法主动解散房间。
  • 所有用户都主动退出房间时,服务端会马上解散房间。
  • 如果单个用户异常掉线,30秒后服务端会将该用户清理出房间;如果所有的用户都异常掉线,30秒后服务端会自动解散这个房间。
  • 当用户要加入的房间不存在时,实时音视频后台会先创建一个房间,然后再把用户加入。

RoomID

实时音视频服务里使用 RoomID(房间号)来唯一标识一个房间。RoomID 是由开发者自行维护和分配的一个 uint32 范围内的数字。

PrivateMapKey

PrivateMapKey(房间票据)是对用户进房间进行权限校验的凭据,相当于进入指定房间(RoomID)的钥匙。通常 PrivateMapKey 用于进房权限保护,实现进房限制,由开发者的业务服务器签发,生成方法参考 进房权限保护 文档。

旁路直播

旁路直播是一种直播方式,通常用于不同协议的音视频系统之间进行数据转发。实时音视频服务端通过旁路直播的方式,将通话房间中的音视频数据以 RTMP 推流的形式,推送至云直播服务,从而实现旁路直播、旁路转推、云端混流以及云端录制等功能。

云直播服务相关词汇

当您需要使用旁路直播或 CDN 转推时,需要使用到 云直播 服务的推流、混流、录制、转码以及分发等服务。

BIZID

BIZID 是云直播服务中用于区分直播应用的标识。在 实时音视频控制台 启用自动旁路直播或是启用旁路直播自动录制后,选择已经创建的应用,单击【帐号信息】,在“直播信息”中可以获取到 BIZID 信息。

流 ID

当您启用了旁路直播、云端录制、云端混流和 CDN 分发等云直播服务时,即需要用到流 ID。实时音视频服务进行旁路推流时的流 ID 计算规则是 [bizid]_[MD5(roomid_userid_streamtype)] ,您可以通过 独立画面 文档了解详细的旁路转推流 ID 的计算规则。

直播流地址

直播流地址分为推流地址与拉流地址,推流地址与拉流地址通过流 ID 进行映射。当您启用了旁路直播、云端录制、云端混流和 CDN 分发等云直播服务时,即需要用到直播流地址。

  • 推流地址是形如 rtmp://yourpushdomain.com/appname/streamname?auth=xxxxx 的格式。
  • 拉流地址根据不同类型,具有不同的格式:
    • RTMP 类型:rtmp://yourpulldomain.com/appname/streamname?auth=xxxxxx
    • HTTP - FLV 类型:http://yourpulldomain.com/appname/streamname.flv?auth=xxxxxx
    • HLS 类型:http://yourpulldomain.com/appname/streamname.m3u8?auth=xxxxxx
注意:

  • 推流地址仅用于上行数据,拉流地址仅用于下行数据。混用可能会造成不可预计的问题。
  • 只有先进行推流,之后才可以拉流播放。
  • 根据相关部门要求,针对中国大陆的推流域名及播放域名需要开发者 自行配置 后方可使用。

云端混流

云端混流是云直播提供的一项混流转码服务,可以将相同 BIZID 下的一路或多路直播流 ID 的数据混合到指定的流 ID 上。使用云端混流,可以实现连麦和跨房 PK 等场景功能,您可以在 云端混流转码 的说明文档中查看介绍,若需要更细节的自定义配置,可以通过 云端混流 RESTAPI 来对混流进行更精细的参数配置。

视频录制

视频录制是云直播提供的一项录制服务,可以将流 ID 的数据录制到 云点播 服务,您可以在 云端视频录制 的说明文档中查看介绍。

TRTC V1 版本专有词汇

以下是针对 TRTC V1 版本专有词汇的说明。您可以通过 旧版本(iLiveSDK)升级方案 文档查看 V1 和 V2 版本的差异以及升级方案。

AccountType

accountType(帐号类型)是在实时音视频 V1 版本中登录实时音视频应用的帐号类型,其在创建实时音视频应用后自动分配,用于用户鉴权功能。V2 版本中不再需要使用。

角色

角色是在实时音视频 V1 版本中,用于管理音视频参数配置(包含分辨率和采集帧率等)的参数集。可以在 实时音视频控制台 中的 画面设定(旧版本 SDK) 下创建并配置角色。V2 版本中不再需要使用。

角色名

实时音视频控制台 中,为集成了实时音视频 V1 版本的指定终端平台创建了角色参数集后,可以给这组参数配置取一个名称,这个名称就是角色名。用户在房间中打开摄像头或麦克风上行音视频流,开始上行数据后,在进房时可以通过角色名指定使用的角色,来确定上行数据的参数。V2 版本中不再需要使用。

注意:

  • 如果进房间时配置的角色名并没有在控制台配置,不会导致进房失败,但会使用默认角色。
  • 进入房间成功后,用户可以通过角色切换接口来切换角色。
  • 使用角色切换接口切换角色时,如果要切换的角色名不存在,会回抛一个失败的回调。
  • 角色配置修改后,客户端需要重新登录才能让配置生效( SDK 会在登录成功后去后台拉取配置,若拉取失败也会导致角色找不到)。

群组

实时音视频 V1 版本中的群组系统,使用了腾讯云 即时通信 IM 服务的 群组 功能。

注意:

群组和房间是两个完全独立的概念,二者之间并没有直接关联。

消息

实时音视频 V1 版本中将一次独立发送和接收的信息称为消息,iLiveSDK 中消息用 ILiveMessage 类来描述,主要有三种类型:文本消息、自定义消息以及其它消息,详情参考 即时通信消息格式