feat: 新增「猫咪设置 > 模型设置 > 最大帧率」配置项 (#934)

Author: ayangweb

src/locales/en-US.json

@@ -24,7 +24,8 @@
           "motionSound": "Motion Sound",
           "behavior": "Motions and Expressions",
           "autoReleaseDelay": "Auto Release Delay",
-          "hideOnHover": "Hide on Hover"
+          "hideOnHover": "Hide on Hover",
+          "maxFPS": "Max Frame Rate"
         },
         "hints": {
           "mirrorMode": "When enabled, the model will be mirrored horizontally.",
@@ -36,7 +37,8 @@
           "keepInScreen": "When enabled, the window automatically stays within the screen boundaries.",
           "windowSize": "Move mouse to window edge, or hold Shift and right-drag to resize.",
           "autoReleaseDelay": "On Windows, some system keys cannot capture release events and will auto-release after timeout.",
-          "hideOnHover": "When enabled, the window hides when mouse hovers over it."
+          "hideOnHover": "When enabled, the window hides when mouse hovers over it.",
+          "maxFPS": "Limit the maximum frame rate for model rendering. Lowering the frame rate can reduce CPU/GPU usage."
         }
       },
       "general": {

src/locales/pt-BR.json

@@ -24,7 +24,8 @@
           "motionSound": "Som de Ação",
           "behavior": "Movimentos e Expressões",
           "autoReleaseDelay": "Atraso de Liberação Automática",
-          "hideOnHover": "Ocultar ao Passar o Mouse"
+          "hideOnHover": "Ocultar ao Passar o Mouse",
+          "maxFPS": "Taxa Máxima de Quadros"
         },
         "hints": {
           "mirrorMode": "Quando ativado, o modelo será invertido horizontalmente.",
@@ -36,7 +37,8 @@
           "keepInScreen": "Quando ativado, a janela permanece automaticamente dentro dos limites da tela.",
           "windowSize": "Mova o mouse para a borda da janela ou segure Shift e arraste com o botão direito para redimensionar.",
           "autoReleaseDelay": "Devido ao Windows não capturar eventos de liberação de certas teclas de nível do sistema, elas serão automaticamente tratadas como liberadas após um tempo limite.",
-          "hideOnHover": "Quando ativado, a janela será ocultada quando o mouse passar sobre ela."
+          "hideOnHover": "Quando ativado, a janela será ocultada quando o mouse passar sobre ela.",
+          "maxFPS": "Limitar a taxa máxima de quadros para renderização do modelo. Reduzir a taxa de quadros pode diminuir o uso de CPU/GPU."
         }
       },
       "general": {

src/locales/vi-VN.json

@@ -24,7 +24,8 @@
           "motionSound": "Âm thanh hành động",
           "behavior": "Hành động và Biểu cảm",
           "autoReleaseDelay": "Độ trễ tự động nhả phím",
-          "hideOnHover": "Ẩn khi di chuột"
+          "hideOnHover": "Ẩn khi di chuột",
+          "maxFPS": "Tốc độ khung hình tối đa"
         },
         "hints": {
           "mirrorMode": "Bật để lật ngang mô hình.",
@@ -36,7 +37,8 @@
           "keepInScreen": "Khi bật, cửa sổ sẽ tự động giữ trong ranh giới màn hình.",
           "windowSize": "Di chuyển chuột đến mép cửa sổ hoặc giữ Shift và kéo chuột phải để thay đổi kích thước.",
           "autoReleaseDelay": "Do Windows không bắt được sự kiện nhả của một số phím hệ thống, các phím đó sẽ được tự động xem như đã nhả sau khi hết thời gian chờ.",
-          "hideOnHover": "Khi bật, cửa sổ sẽ ẩn khi chuột di chuyển vào."
+          "hideOnHover": "Khi bật, cửa sổ sẽ ẩn khi chuột di chuyển vào.",
+          "maxFPS": "Giới hạn tốc độ khung hình tối đa cho việc render mô hình. Giảm tốc độ khung hình có thể giảm mức sử dụng CPU/GPU."
         }
       },
       "general": {

src/locales/zh-CN.json

@@ -24,7 +24,8 @@
           "motionSound": "动作音效",
           "behavior": "动作与表情",
           "autoReleaseDelay": "按键自动释放延迟",
-          "hideOnHover": "鼠标移入隐藏"
+          "hideOnHover": "鼠标移入隐藏",
+          "maxFPS": "最大帧率"
         },
         "hints": {
           "mirrorMode": "启用后，模型将水平镜像翻转。",
@@ -36,7 +37,8 @@
           "keepInScreen": "启用后，窗口会自动调整位置，防止超出屏幕边界。",
           "windowSize": "将鼠标移至窗口边缘，或按住 Shift 并右键拖动，也可以调整窗口大小。",
           "autoReleaseDelay": "由于 Windows 下部分系统级按键无法捕获释放事件，超时后将自动视为已释放。",
-          "hideOnHover": "启用后，鼠标悬停在窗口上时，窗口会隐藏。"
+          "hideOnHover": "启用后，鼠标悬停在窗口上时，窗口会隐藏。",
+          "maxFPS": "限制模型渲染的最大帧率，降低帧率可以减少 CPU/GPU 占用。"
         }
       },
       "general": {

src/locales/zh-TW.json

@@ -24,7 +24,8 @@
           "motionSound": "動作音效",
           "behavior": "動作與表情",
           "autoReleaseDelay": "按鍵自動釋放延遲",
-          "hideOnHover": "滑鼠游標移入隱藏"
+          "hideOnHover": "滑鼠游標移入隱藏",
+          "maxFPS": "最大幀率"
         },
         "hints": {
           "mirrorMode": "啟用後，模型將水平鏡像翻轉。",
@@ -36,7 +37,8 @@
           "keepInScreen": "啟用後，視窗會自動調整位置，防止超出螢幕邊界。",
           "windowSize": "將滑鼠游標移至視窗邊緣，或按住 Shift 並右鍵拖曳，也可以調整視窗大小。",
           "autoReleaseDelay": "由於 Windows 下部份系統級按鍵無法擷取釋放事件，超時後將自動視為已釋放。",
-          "hideOnHover": "啟用後，滑鼠游標懸停在視窗上時，視窗會隱藏。"
+          "hideOnHover": "啟用後，滑鼠游標懸停在視窗上時，視窗會隱藏。",
+          "maxFPS": "限制模型渲染的最大幀率，降低幀率可以減少 CPU/GPU 佔用。"
         }
       },
       "general": {

src/pages/main/index.vue

@@ -123,9 +123,9 @@ watch(() => catStore.window.alwaysOnTop, setAlwaysOnTop, { immediate: true })
 
 watch(() => generalStore.app.taskbarVisible, setTaskbarVisibility, { immediate: true })
 
-watch(() => catStore.model.motionSound, (value) => {
-  live2d.setMotionSoundEnabled(value)
-}, { immediate: true })
+watch(() => catStore.model.motionSound, live2d.setMotionSoundEnabled, { immediate: true })
+
+watch(() => catStore.model.maxFPS, live2d.setMaxFPS, { immediate: true })
 
 useTauriListen<MotionInfo>(LISTEN_KEY.START_MOTION, ({ payload }) => {
   live2d.startMotion(payload)

src/pages/preference/components/cat/index.vue

@@ -50,6 +50,17 @@ const catStore = useCatStore()
         class="w-28"
       />
     </ProListItem>
+
+    <ProListItem
+      :description="$t('pages.preference.cat.hints.maxFPS')"
+      :title="$t('pages.preference.cat.labels.maxFPS')"
+    >
+      <InputNumber
+        v-model:value="catStore.model.maxFPS"
+        class="w-20"
+        :min="0"
+      />
+    </ProListItem>
   </ProList>
 
   <ProList :title="$t('pages.preference.cat.labels.windowSettings')">

src/stores/cat.ts

@@ -8,6 +8,7 @@ export interface CatStore {
     motionSound: boolean
     behavior: boolean
     autoReleaseDelay: number
+    maxFPS: number
   }
   window: {
     visible: boolean
@@ -51,6 +52,7 @@ export const useCatStore = defineStore('cat', () => {
     motionSound: true,
     behavior: true,
     autoReleaseDelay: 3,
+    maxFPS: 60,
   })
 
   const window = reactive<CatStore['window']>({

src/utils/live2d.ts

@@ -129,6 +129,10 @@ class Live2d {
   public setMotionSoundEnabled(enabled: boolean) {
     Config.MotionSound = enabled
   }
+
+  public setMaxFPS(fps: number) {
+    Ticker.shared.maxFPS = fps
+  }
 }
 
 const live2d = new Live2d()