MikuMikuAR 文档

Appearance

JS 端视线追踪 ​

系统概览 ​

JS 端视线追踪（ADR-071/162）。提供基于 JavaScript 的视线追踪实现， 被 perception-gaze 调度。

核心职责 ​

  • perception-gaze-js.ts — JS 视线追踪计算、骨骼应用。

对外 API（节选） ​

  • _applyHeadGazeJS(model, time, ctx) — 应用头部视线（JS 模式）。
  • _applyEyeGazeJS(model, time, ctx) — 应用眼部视线（JS 模式）。

与其他子系统关系 ​

  • 视线追踪主模块：./perception-gaze.ts（调度）。
  • 共享类型：./perception-shared.ts。
  • 骨骼候选：BONE_GAZE_CANDIDATES。

不变量 ​

  • JS 模式与 WASM 模式互斥，由 perception-gaze.ts:_applyGaze 通过 _isWasmRuntime() 自动分支。
  • 仅用于 VITE_MMD_RUNTIME=js 调试模式（无物理），保留作为 gaze 行为对比排查与 WASM 兼容性回退（scene.ts:687 注释明令勿删除）。
  • 写入策略：linkedBone.rotationQuaternion + _updateBoneChain 递归 + skeleton._markAsDirty()。
  • 视线追踪频率约 30 FPS。