news 2026/6/12 9:03:13

小智AI 如何自定义唤醒词+背景图:原理+流程拆解

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
小智AI 如何自定义唤醒词+背景图:原理+流程拆解

小智AI 从v2.0.x版本开始,支持用户自定义唤醒词+表情包+背景图

实现效果如下:

有朋友好奇:如何实现的?

本文,将尝试拆解这部分的基本原理实现思路

1. 设备端

首先,我们要了解 ESP32 芯片中的数据是如何存储的,已了解的朋友可跳过。

以常见的ESP32s3-N16R8为例,这里的N16R8分别代表啥?

1.1 ESP32中的存储

按照是否在芯片上,存储分两种:

1. 片上存储器(On-chip Memory)

  • 内部ROM(384KB):存储启动代码和关键的系统函数
  • 内部SRAM(512KB):用于运行时变量、堆栈等,访问速度快,断电后数据丢失
  • RTC存储器(16KB):8KB快速存储器,8KB慢速存储器

可以理解为计算机的内存。

2. 片外存储器(Off-chip Memory)

  • Flash存储器:容量通常为8MB或16MB,用于存储程序代码、常量数据和文件系统
  • PSRAM(可选):伪静态随机存储器,用于扩展运行时内存,通过SPI接口连接

可以理解为计算机的硬盘、虚拟内存。

N16R8就代表 16M 的 Flash 和 8M 的 PSRAM。

硬盘空间有限,为了充分利用,有了分区的概念。

1.2 Flash中的分区

ESP32s3的 16M 为例,它的分区表如下:

# Name, Type, SubType, Offset, Size, Flags nvs, data, nvs, 0x9000, 0x4000, otadata, data, ota, 0xd000, 0x2000, phy_init, data, phy, 0xf000, 0x1000, ota_0, app, ota_0, 0x20000, 0x3f0000, ota_1, app, ota_1, , 0x3f0000, assets, data, spiffs, 0x800000, 8M

上表中,Offset代表分区的起点,Size代表分区的大小。

那为啥nvs是从0x9000开始呢?

因为,0x1000-0x9000另有他用:

  • Bootloader(0x1000-0x8000):存储启动引导程序

  • 分区表(0x8000-0x9000):描述Flash中各分区的信息

这些分区分别是干啥呢?

  • NVS分区(0x9000开始,16KB):存储配置参数和键值对数据
  • OTA数据分区(0xd000开始,8KB):存储OTA更新相关的元数据
  • PHY初始化数据(0xf000开始,4KB):存储射频校准数据
  • OTA固件分区(两个,约3.9MB):存储主应用程序代码,支持固件更新和回滚
  • Assets分区(8MB):存储资源文件(图片、音频、字体等)

上述分区,有哪些优势?

  • 充分利用 Flash 的所有空间;
  • ota_0 和 ota_1 交替使用,当前分区处于"活动"状态,另一分区接收新固件;
  • 分区分工明确,OTA固件分区Assets分区独立更新,互不干扰

而用来自定义唤醒词+表情包+背景图的,正是这里的Assets分区

问题来了,Assets分区里放的啥,设备端又如何接收更新呢?

下面来看,服务端要做哪些工作。

2. 服务端

2.1 前端交互页面

前端代码已开源:https://github.com/78/xiaozhi-assets-generator

首先,服务端会读取的设备系统信息:

然后,用户可以自定义的选项如下:

  • 唤醒词:内置 esp32 官方训好的唤醒词
  • 字体
  • 表情
  • 背景图

最后,前端否则把上述文件打包成assets.bin:

这个assets.bin就是塞进Assets分区的文件。

问题来了,放在你浏览器中的assets.bin如何送到设备中去的?

2.2 后端处理逻辑

先看流程图:

具体执行步骤如下:

step 1:前端和后端保持 websocket 长连接,将assets.bin发送到后端服务器,生成一个url

step 2:通过callMcpTool实现工具调用,本质是给后端发 POST 请求。

step 2.1:调用self.assets.set_download_urlurl送给设备端。

云端调用该工具后,设备端会将url保存到设置中。

