音视频通话

HTTP 接口负责接听、挂断等通话操作，WebSocket 通知状态变化，TRTC 传输声音和画面。

每个接口独立列出请求参数、返回字段和示例。点击下方接口名称即可查看。

接口列表

接口	方法	路径
发起通话	POST	/app/sdk/calls/create
主叫振铃续约	POST	/app/sdk/calls/pulse
读取指定通话状态	POST	/app/sdk/calls/receive
被叫接听	POST	/app/sdk/calls/accept
被叫拒绝	POST	/app/sdk/calls/decline
主叫确认接听	POST	/app/sdk/calls/confirm
主叫取消	POST	/app/sdk/calls/cancel
获取通话媒体凭证	POST	/app/sdk/calls/credentials
报告媒体已接入	POST	/app/sdk/calls/connected
保持通话在线	POST	/app/sdk/calls/heartbeat
挂断通话	POST	/app/sdk/calls/hangup
检查 TRTC 回调地址	GET	/app/sdk/trtc/room-callback
接收 TRTC 房间事件	POST	/app/sdk/trtc/room-callback

发起通话

当前公开接口发起双人语音或视频通话。主叫振铃期间定时续约。

• 发起通话
• 主叫振铃续约

通话操作

通常按振铃、接听、主叫确认、连接媒体、通话、挂断的顺序处理。所有回包都带最新完整通话状态。

• 读取指定通话状态
• 被叫接听
• 被叫拒绝
• 主叫确认接听
• 主叫取消
• 报告媒体已接入
• 保持通话在线
• 挂断通话

状态与时钟

服务器给出振铃和连接截止时间。使用 control.server_time 校正时间差，按返回的时间处理超时。

• 读取指定通话状态

TRTC 临时凭证

接听确认后，用当前设备的临时凭证进入指定房间，媒体接入成功后再上报。

• 获取通话媒体凭证
• 报告媒体已接入

TRTC 回调

由 TRTC 服务端带签名调用。GET 只检查地址能否访问，POST 才处理房间事件。

• 检查 TRTC 回调地址
• 接收 TRTC 房间事件