xiaozhi-esp32-server/docs/device-call-guide.md

设备间相互呼叫插件使用指南

概述

设备呼叫功能允许两个已配置设备之间通过语音/数据通道进行双向通信。设备A呼叫设备B时，系统通过以下流程实现：

设备A → 授权校验 → MQTT网关 → 设备B远程唤醒 → 建立连接 → 通话建立

配置步骤

第一步：开启通讯录功能

1. 登录智控台后台
2. 进入 系统功能配置
3. 在左侧功能列表中勾选 通讯录
4. 点击 保存配置 确认

第二步：配置设备间呼叫权限

1. 在智控台顶部菜单点击 通讯录
2. 在左侧智能体下，设备列表中选择你的设备A（支持按 MAC地址 或 备注名 搜索）
3. 在右侧详情面板中，找到目标设备B的称呼设置，例如 "小王"
4. 勾选设备B的 呼叫权限 复选框
5. 点击 保存

双向授权说明： 如需设备A和设备B互相通信，必须在两侧智控台分别配置对方权限。例如：

• 在设备A的配置中勾选设备B → 设备A可与设备B通信
• 在设备B的配置中勾选设备A → 设备B可与设备A通信

第三步：固件端添加远程唤醒工具

1. 在虾哥代码的基础上增加远程唤醒工具MCP：xiaozhi-esp32
2. 按照 固件编译烧录指南 完成固件烧录

第四步：配置MQTT网关服务

1. 部署MQTT网关服务，参考 MQTT网关集成文档
2. 如果已经部署请确认代码的版本是2026年5月27日的版本

呼叫流程说明

准备两个设备，在智控台上面配置好通讯权限之后，在其中一个小智对话那里对他说：”呼叫XXX“,观察设备B是否响应。

常见问题

Q: 设备B没有响应呼叫？

• 检查设备B是否在线（智控台设备状态）
• 确认设备B的固件已正确集成远程唤醒工具
• 检查MQTT网关连接是否正常
• 验证双向权限配置是否完整

Q: 提示"无呼叫权限"？

• 在智控台确认设备A已勾选设备B的呼叫权限
• 确认配置已保存（非仅修改未保存）

Q: 如何确认通讯录功能已开启？

• 智控台顶部菜单如显示"通讯录"入口，则表示已开启