打造独一无二的Stack-chan脸:网页Face Editor眼睛嘴巴自定义完全指南

原创2026-10-11 21:31:241,749 阅读
文章标签:嵌入式机器人物联网硬件开发前端开发工具低代码语音

打造独一无二的Stack-chan脸:网页Face Editor眼睛嘴巴自定义完全指南

Stack-chan 是一款由 JavaScript 驱动的 M5Stack 嵌入式超可爱机器人,而它的 Web Face Editor(Shape Face编辑器)让你无需编写代码,就能在浏览器里自由设计机器人的脸:调整眼睛的形状与位置、自定义嘴巴的开合尺寸、挑选表情和配色,几分钟就能打造独一无二的 Stack-chan 脸。

显示可自定义表情的Stack-chan机器人

什么是 Shape Face 编辑器?

Shape Face 编辑器是 Stack-chan Web Tools 提供的一个网页工具,专门用来设计 Stack-chan 的 Shape 型 Face(矢量脸)。与图片头像不同,Shape Face 由眼睛、嘴巴和区域等几何参数描述,生成后能自动跟随表情、眨眼、视线、口型开合和主题色变化,效果非常灵动。

它的工作台布局分为两部分:

  • 左侧预览区:一块 320×240 的仿真屏幕,眼睛和嘴巴都支持直接拖拽定位;
  • 右侧参数面板:按"基本设置、Face 区域、左眼、右眼、嘴巴"分组,提供精确数值输入。

Stack-chan Web Tools首页中的Shape Face Editor入口

打开 Web Tools 首页后,点击 Shape Face Editor(Shape Face编辑器) 卡片即可进入(导航栏同样有入口)。

五步完成一张自定义脸

第一步:设置名称、表情与配色

在右侧"基本设置"卡片中:

参数 说明
名称 给这张脸起个名字(最长 64 字符),保存时会用作文件名
初始表情 支持 8 种:普通、高兴、生气、难过、困倦、困惑、冷、热
主色 / 背景色 用颜色选择器分别设置脸部主色和背景色
口部初始开度 0~1 的滑块,控制嘴巴刚启动时张开多少

第二步:划定 Face 区域

在"Face 区域"中设置脸的左、上、宽、高。坐标以 Face 区域左上角为原点,且整个 Face 区域不能超出 320×240 的屏幕范围,编辑器会自动帮你把数值限制在合法区间内。

第三步:定制眼睛

每只眼睛(左眼/右眼)可以独立调整:

  • 瞳孔形状:circle(圆形)或 roundRect(圆角矩形),一眼就能看出"呆萌"和"灵动"两种风格差异;
  • 位置:X / Y 坐标,也可以直接在预览画布上拖拽;
  • 尺寸:圆形用瞳孔半径(2~40),圆角矩形用宽、高、圆角 R;
  • 眼睑:宽度和高度为只读项,系统会自动保持"恰好盖住瞳孔"的大小,保证眨眼睛时不穿帮。

第四步:定制嘴巴

嘴巴卡片里可以:

  • 勾选/取消 "绘制嘴巴",彻底隐藏嘴巴;
  • 调整 X、Y 位置;
  • 设置四个尺寸参数:张开的宽、闭合的宽、闭合的高、张开的高——这四个值定义了嘴巴从闭合到张开的完整动画范围,口型跟随语音时的效果就是由它们决定的。

第五步:保存与加载

顶部工具栏提供四个快捷操作:

  1. 加载 Shape Face(文件夹图标):打开已有的 .stackchan-face.json 文件继续编辑;
  2. 恢复默认布局(回转图标):一键回到标准脸;
  3. 保存 JSON(下载按钮):把当前脸导出为 .stackchan-face.json 文件;
  4. 在 MOD 中使用:把脸直接送进 Blockly 块编辑器,一步到位。

💡 另外,编辑器每次修改都会自动保存到浏览器草稿(localStorage 中的 stackchan-face-editor-draft-v1),中途关掉页面再回来,上次的进度还在。

把自定义脸装进 MOD

点击"在 MOD 中使用"后,会带着你的脸数据跳转到块编辑器。在右侧 Assets 栏可以看到 Face 已标记为"使用中",Build 后生成代码会自动包含 FaceBase.template 实现和 robot.ui.setFace 调用——你的脸就嵌入到普通 MOD 的资源里(assets/*.stackchan-face.json),不需要专用运行时或专用固件。

嵌入自定义脸后构建的Stack-chan块编辑器界面

在预览区下方的"生成的 Face 实现"折叠面板中,你可以随时查看这张脸对应的生成代码,方便进阶开发者接手改造。

换上不同风格的自定义脸后,Stack-chan 就能以全新的面貌与同伴"模仿互动":

佩戴自定义脸的Stack-chan模仿表情互动的效果

进阶:了解 Face 资产格式

.stackchan-face.json 采用格式标识 tech.stackchan.face(当前版本 1),字段规范有完整文档,机器校验用的 JSON Schema 也在仓库中,方便你手写或批量生成脸:

总结

想做的事 用哪个功能
快速换一种眼睛风格 瞳孔形状切换 circle / roundRect
让嘴巴会"说话" 四个口型尺寸参数
个性化配色 主色 + 背景色
换脸不写代码 "在 MOD 中使用"一键送入块编辑器
备份与分享 保存为 .stackchan-face.json

从打开编辑器到装进 MOD,全程不超过五分钟。现在就去给你的 Stack-chan 设计一张独一无二的脸吧!🎨

登录后查看全文
stack-chan