从桌宠到右下角
前阵子刷到一些把 Live2D 放进桌面端和网页的演示,角色待在屏幕一角,会眨眼,会跟着鼠标转头。我想起很早以前玩过的 QQ 宠物,还有那个虚拟桌宠模拟器,一只小东西就蹲在桌面上,你不理它,它自己也在动。念头来得没什么道理,我也想给自己的网站弄一只。
真动手才知道,让一张图站在右下角,和让它能被拖着甩裙摆,是两件事。前一件是工程,后一件得跟一只建模时就少了几根骨头的模型较劲。这篇从头写,中间卡在哪、怎么绕过去的,都留着。

先把文件摆好
角色资源全部自托管,放在仓库的 assets/live2d 目录下。三个脚本各有分工:PixiJS 管渲染和时钟,live2dcubismcore 是官方网页运行时,cubism4 这一层把运行时模型包成 Pixi 的显示对象。模型目录里只有一份网格、一张贴图、一份描述文件和一份物理配置。
assets/live2d/
├── pixi.min.js
├── live2dcubismcore.min.js
├── cubism4.min.js
├── ump45-icon.webp
└── ump45-v1/
├── *.model3.json 模型描述
├── *.moc3 网格
├── texture_00.webp 贴图
└── *.physics3.json 物理
assets/audio/ump45/*.mp3
三个脚本有先后依赖,后一个要用前一个挂到全局的对象,只能排队插入。装载函数把延迟对象存下来,切视图再调用时直接复用,避免重复往页面里塞同一批脚本。运行时自己没有时钟,注册之后 Pixi 的时钟才会按帧驱动模型,这一行省不得。
function loadScript(src) {
return new Promise(function (res, rej) {
var s = document.createElement("script");
s.async = false; // 插入顺序就是执行顺序
s.src = src; s.onload = res;
s.onerror = function () { rej(new Error("加载失败: " + src)); };
document.head.appendChild(s);
});
}
function ensureEngine() {
if (enginePromise) return enginePromise;
enginePromise = loadScript(BASE + "pixi.min.js")
.then(function () { return loadScript(BASE + "live2dcubismcore.min.js"); })
.then(function () { return loadScript(BASE + "cubism4.min.js"); })
.then(function () {
window.PIXI.live2d.Live2DModel.registerTicker(window.PIXI.Ticker);
});
return enginePromise;
}
入口处先挡一道设备判断。宽度不足一千零二十四像素,或者指针不精确,函数直接返回,脚本不注入,模型不请求。窄屏和触屏设备连一个字节都不下载。外链也能加载,仓库更小,但多一个域名就多一次连接和一处失效点,自托管换来的是确定的加载时序。
if (mq("(max-width: 1024px)").matches ||
mq("(hover: none), (pointer: coarse)").matches) return;
裁掉画布那一圈透明
模型画布比人大一圈,靴子还画到下沿之外。通透的部分也占着画布,直接贴上去,角色四周就是一大片空白,圆钮悬在半空。要量的是人不透明的那块区域:横向从一百六十五点三到一千五百九十四点六,纵向从一千零五十点七到四千一百六十五点四。

早先那版在每台设备上读像素、量盒子、写进本地存储。读不到像素的浏览器、留着旧值的缓存、纵坐标量成零的情况都出现过,结果是头顶空出一大截,或者靴底被切掉一层。现在把量好的数写成常量,不再量,也不再读缓存,历次用过的缓存键在启动时清掉。谁打开都是同一个位置。
var BODY_BOX = { x: 165.3, y: 1050.7, w: 1429.3, h: 3114.7 };
var FULL_H = 476, HALF_K = .67, pad = 8;
function fit() {
var cap = Math.max(300, Math.round(window.innerHeight * .62));
var fullH = Math.round(Math.min(FULL_H * zoom, cap));
var k = (fullH - pad) / box.h; // 高度扣 8px 给靴底
var w = Math.round(box.w * k);
app.renderer.resize(w, fullH);
model.anchor.set(0, 0);
model.scale.set(k);
model.position.set(-box.x * k, -box.y * k + pad / 2);
stage.style.height = (view === "full" ? fullH
: Math.round(fullH * HALF_K)) + "px"; // 半身只改容器高度
}
那八像素是给靴子的。包围盒下沿正好贴着画布最后一行,按满高铺上去,描边会被削掉一层;高度扣八,模型下移四,靴底才完整。半身只改容器高度,画布和模型保持原样,切回全身不重新加载。渐变遮罩试过,裙边会发灰,改成容器直接裁切。
这个视频两分钟,讲博客场景里文件怎么摆、脚本按什么顺序引,可以和上面两节对照。展示的目录比本站简单,胜在把依赖关系摆在明面上。
让它呼吸,再接上手脚
适配层自带的交互要关掉。它和用户写的参数会抢同几个通道,眼睛出现一帧睁一帧闭。关掉之后,所有参数只由本站的帧函数写。参数索引只在模型载入时取一次,之后按序号写值;每帧用字符串查索引会多出几千次哈希查找,开销直接计进每帧耗时。
function setP(id, v) {
if (P[id] !== undefined) core.setParameterValueByIndex(P[id], v);
}
function buildP(coreModel) {
["PARAM_ANGLE_X", "PARAM_ANGLE_Y", "PARAM_ANGLE_Z",
"PARAM_EYE_BALL_X", "PARAM_EYE_BALL_Y", "PARAM_BREATH"
].forEach(function (id) {
var i = coreModel.getParameterIndex(id);
if (i >= 0) P[id] = i;
});
}
头发、围巾、挂绳的参数不收进这张表,交给物理配置自己摆。每帧只做四件事:把常驻参数写回默认值,写呼吸与视线,处理眨眼计时,再叠加表情和动作。常驻参数不归零,上一轮的表情会留在脸上。眨眼间隔两点四到五点六秒,闭眼零点一六秒,偶尔连眨两下。
function tick() {
var delta = Math.min(app.ticker.deltaMS / 16.67, 3);
var dt = delta / 60;
t += dt;
Object.keys(FACE_DEFAULTS).forEach(function (k) { setP(k, FACE_DEFAULTS[k]); });
setP("PARAM_BREATH", (Math.sin(t * 1.5) + 1) * .5);
setP("PARAM_ANGLE_X", mx * 20);
setP("PARAM_ANGLE_Y", my * 12);
setP("PARAM_EYE_BALL_X", mx * .8);
// 眨眼:开→合→开 0.16 秒
if (blinkT < 0 && t > nextBlink) blinkT = 0;
if (blinkT >= 0) {
var ev = blinkT < .08 ? 1 - blinkT / .08
: blinkT < .16 ? (blinkT - .08) / .08 : 1;
setP("PARAM_EYE_L_OPEN", ev);
setP("PARAM_EYE_R_OPEN", ev);
if (blinkT > .16) { blinkT = -1; nextBlink = t + 2.4 + Math.random() * 3.2; }
blinkT += dt;
}
}
事件层单独铺。容器固定在右下角,自身不接鼠标事件;接事件的是叠在画布上的透明层,以及气泡、轮盘和圆钮。角色四周那一圈透明的地方,点下去仍旧落到正文上。三个圆钮平时透明,鼠标进入角色外扩八十像素的范围才浮出。轮盘分两层,主盘六格:动作、说话、问答、用法、更多、收起;更多盘八格:推荐一篇、全身、半身、音量、静音、放大、缩小、回顶。
点角色只出声不出字。字幕会盖住模型下半张脸,也和原声重复。少前百科的三十一段语音压成六十四码率单声道,放在语音目录;正文配二十七句,点一下随机抽一句,抽到同一句重抽。浏览器要求声音由用户手势触发,点击角色和点轮盘都满足。问答走函数:问句发到站内函数,读数据库里的文章,按汉字二元组打分,取前四篇各截一千六百字拼进提示词。同一地址每分钟十二次。音量默认零点五五,和静音开关一起存进本地。
这个视频走官方原生接口,能把模型文件、画布和参数三者的关系看清楚。本站多包了一层适配层,底下的东西相同。
拖动为什么是直挺挺的
到这里,角色会呼吸、会眨眼、会转头、点一下说话。第一轮拖动是直接改容器的位置,鼠标到哪它到哪,整个人平移过去,像拖一张贴在屏幕上的贴纸。能用,但没有分量。手一停,它也停,身上的头发和围巾照旧按物理慢慢摆,身体本身没有一点被带动的意思。
要让拖动有反馈,得先想清楚拖一只活物是什么手感。抓住一只猫的后颈拎起来,它不会保持站姿平移,头会往上仰,四肢往下坠,身子扭成一个角度。松手之后还要晃几下才站稳。这里有两个东西:一个是身体各部位的相对姿态,一个是回弹。Live2D 模型没有骨骼,姿态靠写角度参数,回弹靠弹簧。
var pull = { x: 0, y: 0, vx: 0, vy: 0, tx: 0, ty: 0, lift: 0, tlift: 0 };
// onMove 里按本次位移/间隔算指针速度 sx/sy
pull.tx = Math.max(-1, Math.min(1, -sx * .9)); // 右拽→左倒
pull.ty = Math.max(-1, Math.min(1, -sy * .75)); // 上拖→后仰
pull.tlift = Math.max(0, Math.min(1, -sy * .8)); // 只认上拎
// tick 里二阶弹簧追目标,松手目标归零,带一点回弹
pull.vx += (pull.tx - pull.x) * .34 * sdt;
pull.vx *= Math.pow(.86, sdt);
pull.x += pull.vx * sdt;
写进参数时,头的三个轴和身体的三个轴一起动,眼球跟着补一点反向位移,抬起来的时候眉毛上扬、嘴微张、呼吸频率抬上去。头发围巾挂绳不写死,physics3 听到这几个角度会自己甩。这一版上线后,拖动总算像在拎一个东西,而不是挪一张图。可下半身还是硬的,拽得再快,裙子和腿都钉在原位。
想做一块能拎起来的软布
顺着这个念头往下走,最直接的方案是把整只角色画进一张纹理,纹理贴到细分网格上,每个交点当成独立质点。抓住的那个点钉死,其余顶点在弹簧约束和重力下各自下垂,身体会拉伸、弯折、坠下去。这是最接近“拎起一块软东西”的观感,布娃娃游戏就是这么做的。

这个方案在本地跑通了。渲染每帧先把模型画进纹理,再把纹理贴到网格,顶点用位置和速度数组逐帧更新,拖住某个点就把它钉在鼠标位置。形变、回正都成立。要真上线,麻烦在后面:UMP45 这只模型是一张画,裙摆和腿脚没有单独的部件,要把它们变成能各自下垂的质点,得回到建模软件里重新拆分网格、重画贴图分区,等于重做一只模型。这只模型的授权和语音都按现状取得,换模型要重新查授权,三十一段语音也跟着作废。为右下角一只小人的拖动效果重做一只模型,账算不过来。
软网格方案留着代码,没有上线。它解决了一个判断问题:技术上做得到,成本上不该做。真正该问的是,一只没有腿部部件的模型,能拿出来的最好效果是什么。
那个 Soullink 的演示里,桌宠会做很连贯的表情和动作。这类 SDK 做的是把情绪、语义映射到 Cubism 已有的参数上,模型本身有哪些通道,它就能写哪些。视频里会摆的裙摆和长发,是那些模型建模时就配好的。它不会给模型补出一条原本不存在的腿。这也是我没去接它的原因。
这只模型能动的到底有几处
把物理配置打开数了一遍,六组:前发、侧发、后发、侧马尾、围巾、绳。每一组是一串质点,输入是头的角度和身体角度,输出到一个专门的参数上,头发和配饰就跟着角度摆。裙摆、腿、脚,一个都没有。

"PhysicsDictionary": [
{ "Id": "PhysicsSetting1", "Name": "前髪" },
{ "Id": "PhysicsSetting2", "Name": "横髪" },
{ "Id": "PhysicsSetting3", "Name": "後髪" },
{ "Id": "PhysicsSetting4", "Name": "サイドテール" },
{ "Id": "PhysicsSetting5", "Name": "スカーフ" },
{ "Id": "PhysicsSetting6", "Name": "紐" }
]
这不是配置漏了。Live2D 的建模范式做到腰就结束,腿脚是画在贴图上的静态部分。它的物理只处理有自由端的东西——头发、裙角、飘带,一根绳子挂在某处,另一头自由摆动。腿这种连在身体上的刚性部件,本来就不在它的处理范围。要腿脚分节运动,得用骨骼或者三维。
所以换 SDK 没用,它写不出模型没有的通道;换模型代价太大,前面算过账。剩下能做的只有一条:在渲染层把贴图下半部分当网格来甩,用屏幕空间的形变模拟裙摆的惯性。它做不出真正的腿脚分节,但能让“裙摆在动”这件事成立。幅度收着点,用在右下角这么大的小人身上,看不出来是假的。
抽搐是怎么来的
第一版局部网格是把模型画进纹理,贴到十二列十八行的网格上,腰部以上的顶点钉死,腰部以下按行加权摆动。给下摆一个横向速度,越靠下的行权重越大,弹簧再把它拉回原位。思路没错,跑起来一拖就抽搐。

问题出在冲量落在哪一层。那一版在每次鼠标移动事件里给每条摆链的 vel 累加一个冲量,而弹簧的衰减写在每帧的渲染函数里。鼠标一帧能触发好几次移动事件,尤其高刷新率的鼠标,冲量加了好几回,衰减只做了一回。几帧下来 vel 堆到几倍,顶点被推出去又弹回来,来回猛甩,看着就是抽搐。
// 出错的写法:事件里累加冲量
function kickSway(vx) {
for (var i = 0; i < soft.n; i++) {
var w = rowWeight(Math.floor(i / SX));
if (w > 0) soft.vel[i] += vx * SWAY_K; // 每个事件都加
}
}
// 衰减却在每帧只做一次
vx += (rest[a] - pos[a]) * SWAY_SPRING;
vx *= SWAY_DAMP; // 0.90,追不上累加
还有一个连带的问题。旧的行权重是平方曲线,越靠下权重越大,摆动全堆在脚踝那两行,裙子所在的中段几乎不动。看上去是脚在甩,裙子纹丝不动,跟想要的正好相反。幅度还特别大,底行能甩出几十像素,纹理两侧没留够余量,摆快了边缘会露出空白。
把冲量换成追随
重做时改了三处。第一,不再直接吃鼠标速度。鼠标速度是原始信号,一帧来好几个,幅度没有上界。改吃已经平滑限幅的身体侧倾角 pull.x——它本身是弹簧算出来的,范围锁在正负一之间,天然是个稳定的目标。身体往左倒,下摆因为惯性往右甩,方向取反。
var target = -pull.x * (soft.w * .7);
var cap = soft.w * .15; // 位移封顶,甩不出纹理余量
if (target > cap) target = cap;
else if (target < -cap) target = -cap;
// 每行一段阻尼弹簧,追随自己的目标
var goal = target * w;
var v = vel[i] + (goal - off[i]) * SWAY_FOLLOW; // 0.16
v *= SWAY_DAMP; // 0.5
vel[i] = v; off[i] += v;
pos[a] = rest[a] + off[i];

第二,阻尼从零点九提到零点五。原来的弹簧阻尼太低,给一个阶跃会来回振好几下,那点残余的晃也是抽搐感的一部分。阻尼提上来,最多过冲一次就稳住。第三,行权重改成腰线以下一段就升到满,裙摆和腿一起甩,脚不再单独甩最远;位移封顶在纹理宽的百分之十五,再快也甩不出画布。
纹理两侧各加了一块余量给摆动留地方,画布本身左移半个余量抵消,显示窗只露中间原来那部分,外观位置跟加余量之前完全一致。松手不把姿态清零,让弹簧把偏角带回正,留一点回弹的余韵。
做完之后
实测的结果是:快速拖动时,裙摆那一行的稳态位移约四十像素,峰值四十五像素;松手后大约十帧平滑归零;腰线以上的顶点位移始终是零。放大截图看,大衣下摆明显往一侧甩出去,脸、头发、手臂保持原样,没有锯齿、空洞和错位。
开销算得出来。引擎和模型约一点四兆,三十一段语音约九百六十千字节,全量二点四兆,窄屏设备一个字节都不下载。静态目录设一年不可变,改过脚本不换版本号,浏览器照旧读旧的,页面上看不出任何变化。所以每次改完都升版本号、提交、双推,再回根页查一次版本字符串。用法卡底部留一行页面版本号,截图里能直接确认是不是旧缓存。
这套东西做到最后,也没让裙摆变成真正的布料。它没有独立的腿,甩起来是一整段贴图在动,转到大角度会穿帮。可它待在右下角,被拖一下会晃,松手会慢慢站正。把角色拖到屏幕下边,手松开,那截衣摆自己摆回原位,停住了。跟早先那只蹲在桌面上的小东西,好像也没差那么多。
参考
- PixiJS 官网 · 渲染库官网,画布、时钟、分辨率配置的出处
- pixi-live2d-display(GitHub) · 模型加载、参数索引与时钟注册的适配层
- Live2D Cubism 产品页(Live2D) · 模型格式、动作与物理参数的官方说明
- Cubism SDK 手册(Live2D) · 运行时与模型规范,含 physics3 物理与再分发许可
- Cubism SDK for Web 下载页(Live2D) · 网页端运行时的取得方式
- Pages Functions 文档(Cloudflare) · 问答接口的部署方式与请求上下文
- D1 文档(Cloudflare) · 文章索引与正文读取所用的数据库
- Workers AI 模型列表(Cloudflare) · 问答主用与备用模型的去处
- Web Audio API(MDN) · 音频播放、音量与用户手势限制
- CanvasRenderingContext2D.getImageData(MDN) · 量透明边所用的像素读取接口
- HTTP 缓存(MDN) · 静态目录一年不可变与版本号的关系
- 为各类桌宠接入自然连贯的 Live2D 表情与动作|Soullink Emotion SDK 技术演示(哔哩哔哩) · 视频,情绪到已有参数的映射能力边界