名词解释

这页统一 TiRTC 文档里几个最常见、也最容易混用的名词。

如果你在不同页面里看到这些词，都以这里的含义为准。

客户端

客户端是主动发起连接、消费远端音视频或承接业务交互的一端。

在当前文档体系里，Android、iOS、Flutter 这类业务应用通常都属于客户端。

设备端

设备端是提供音视频、等待远端连接或承接设备侧能力的一端。

在当前文档体系里，Linux 等嵌入式设备通常都属于设备端。

license

license 是设备端启动时会用到的一种组合表达。

它不是独立于 device_id 和 device_secret_key 之外的第三种凭证。

当前文档里如果出现 license，通常是在指 device_id 和 device_secret_key 的组合，或者是在引用某个 API、CLI、配置项里的原始字段名。

device_id

device_id 是设备自身的稳定标识。

它用于区分是哪一台设备，也常作为设备管理、授权判断和展示层识别的基础字段。

device_secret_key

device_secret_key 是设备级密钥。

它对应这台设备的敏感凭证，需要妥善保密。

除了设备端初始化 SDK 和服务端签名等必要场景外，不应再有其他代码直接接触它，也不要在日志、聊天记录或调试输出中打印它。

remote_id

remote_id 是客户端发起连接时提供的目标标识。

你可以把它理解成“这次要连谁”。

常见场景里，它通常对应某个设备端或远端服务实例。

如果远端设备是一台通过 device_id 和 device_secret_key 启动接入平台的设备，那么 remote_id 通常就是该设备的 device_id。

token

token 是客户端发起一次连接时使用的短时有效凭证。

token 通常由你的业务服务端按约定的签名算法签发。

客户端需要在连接前拿到 token，再配合 remote_id 发起连接。

stream

stream 是同一条连接里一条独立传输的音频、视频或流内消息。

同一个远端可以同时提供多条 stream，例如主视频、子视频、主音频或对讲音频。

stream_id

stream_id 用来标识同一条连接里的某一条 stream。

你可以把它理解成“这条连接里第几路媒体或消息”的编号。

客户端用它声明要播放、订阅、退订或请求关键帧的是哪一条远端音频或视频，设备端也用它标识正在发送、请求或停止的是哪一条流。

stream_id 的取值范围是 0 到 15。在同一条连接里，音频和视频不能共用同一个 stream_id。流内消息也带 stream_id，它关联哪一条媒体流，由你的业务自己约定。

双端只需要事先约定每一条媒体流使用哪个 stream_id；只要编号一致且不冲突，就可以收发。

access_id

access_id 是应用级凭证标识。

它用于标识这次签发或接入属于哪个 TiRTC 应用。

access_id 一般和 secret_key 成对使用。

secret_key

secret_key 是应用级密钥。

它用于服务端签名和鉴权，属于敏感信息，不应下发到客户端。