设备连接服务
业务服务端先向设备下发 peer_id 和连接 Token,设备再调用 TiRTC SDK 建连。
连接参数的生成方法见业务服务端签发连接参数。
1. 设备调用 SDK
c
int TiRtcWhipConnect(const char *service_desc,
const char *token,
TIRTCCONNECTCALLBACK cb,
void *user_data);service_desc 传入完整 peer_id。Token 只交付给指定设备,并可在有效期内重复用于建连。设备后续发送 DELETE <Location> 时不携带 Token。
SDK 会向 TiRTC 请求目标 Region 的服务连接信息,再向 WHIP Service 发送 SDP Offer。连接发现、路由和单次请求保护由 TiRTC SDK 与平台自动完成;连接成功后,设备通过 TiRTC SDK 收发音视频、命令和消息。
2. 断开与重连
连接断开后,通过 TIRTCCONNECTCALLBACK 通知设备。需要恢复时,使用同一 peer_id 和仍在有效期内的委托 Token 再次调用 TiRtcWhipConnect。Token 过期、被撤销或绑定范围变化后,设备才需要向业务服务端获取新 Token。
设备不能从公钥生成 Token,也不得保存客户的 Ed25519 签发私钥。
服务端不能依赖设备一定会发送 DELETE。无论断开由哪一方发起,WHIP Service 都必须响应连接断开事件并回收资源。
联调
使用 tirn_probe_device 可以验证建连和 Echo 音视频链路。命令示例见运行快速开始示例。