mirror of
https://github.com/xinnan-tech/xiaozhi-esp32-server.git
synced 2026-07-22 15:13:55 +08:00
65 lines
2.2 KiB
Markdown
65 lines
2.2 KiB
Markdown
# 设备间相互呼叫插件使用指南
|
||
|
||
## 概述
|
||
|
||
设备呼叫功能允许两个已配置设备之间通过语音/数据通道进行双向通信。设备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](https://github.com/78/xiaozhi-esp32/pull/1244/changes)
|
||
2. 按照 [固件编译烧录指南](firmware-build.md) 完成固件烧录
|
||
|
||
### 第四步：配置MQTT网关服务
|
||
|
||
1. 部署MQTT网关服务，参考 [MQTT网关集成文档](mqtt-gateway-integration.md)
|
||
2. 如果已经部署请确认代码的版本是2026年5月27日的版本
|
||
|
||
## 呼叫流程说明
|
||
|
||
准备两个设备，在智控台上面配置好通讯权限之后，在其中一个小智对话那里对他说：”呼叫XXX“,观察设备B是否响应。
|
||
|
||
## 常见问题
|
||
|
||
### Q: 设备B没有响应呼叫？
|
||
|
||
- 检查设备B是否在线（智控台设备状态）
|
||
- 确认设备B的固件已正确集成远程唤醒工具
|
||
- 检查MQTT网关连接是否正常
|
||
- 验证双向权限配置是否完整
|
||
|
||
### Q: 提示"无呼叫权限"？
|
||
|
||
- 在智控台确认设备A已勾选设备B的呼叫权限
|
||
- 确认配置已保存（非仅修改未保存）
|
||
|
||
### Q: 如何确认通讯录功能已开启？
|
||
|
||
- 智控台顶部菜单如显示"通讯录"入口，则表示已开启
|
||
|