按键对讲与多人抢麦
约 2549 字大约 9 分钟
2026-10-16
本页包含扩展设计,不能作为当前整场景已实现的承诺。参见支持范围、场景索引和命令手册。图中 M/R 编号只用于篇内定位,不放入实际JSON。
与公共主线的衔接
本页属于 人际通话、会议与门铃基础教程。首次接入先完成 MQTT 基础报文 与 公共主体流程;不要从下面的业务步骤跳过认证、能力或接听。
| 现在做什么 | 本场景的明确要求 |
|---|---|
| 从哪一步进入 | 阶段5:按键及抢麦扩展 |
| 增加/改变什么 | 先核部署是否实现 floorControl 及角色权限;该扩展不能当当前会议默认功能 |
| 发什么、等什么 | 按下方接入操作步骤进入报文索引,逐条核 Topic、method、应答和超时;不要用受理代替完成 |
| 如何确认成功及回到哪里 | 释放话权与关闭采集分开确认;设计流程不得假冒已联调 |
| 失败/退出 | 按异常与释放收紧本端;终态不复活,不能影响其他仍合法会话 |
| 字段与全部JSON | 下方逐方法契约;本场景完整报文序列 |
用途与操作流程
本场景主要为扩展设计或基础组件;不作为当前完整可运行产品。其余子项仍须按支持范围确认。 平台配置者负责模型、产品和授权,应用负责用户意图与确认,设备负责真实能力、驱动执行和状态回报;完整实现边界见支持范围。没有对应界面的步骤由已鉴权 API 或设备程序完成。
接入操作步骤
| 步骤 | 操作与预期结果 | 详细定位 |
|---|---|---|
| 1 | 本场景为扩展;确认 humanCall 与 exclusive 抢麦策略及成员权限 | 前置条件 |
| 2 | 建立通话后按键申请发言权,不套用 AI 全双工模式 | 时序与逐消息契约 |
| 3 | 获得有效租约才上行;未获租约不得转发麦克风 | 时序与逐消息契约 |
| 4 | 观察 floorState 和实际转发;主持操作仍受权限检查 | 媒体与本地动作 |
| 5 | 松键、离线、移出或租约到期均释放发言权并停上行 | 异常与资源释放 |
前置条件
humanCall会话已按能力与会话/人与人音视频建立,callPolicy.floor=exclusive;设备或应用都能做参与端,主持人权限由平台验证。
松键、离线、租约到期及移出成员都释放发言权;最后一个有效上行帧之后的旧租约媒体不转发。leaseId不进入RTP/UDP包,由会话腿和媒体授权绑定。fullDuplex AI模式与PTT抢麦无关。
D/D2是不同设备参与端,A是应用端,P是平台和媒体节点。各端分别使用鉴权Topic/登录态,不能冒用另一端身份。基础会话与媒体协商见能力与会话/人与人音视频,复用时保留本场景sessionId并独立分配密钥和token。
完整时序
本图包含公共建连和专属分支;按上方操作步骤进入业务,逐报文对接时展开查阅。
展开完整协议时序与异常分支
报文索引
编号按图阅读;编号保留历史引用,不要求数值连续。字段定义以命令链接为准。
| 编号 | 发送→接收 | Topic/接口 | 方法及契约 | 应答/等待 | 状态或作用 |
|---|---|---|---|---|---|
| M01 | D→P | SIG↑ | floorControl | floorState;10秒受理,媒体协商15秒 | |
| M02 | P→D | SIG↓ | floorState | 应答/状态事件;不等待ACK | |
| M03 | D2→P | SIG↑ | floorControl | floorState;10秒受理,媒体协商15秒 | |
| M04 | P→D2 | SIG↓ | floorState | 应答/状态事件;不等待ACK | |
| M05 | D→P | SIG↑ | floorControl | floorState;10秒受理,媒体协商15秒 | |
| M06 | P→D | SIG↓ | floorState | 应答/状态事件;不等待ACK | |
| M07 | D→P | SIG↑ | floorControl | floorState;10秒受理,媒体协商15秒 | |
| M08 | P→D | SIG↓ | floorState | 应答/状态事件;不等待ACK | |
| M09 | P→D | SIG↓ | floorState | 应答/状态事件;不等待ACK | |
| M10 | D→P | SIG↑ | sessionEnd | 对应应答见命令;10秒受理,媒体协商15秒 | |
| M11 | P→D | SIG↓ | sessionEnded | 应答/状态事件;不等待ACK |
关键报文
完整报文序列包含本图所有编号消息。下列仅突出关键操作;字段条件和错误码按报文索引中的命令链接查阅,不把扩展例当成已启用能力。
floorControl
{
"msgToken": "s12-1",
"method": "floorControl",
"sessionId": "s12-session",
"params": {
"operation": "acquire",
"expectedRevision": 0,
"floorId": "room-a",
"leaseMs": 5000
}
}floorState
{
"msgToken": "s12-1",
"method": "floorState",
"sessionId": "s12-session",
"data": {
"state": "granted",
"revision": 1,
"floorId": "room-a",
"leaseId": "lease-a",
"holderId": "member-a",
"expiresAt": 1900000000000
},
"code": 200
}媒体与本地动作
| 编号 | 路径 | 格式与约束 |
|---|---|---|
| R01 | D→P | 授权WebRTC Opus上行;播放别人的音轨不授予上行权 |
| R02 | D→D | 设备本地计时停采集;云端租约同时撤销转发 |
异常、状态与资源释放
路由与信封见公共约定;阶段性状态不代表最终完成。操作终态时限见命令手册;编号、超时等元信息不发送。
能力不足422、无权限403、资源/修订号冲突409、超时504按共通失败与恢复处理,不静默开启设备能力。同token只重放原结果;事件按eventSeq去重,旧会话/端代次不可恢复。验证本页正常路径、alt分支及支持范围断言。文档通过不代表代码或硬件已实现。
验证入口
更新日志
2026/10/17 03:27
查看所有更新日志
d04e1-docs(AI与音视频): 按公共主线与场景分支整合接入手册于
