联犀开发者文档

翻译与旁路处理

约 1295 字大约 4 分钟

2026-10-16

先完成基础教程

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

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

接入点：活动会话的业务交互阶段

翻译与旁路处理器为设计待实现，不把下图写成现成控制台开关。协议设计沿用主体会话：先完成主会话与授权，然后应用 interaction.processorControl(operation=attach) 声明处理目标、说话人与语言方向；processorState 确认处理器状态，translationResult 传字幕和关联信息，译音走单独获授权媒体轨。

请求和事件的字段见应用处理器命令、processorState及translationResult。全部独立 JSON 与语言分支在翻译教程；应用不能靠开启通话就自动取得翻译／模型旁听授权。

{
  "msgToken": "s05-72",
  "method": "interaction.processorControl",
  "sessionId": "s-call",
  "params": {
    "processorId": "translation-1",
    "processor": "translation",
    "operation": "attach",
    "sourceTrackIds": [
      "call-mic",
      "call-peer"
    ],
    "consentIds": [
      "consent-a",
      "consent-b"
    ],
    "targetLanguage": "zh-CN"
  }
}

AI 工具在模型产生调用后接入，附件在提交输入前完成上传；两者不需要新建旁路处理器。对应设备工具、客户端工具、附件准备。

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

业务教程进入位置需要增加／改变的条件与操作预期结果、返回与退出
翻译与旁路处理器阶段5：附加处理器（设计）面对面翻译声明说话人与语言方向；通话附加处理器另取授权处理器失败／移除只结束旁路，不中断仍有效主通话；译文与译音分别关联

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

怎么确认本组接入成功

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

更新日志

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