Skip to main content

選單列圖示狀態

範圍:macOS 應用程式(apps/macos)。繪製:CritterIconRenderer.makeIcon(...)。動畫/狀態連接:CritterStatusLabel + CritterStatusLabel+Behavior.swift

狀態

當工作階段有作用中的作業或工具時,可在同一個小動物圖示上方顯示工具活動徽章(SF Symbol 圓形徽章,例如執行使用 chevron.left.slash.chevron.right)。該徽章來自 IconState/ActivityKind;完整狀態模型請參閱選單列

語音喚醒耳朵

  • 觸發:AppStateStore.shared.triggerVoiceEars(ttl: nil),由語音喚醒擷取流水線(VoiceWakeRuntime)及語音喚醒偵錯/測試工具(VoiceWakeTesterVoiceWakeOverlayController)呼叫。
  • 停止:stopVoiceEars(),在擷取完成時呼叫。
  • 完成前的靜默時間窗:一般為 2.0s;如果只聽到觸發詞,且之後沒有其他語音(VoiceWakeRuntime.silenceWindow / triggerOnlySilenceWindow),則為 5.0s
  • 增強期間,閒置眨眼/擺動/腿部/耳朵計時器會暫停(earBoostActive 會控制 CritterStatusLabel+Behavior 中的動畫工作)。

形狀與大小

  • 畫布:18x18pt 範本影像,繪製至 36x36px 點陣圖後備儲存區(2x),讓圖示在 Retina 顯示器上保持清晰。
  • 耳朵縮放比例預設為 1.0;語音增強會設定 earScale=1.9,但不會變更整體框架。
  • antennaDroop(0-1)會將觸角向下折疊,形成暫停與睡眠姿勢。
  • 腿部疾走使用 legWiggle,最高至 1.0,並伴隨小幅水平抖動。

行為注意事項

  • 沒有可控制耳朵或工作狀態的外部命令列介面/代理切換;兩者均由應用程式訊號(AppState.setWorkingAppState.triggerVoiceEars)在內部驅動,以避免意外反覆切換。
  • 任何新的 TTL 都應保持短暫(遠低於 10 秒),讓圖示在作業卡住時也能快速回復基準狀態。

相關內容