RezeのBlog
← 返回文章列表

从桌宠到右下角

2026.10.10技术8403 字视频 3 · 参考 12

前阵子刷到一些把 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 已有的参数上,模型本身有哪些通道,它就能写哪些。视频里会摆的裙摆和长发,是那些模型建模时就配好的。它不会给模型补出一条原本不存在的腿。这也是我没去接它的原因。

这只模型能动的到底有几处

把物理配置打开数了一遍,六组:前发、侧发、后发、侧马尾、围巾、绳。每一组是一串质点,输入是头的角度和身体角度,输出到一个专门的参数上,头发和配饰就跟着角度摆。裙摆、腿、脚,一个都没有。

模型物理配置的六组会摆,裙摆腿脚没有对应参数
physics3.json 里的六组物理:头发和配饰会摆,裙摆腿脚没有通道
"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];
最终方案:腰上钉死,腰下按行加权追随,位移封顶
最终方案:腰线以上钉死,以下逐行加权,弹簧追随目标并封顶

第二,阻尼从零点九提到零点五。原来的弹簧阻尼太低,给一个阶跃会来回振好几下,那点残余的晃也是抽搐感的一部分。阻尼提上来,最多过冲一次就稳住。第三,行权重改成腰线以下一段就升到满,裙摆和腿一起甩,脚不再单独甩最远;位移封顶在纹理宽的百分之十五,再快也甩不出画布。

纹理两侧各加了一块余量给摆动留地方,画布本身左移半个余量抵消,显示窗只露中间原来那部分,外观位置跟加余量之前完全一致。松手不把姿态清零,让弹簧把偏角带回正,留一点回弹的余韵。

做完之后

实测的结果是:快速拖动时,裙摆那一行的稳态位移约四十像素,峰值四十五像素;松手后大约十帧平滑归零;腰线以上的顶点位移始终是零。放大截图看,大衣下摆明显往一侧甩出去,脸、头发、手臂保持原样,没有锯齿、空洞和错位。

开销算得出来。引擎和模型约一点四兆,三十一段语音约九百六十千字节,全量二点四兆,窄屏设备一个字节都不下载。静态目录设一年不可变,改过脚本不换版本号,浏览器照旧读旧的,页面上看不出任何变化。所以每次改完都升版本号、提交、双推,再回根页查一次版本字符串。用法卡底部留一行页面版本号,截图里能直接确认是不是旧缓存。

这套东西做到最后,也没让裙摆变成真正的布料。它没有独立的腿,甩起来是一整段贴图在动,转到大角度会穿帮。可它待在右下角,被拖一下会晃,松手会慢慢站正。把角色拖到屏幕下边,手松开,那截衣摆自己摆回原位,停住了。跟早先那只蹲在桌面上的小东西,好像也没差那么多。

参考