联犀开发者文档

人际通话、会议与门铃

约 3878 字大约 13 分钟

2026-10-16

先完成基础教程

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

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

基础操作：一对一接通，再扩展到会议与门铃

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

当前入口边界：以下 humanCall 的 interaction.open 应用适配图为设计，不能当作当前通用 REST 已开放。当前应用接入先按原 IM 的 group_invite/group_join 取得通话成员身份，再用已启用的 ipcTalk 独立媒体腿；完整步骤见当前会议接入。设备侧人际通话、主动呼叫和门铃核心按各分支的实际能力运行，不因本图改变现行 IM 接口。

平台先配置 IM 身份、成员关系、设备归属和通话权限。应用完成端点注册，通过已鉴权命令提交 interaction.open；设备主动发起按设备呼叫分支。应用的 HTTP 202 只表示受理，振铃和接通分别等事件；未接听不得启动对方麦克风。

邀请／接受字段见会话命令，应用应答与状态见应用接口。媒体是双方各自 Peer，不拿一端 SDP 代替另一端。完整步骤与互斥失败报文在通话教程。

{
  "msgToken": "s06-77",
  "method": "sessionAccept",
  "sessionId": "s06-session",
  "params": {
    "acceptedTracks": [
      "mic-1",
      "speaker-1",
      "video-1"
    ]
  }
}

多人会议复用当前 IM 成员、名册和 MAC 音权；各成员独立媒体腿，退出不退群，移除本腿不终止他人，解除禁麦不是远程强开麦。门铃改为同一事件邀请多个端，平台唯一胜者 CAS；落选端就算迟到接受也不能获得媒体许可。专属竞争、免打扰与全拒绝时序见门铃教程。

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

业务教程进入位置需要增加／改变的条件与操作预期结果、返回与退出
人与人音视频阶段2：邀请及会话腿建立沿用 IM 身份、成员和 MAC 权限；人与人来电必须接听各端独立 Peer 与媒体腿；移出会议不退群，解除禁麦不自动开麦
门铃告警与多端接听阶段2～3：门铃多端振铃同一事件去重、免打扰、多端邀请，由平台原子决定唯一接听者落选端和迟到接听终止；胜者实际双向解码，结束释放所有腿
呼叫等待转接与AI转人工阶段2或5：设备主动呼叫／转人工设备主动呼叫核心与其余设计扩展分别看前置条件，不套现成转接按钮切换前核权限及目标就绪；失败不能冒充已接通人工
视频升级摄像头切换与屏幕共享阶段5：视频升级／切相机重新核轨与摄像头授权；仅按当前已启用分支重协商新媒体确认后切换；失败保留仍有效原通话；屏幕共享等设计不假定可用
按键对讲与多人抢麦阶段5：按键及抢麦扩展先核部署是否实现 floorControl 及角色权限；该扩展不能当当前会议默认功能释放话权与关闭采集分开确认；设计流程不得假冒已联调

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

怎么确认本组接入成功

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

更新日志

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