AilyBlockly零基础入门指南

1.  # 概述

小职图形化库是采用新一代AI图形化编程平台AilyBlockly专门针对小职AI产品而开发的。它基于Arduino版本小职SDK（AI语音交互库）二次开发而成。该库适配小职手表、小职机器人搭载ESP32S3芯片的硬件平台，提供丰富而便捷的功能模块，包括手动配网、音量调节、屏幕显示内容（表情、状态、对话内容）设置、屏幕亮度调整、MCP事件注册，以及MCP外设查询与控制等。用户仅需通过拖拽图形化模块，即可轻松实现复杂的小智AI语音对话及外设控制功能。

我们相信，创造的门槛不应高不可攀，别让想法止于想象，小职图形化库，让你彻底告别“从入门到放弃”，你的第一个语音AI交互项目，今天就能轻松开启！

2.  # 创建第一个AI图形化项目

1.  ## AilyBlockly软件下载

下载地址：https://arduino.me/a/3093

将软件安装好，并打开软件。

2.  ## 创建第一个项目
    
    1.  选择新建项目

![](/media/202604/c4829f3a2b41405f9d25a1caa35d25f01330.png)

2.  选择AI-VOX开发板

![](/media/202604/e6db8eeeb8e34668b6b917ddb87c72e77185.png)

3.  选择项目路径，版本号选择3.2.1
![](/media/202604/a2117ad2563a4ace8dd775622b5abdd41395.png)

项目创建完成

![](/media/202604/e46b32de01324782994e26c8134fcc997664.png)

##   2.3 配置选择

小职图形化库项目要求硬件Flash大小(闪存大小)为16M，PSRAM为OPI PSARM，分区表(Partition Scheme)选择Custom，软件选择如下：

![](/media/202604/180c3a823c664f73be726516dd0efe2f5736.png)
![](/media/202604/7113a5531a674069b11b3fc7033392004059.png)

以上配置都选好了，最后将小职的硬件通过Type-C转USB数据线连接好电脑，按下小职的电源键，点击选择对应的端口，如下图，就可以愉快的体验AI编程。

![](/media/202604/83d2137f9789400eb56d77ebfff6437b8796.png)

3.  # 图形化块介绍

选择工具栏的AI-VOX3菜单，就会显示AI交互所需要块，块分为五类，分别为控制、初始化、事件、MCP、自定义；

**控制：**基本的AI-VOX硬件的控制，包含音量、显示屏亮度、显示屏内容显示等常用块；

**初始化：**常用的网络、音频、显示的初始化；

**事件：**AI大模型返回来的事件，包含激活信息、表情、聊天信息；

**MCP：**MCP外设注册和对外设的控制；

**自定义：对**OTA、WebSocket服务器的自定义；

接下来将一一讲解每个块的功能

![](/media/202604/2feeb1ae7b4448c092eb0f99054f2b113580.png)

4.  # 示例文件

[【附件】AI语音对话.zip](/media/attachment/2026/04/AI%E8%AF%AD%E9%9F%B3%E5%AF%B9%E8%AF%9D.zip)
[【附件】语音控制电机.zip](/media/attachment/2026/04/%E8%AF%AD%E9%9F%B3%E6%8E%A7%E5%88%B6%E7%94%B5%E6%9C%BA.zip)
[【附件】语音获取DHT11温湿度传感器值.zip](/media/attachment/2026/04/%E8%AF%AD%E9%9F%B3%E8%8E%B7%E5%8F%96DHT11%E6%B8%A9%E6%B9%BF%E5%BA%A6%E4%BC%A0%E6%84%9F%E5%99%A8%E5%80%BC.zip)
[【附件】AI语音控制舵机.zip](/media/attachment/2026/04/AI%E8%AF%AD%E9%9F%B3%E6%8E%A7%E5%88%B6%E8%88%B5%E6%9C%BA.zip)
[【附件】AI语音控制WS2812灯带.zip](/media/attachment/2026/04/AI%E8%AF%AD%E9%9F%B3%E6%8E%A7%E5%88%B6WS2812%E7%81%AF%E5%B8%A6.zip)
[【附件】AI语音控制LED.zip](/media/attachment/2026/04/AI%E8%AF%AD%E9%9F%B3%E6%8E%A7%E5%88%B6LED.zip)