名词解释

为确保你在接入和沟通时拥有清晰的上下文，本文列出了 TiRTC AI 对讲接入过程中常见的专属名词和概念。

基础概念

• TiRTC AI 对讲 探鸽平台基于 TiRTC X 底层技术构建的实时语音交互服务。允许 IoT 设备与云端智能体之间通过单条低延迟连接实现双向音视频、字幕以及控制事件的传输。

• 业务服务端 (Application Server) 由客户自行开发和维护的后端系统。负责终端用户的设备管理、套餐鉴权，并通过探鸽服务端 API 获取设备连接云端所需的凭证。

• 设备端 (Device) 集成了 TiRTC SDK 的 IoT 硬件或终端应用，包括 AI 玩具、智能摄像头、机器人等。它通过网络与探鸽平台建立连接，实现拾音上行和语音下行。

身份与鉴权

• 服务端凭证 (AccessKey/SecretKey) 即 AK/SK，由探鸽平台颁发给客户开发者，仅限保存在业务服务端。用于在调用服务端 API（如申请设备连接 Token）时进行 TGV1-HMAC-SHA256 算法签名，绝对不能下发或硬编码到终端设备中。

• 连接凭证 (peer_id / Token) 业务服务端向探鸽平台申请后获得的短期访问凭证，由 peer_id（连接目标描述符）和 Bearer token 组成。

  • 业务 Token：通常指业务服务端自己颁发给终端用户的登录或授权 Token。
  • TiRTC-X Token（或连接 Token）：指平台返回供设备 TiRtcWhipConnect 专用建连使用的短效加密字符串。

角色与会话

• 智能体 / 角色 (Role) 代表云端执行对话逻辑的 AI 配置。它定义了对话使用的大语言模型提示词（Prompt）、欢迎语、音色、以及可能用到的知识库和动作能力。
• role_id 智能体角色的全局唯一标识符。业务服务端在申请连接凭证时，以及设备端在发起会话（start_session）时均需要使用该 ID。
• session_id 由探鸽平台在 start_session 成功后返回的唯一会话 ID，用于在日志追溯、排障或计费账单中定位特定的交互轮次。

媒体与信令

• WHIP (WebRTC-HTTP Ingestion Protocol) 一种基于 HTTP 的 WebRTC 信令协议。TiRTC AI 对讲使用它作为设备与平台建立底层媒体通道的标准握手协议。

• 命令通道 (Command Channel) 基于底层媒体通道（如 DataChannel）建立的低延迟双向数据通道。AI 对讲过程中的握手、打断、字幕及设备能力调用都在此通道上传输，对应的开发者预留命令字约定为 0x2100。

• VAD (Voice Activity Detection) 语音端点检测。判断当前音频流中是否有人在说话。探鸽云端会运行云端 VAD 以实现更精准的打断和轮次分割，设备端可不必运行本地 VAD，或只执行基本的静音消除（需谨慎防止截断）。