Room 开发文档

Room 是探鸽平台面向 IoT 设备提供的多人实时语音房间能力。业务服务端为设备申请短效入房凭证，设备端调用 TiRTC TiRtcWhipConnect 接口后加入指定房间；探鸽平台负责鉴权、房间会话管理、音频转发与一路下行音频。

你可以完成什么

• 让对讲机、陪伴设备、会议终端、巡检设备等硬件加入多人语音房间。
• 让设备端只处理一路下行音频，降低多人语音场景下的播放和解码复杂度。
• 使用 TiRTC 命令通道同步成员列表、入房、离房和房间关闭等事件。

接入路径

如果你是第一次接入，建议按下面顺序阅读：

1. 总体流程：了解业务服务端、设备端和探鸽平台之间的完整交互链路。
2. 服务端集成：为设备申请 peer_id 和 token。
3. 设备端集成：调用 TiRTC TiRtcWhipConnect，完成建连、媒体收发和命令通道处理。
4. 服务端接口：查看业务服务端申请 peer_id 和 token 的接口。
5. 房间信令：实现 JSON-RPC 2.0 房间信令。

角色分工

角色	负责内容
业务服务端	持有应用密钥，校验业务权限，为设备申请入房凭证，并通过安全通道下发给设备。
设备端	使用短效凭证建立 TiRTC 连接，收发音频和房间信令。
探鸽平台	校验连接凭证，管理房间会话，处理音频上行、一路下行音频和房间事件分发。

接入前准备

• 已创建探鸽平台应用，并获取服务端调用所需的应用标识和密钥。
• 设备端已集成 TiRTC SDK，并能够调用 TiRTC TiRtcWhipConnect、发送音频帧和收发命令。
• 已确定业务侧 room_id 与设备 device_id 的生成规则。
• 已确认业务服务端具备设备入房权限校验和短效凭证下发能力。