MikuMikuAR 文档

Appearance

状态栏与提示系统 ​

系统概览 ​

管理顶部状态栏、菜单 hover hint 以及 FPS/运行时徽标的显隐。状态文本支持成功/普通两种颜色、自动淡出、hint 临时覆盖和屏幕阅读器播报。

对外 API（节选） ​

  • setStatus(text, ok, hold?) — 写入状态并按成功/失败设置淡出时长。
  • showHint(text) / hideHint() — 临时保存并恢复状态栏内容。
  • applyHudVisibility() — 根据 uiState 应用 FPS 与 runtime badge 显隐。
  • initHints() — 绑定 [data-hint] 元素的 hover 提示。
  • disposeStatusBar() — 清理定时器和 hint 监听器。

不变量 ​

  • 状态文本为空时隐藏状态栏容器，避免残留空黑框。
  • hint 活跃时不覆盖原状态；隐藏 hint 后恢复原文案和颜色。

验证入口 ​

  • 测试：状态栏当前主要由菜单与初始化流程间接覆盖。