AddUserOnlyTool("self.assets.set_download_url", "Set the download url for the assets", PropertyList({ Property("url", kPropertyTypeString) }), [](const PropertyList& properties) -> ReturnValue { auto url = properties["url"].value<std::string>(); Settings settings("assets", true); settings.SetString("download_url", url); return true; });

step 2.2:调用self.reboot,设备重启。

step 2.3:设备重启后,根据url下载assets.binAssets分区

自此,设备端更新生效。

问题来了,上述工具调用,不都是 MCPTool 吗?

而要实现tool/call,底层还得通过MQTT,所以前端给后端发了 POST 请求后,后端是给MQTT broker的 topic 发了这条指令,最终这条指令,被设备端执行。

写在最后

本文分享了小智AI: 自定义唤醒词+表情包+背景图的基本原理和实现思路。

篇幅有限,关于MQTT + MCP实现设备远程控制的原理,我们下篇见。

如果对你有帮助,不妨点赞收藏备用。

小智Pro下一版本更新,也将支持设备远程控制,有任何想法,欢迎来聊👇:

https://ai.feishu.cn/wiki/IfTawES0mi0YTqk8GQ4cw4qOnD3

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/10 22:27:26

Excalidraw自然语言处理NLP流程图解

Excalidraw与NLP融合&#xff1a;让“说”出来的想法自动变成流程图 在一次远程架构评审会上&#xff0c;团队正讨论用户认证流程。以往需要一人手动画出十几个节点和连线&#xff0c;耗时又容易遗漏细节。但这次&#xff0c;主讲人只说了一句&#xff1a;“画一个OAuth 2.0授权…

作者头像 李华
网站建设 2026/6/10 14:00:02

AI编程:程序员的职业新方向

AI编程:程序员的职业新方向 关键词:AI编程、程序员职业发展、人工智能、机器学习、深度学习、编程语言、应用场景 摘要:本文深入探讨了AI编程作为程序员职业新方向的相关内容。首先介绍了文章的背景,包括目的、预期读者、文档结构和术语表。接着阐述了AI编程的核心概念、联…

作者头像 李华
网站建设 2026/6/10 14:00:02

微服务分布式事务的测试与数据最终一致性验证

分布式事务测试的独特挑战 在微服务架构下&#xff0c;传统的ACID事务边界被打破&#xff0c;测试工作面临三大核心挑战&#xff1a; 事务链路跨多个服务&#xff1a;一个业务操作可能涉及订单、库存、账户等多个服务的协同&#xff0c;测试用例需要覆盖所有参与服务的交互场景…

作者头像 李华
网站建设 2026/6/12 5:18:26

测试团队的知识管理与传承:构建高效协作的基石

随着软件测试行业的快速发展&#xff0c;测试团队面临着日益复杂的项目需求和知识更新压力。在当前日期2025年12月21日的背景下&#xff0c;技术迭代加速&#xff0c;测试从业者需应对自动化测试、AI工具集成以及敏捷开发等挑战。知识管理与传承不仅关乎团队协作效率&#xff0…

作者头像 李华
网站建设 2026/6/10 14:09:33

jenkins multjob执行子job地址是127.0.0.1如何修改

Jenkins Multijob 子 Job 地址 127.0.0.1 修改方法当 Jenkins Multijob 执行子 Job 时显示地址为 127.0.0.1&#xff0c;通常是因为 Jenkins 系统配置中的 Jenkins URL 未正确设置。这会导致 Jenkins 在生成任务链接、回调地址或重定向时使用默认的本地回环地址。以下是几种常见…

作者头像 李华
网站建设 2026/6/9 20:25:25

高可用Redis Cluster全方位测试策略与实践

1. 测试环境设计与搭建 1.1 环境规划要点 搭建与生产环境高度一致的测试环境是高可用测试的基础。建议采用至少6节点&#xff08;3主3从&#xff09;的集群架构&#xff0c;节点应分布在不同可用区或物理服务器上。网络配置需模拟真实环境&#xff0c;包括适当的网络延迟和带…

作者头像 李华