联犀开发者文档

接续与恢复

约 1381 字大约 5 分钟

2026-10-16

先完成基础教程

先读 六阶段公共主线，再完成 MQTT 认证与基础报文。音频设备选 MQTT＋UDP；视频、人际通话与 IPC 选 MQTT＋WebRTC。不同媒体选择不改变接听和授权的业务规则；文字／异步分支不创建实时媒体。

按这条路径操作：①确认支持范围和当前配置；②按传输教程完成能力、创建或邀请、媒体连通；③进入下表指定步骤；④按分支观察实际业务效果；⑤分支结束返回原会话，整个会话结束则本地停机并 sessionEnd/sessionEnded。创建、接听、媒体与结束的具体报文以 完整基础流程与逐报文 和 会话契约 为准。不要把 HTTP 202、requestAck 或 sessionCreated 当成业务已完成。

基础操作：先保留有效端，再交接或恢复

首次建连按能力与会话做；本组不要求普通设备先实现接续。接续端、资源焦点和恢复组合分别声明能力，不能凭同账号或支持 WebRTC 推断可换端。以下交接概览只对应跨端接续的已启用子集；完整 Human 资源接续仍在实施的部分保留围栏，不按已完成路径执行。

上图的 endpointControl/endpointState 字段、ready 与 commit 边界见接续命令；所有箭头逐条 JSON 见接续完整序列。不能用准备成功或逻辑 ended 代替整组实际资源释放。

{
  "msgToken": "s18-62",
  "method": "endpointControl",
  "sessionId": "s18-session",
  "params": {
    "operation": "prepare",
    "expectedRevision": 0,
    "handoffId": "handoff-1",
    "target": {
      "kind": "endpoint",
      "id": "tablet-a"
    }
  }
}

短断网不重新发送已消费语音；先取当前状态快照，核有效期、当前物理连接和媒体代次。仍有效才按允许路径恢复；已经 ended 就新建会话。用户主动停止麦克风／摄像头的意图优先，快照不能自动打开它们。

分支从哪里进入、怎样回到主线

业务教程进入位置需要增加／改变的条件与操作预期结果、返回与退出
能力与会话阶段1～4：首次接入认证后声明能力；设备创建与平台邀请分别走创建／接听路径收到 sessionEstablished 后进入目标业务；拒接不启动采集
跨端接续与资源抢占恢复阶段5：已有活动会话目标端独立确认，prepare/ready/commit/abort；新端媒体未就绪前保留原端提交后撤销旧端授权并停旧媒体；失败／超时 abort 保留仍合法原端
后台休眠弱网与状态同步阶段4或5：弱网／后台返回核连接代次、水位和真实媒体状态，sessionSync／重协商按实际能力启用有效快照不重播输入；用户停止的采集不自动恢复
共通失败与恢复任一步：失败／超时分请求未知、单回复失败和会话不可恢复，不把未知当成功本地先收紧；终态清理；重建用新会话及媒体密钥

每个链接内都有专属操作图、完整协议时序、关键 JSON、字段链接、失败与资源释放；不是“与前面类似”的省略步骤。实现状态须以 能力范围 及分支前置条件为准，设计待实现能力不因列入本教程而启用。

怎么确认本组接入成功

依次核对实际鉴权、能力交集、会话／邀请结果和媒体事实，再核分支的识别／实际执行／真实解码／产物状态。最后退出，确认本端已停止采集、播放或订阅，且其他仍授权会话不受影响。失败按 共通失败与恢复 处理，不伪造完成，也不重新执行结果未知的写动作。字段只在 协议参考 维护；逐条请求和应答在 完整报文示例。

更新日志

2026/10/17 03:27
查看所有更新日志
  • d04e1-docs(AI与音视频): 按公共主线与场景分支整合接入手册于