什么是 Room
Room 是探鸽平台面向多人实时语音场景提供的房间能力。接入方只需要围绕业务房间生成 room_id,由业务服务端为设备申请短效凭证,再让设备端调用 TiRTC TiRtcWhipConnect 接口加入房间。房间创建、连接鉴权、音频处理和成员事件同步由探鸽平台完成。
面向谁
Room 文档主要面向两类接入者:
| 接入方 | 关注内容 |
|---|---|
| 业务服务端开发者 | 如何校验入房权限、申请短效凭证,并把凭证安全下发给设备。 |
| 设备端开发者 | 如何使用 TiRTC TiRtcWhipConnect 接口建立连接、收发音频,并处理房间信令。 |
适用场景
- 多人语音对讲:多个硬件终端加入同一房间,实时收听其他成员声音。
- 设备协同沟通:订单、巡检、看护、协作等业务场景按
room_id组织参与者。 - 低复杂度多人音频:设备端接收一路下行音频,减少多路音频管理和播放复杂度。
接入特点
- TiRTC 低延迟传输:设备通过 TiRTC 连接能力建立实时音频连接,音频收发和房间信令复用同一条低延迟链路。
- 平台侧音频处理能力:探鸽平台负责多人语音处理和一路音频下行,设备端不需要同时管理多路远端音频。
- 弱硬件友好:算力、内存和音频处理能力有限的设备,也可以通过接收一路下行音频完成多人房间接入。
- 业务接入简单:业务侧使用自己的
room_id组织房间,设备端只使用业务服务端下发的peer_id和token建连,不持有应用密钥。
相关文档
- TiRTC 产品文档:Room 的底层媒体传输基础。
- 名词解释:Room 相关术语定义。