MikuMikuAR 文档

Appearance

MikuMikuAR v1.6.3 ​

渲染与视觉 ​

  • ADR-076 方向2：真 Cel-Shading 后处理 — posterize + Sobel 边缘检测管线落地，Anime 组合预设 + 命名分层
  • ADR-112：SDEF 球面变形真正生效 — 修复变形不生效的 build bug，render-postprocess 测试类型修正
  • ADR-151：反射系统统一架构 — 审核修复闭环（3 项行为/联动风险 P2/P3）；反射模式菜单入口；拆分 reflectionQuality 与 reflectionMode
  • ADR-152：光锥系统 — 替换假 VolumetricLightScatteringPostProcess 为真实 ShaderMaterial 光锥 mesh，自动保存链路修复、旧存档迁移、冗余清理
  • ADR-172：湿身效果 — 独立模块 env-wetness，异常安全 removeWetnessFromAllModels，纹理偏移全覆盖
  • ADR-173：setEnvState 中间件化 — 状态变更可拦截/可转换
  • ADR-174：质量维度注册表 — 统一质量维度管理

环境与地面 ​

  • 金属舞台预设 — metalStage + i18n 映射
  • 地面纹理增强 — 纹理密度与 mesh 尺寸成正比，旋转零角优化 + bumpTexture 泄漏修复
  • 粒子质量档位 — particleQuality 新增
  • 地面反射排除天空球 — 天空反射改由 IBL 环境贴图处理
  • 程序化纹理 — wood/marble/concrete 地面程序化纹理

性能与降级 ​

  • 刷新率基准上限 240 — 降级收敛 + resize 全量 recalc
  • captureThumbnail toBlob 异步编码 — 替代同步 toDataURL，减少主线程阻塞
  • 降级系统接入 renderScale — 像素比杠杆
  • 移动端默认 balanced 降级档 — cloudQuality 接入 shader

动作系统 ​

  • ADR-145：动作预设系统 — 审核修复闭环，动作预设 i18n + UI 完善
  • ADR-085 审核修正 — 移除 bodySmooth 死参数 UI，补充骨骼候选列表
  • ADR-088 审计遗留修复 — 清单全部闭环

修复 & 其他 ​

  • Core 模块审核修复 — P1 render-loop 守卫、P2 并发锁/队列/定时器泄漏、P3 响应式优化
  • 横屏面板限高 — 防止顶出屏幕（ADR-017 A2-03）
  • Android 屏幕方向切换 — 竖/横/自动（ADR-017 A1-05）
  • Android 屏幕常亮 + WebView 渲染崩溃自愈（ADR-017 A1-04/A2-07）
  • Android 返回键双击退出 — 修复用户无法退出 App 的 P1 交互缺陷
  • i18n 全面补齐 — 清理死 key、校准 ja/ko 术语、补齐缺失 key
  • Outfit：URL.revokeObjectURL 及时释放 + RESET_VARIANT 常量
  • 阵型菜单迁移 — 从场景菜单迁移至模型库
  • 场景灯光完整 bind 模式 — 21 处重复 bind 消除

自 v1.6.1 以来 59 次提交，168 个文件变更，+6224/−1657 行。 自 v1.5.3 以来累计 354 次提交，620 个文件变更，+110933/−15667 行（含 v1.6.0/v1.6.1）。