diff --git a/docs/FAQ.md b/docs/FAQ.md index 925a1d39..f18f02aa 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -84,6 +84,7 @@ VAD: 10、[如何部署上下文源](./context-provider-integration.md)
11、[如何集成PowerMem智能记忆](./powermem-integration.md)
12、[如何配置天气插件查询天气](./weather-integration.md)
+13、[如何开启设备呼叫插件](./device-call-guide.md)
### 10、数字人相关教程 1、[数字人digital-human启动方法](./digital-human-wakeword.md)
diff --git a/docs/device-call-guide.md b/docs/device-call-guide.md new file mode 100644 index 00000000..620ea31a --- /dev/null +++ b/docs/device-call-guide.md @@ -0,0 +1,64 @@ +# 设备间相互呼叫插件使用指南 + +## 概述 + +设备呼叫功能允许两个已配置设备之间通过语音/数据通道进行双向通信。设备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: 如何确认通讯录功能已开启? + +- 智控台顶部菜单如显示"通讯录"入口,则表示已开启 +