联犀开发者文档

摄像头预览与对讲

约 1454 字大约 5 分钟

2026-10-16

先完成基础教程

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

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

基础操作：先预览，再按独立权限开启对讲

  1. 设备能力上报真实 cameraId、编码和容量；平台配置观看许可、direct／accept、隐私策略。cameraId 是物理源，trackId 是会话轨，sessionId 是会话，不可混用。
  2. 应用提交 interaction.open(purpose=ipcLiveView，指定 cameraId)，平台邀请设备；direct 由设备自动核当前授权与隐私，accept 等用户明确接受。direct 不是跳过设备校验，也不是免鉴权。
  3. 应用与设备各自协商完整 SDP，上报实际连通；sessionEstablished 后只发布／订阅选定视频轨，检查真实解码画面。
  4. 开启对讲另申请 ipcTalk 并关联现有 IM 通话权限，独立建立音频媒体腿；关闭对讲只关音频腿，预览可继续。
  5. 关闭当前观看者只释放其会话和订阅。隐私或观看撤权须停止对应采集／输出及服务端转发，设备失联不能伪报“相机已停”。

所有箭头的接口、消息、应答及失败 JSON 在IPC 完整教程；共同媒体字段见媒体协商。多人观看每人独立授权，不自动授予抢麦或 AI 取帧许可。

{
  "msgToken": "s07-98",
  "method": "interaction.open",
  "params": {
    "purpose": "ipcLiveView",
    "cameraId": "front"
  },
  "target": {
    "productID": "p-demo",
    "deviceName": "device-demo"
  }
}

云台、抓拍、夜视和录像策略走物模型边界；摄像头控制不新建实时信令命令。历史回放是独立播放会话，不能把实时预览的地址直接改成录像地址。

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

业务教程进入位置需要增加／改变的条件与操作预期结果、返回与退出
IPC预览与对讲阶段2～4：预览与对讲cameraId 来自真实能力；direct 授权直连，accept 须设备确认；对讲独立许可多观看者各订阅独立；隐私／撤权停止采集和转发，不只关服务器订阅
摄像头控制与历史播放阶段5：云台／抓拍或新建回放物模型 action/property 控制；历史播放另建 recordPlayback 会话云台连续移动必须 stop；抓拍等实际回执；结束回放不误关其他观看者
人与AI视频阶段5：主动分享给 AI（设计）独立 AI 取帧授权和视觉模型；打开预览不授予模型画面停止分享立即撤销取帧；AI 视频本轮只定义协议，不按可用功能操作

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

怎么确认本组接入成功

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

更新日志

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