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

## 概述

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

```
设备A → 授权校验 → MQTT网关 → 设备B远程唤醒 → 建立连接 → 通话建立
```
## 使用这个功能的前提条件
1. 你必须要有两个设备，每个设备型号必须是`ESP32-S3`，因为只有`ESP32-S3`才支持远程唤醒功能。
2. 你必须使用[全模块部署](Deployment_all.md)本项目，因为你需要`智控台`来管理设备的权限和通信。
3. 你必须安装并配置好`2026年5月27日`以后的[MQTT网关服务](mqtt-gateway-integration.md)，如果你已经部署了MQTT网关服务，请确认代码的版本是`2026年5月27日`之后的版本。

## 配置步骤

### 第一步：开启通讯录功能

1. 确认你的智控台版本是`0.9.4`或以上版本。
2. 登录智控台后台
3. 进入 **系统功能配置**
4. 在左侧功能列表中勾选 **通讯录**
5. 点击 **保存配置** 确认

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

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: 如何确认通讯录功能已开启？

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