✨ opt: 修改变量名，并优化功能描述描述文本

Author: ITManCHINA

src/components/Setting/config/lyric.ts

@@ -368,21 +368,6 @@ export const useLyricSettings = (): SettingConfig => {
             }),
             defaultValue: 500,
           },
-          {
-            key: "lyricSyncOffset",
-            label: "歌词同步微调",
-            type: "input-number",
-            description: "手动调整歌词与声音的同步，正值歌词提前，负值歌词延后。",
-            min: -1000,
-            max: 1000,
-            step: 10,
-            suffix: "ms",
-            value: computed({
-              get: () => settingStore.lyricSyncOffset,
-              set: (v) => (settingStore.lyricSyncOffset = v || 0),
-            }),
-            defaultValue: 0,
-          },
         ],
       },
       {

src/components/Setting/config/play.ts

@@ -583,6 +583,24 @@ export const usePlaySettings = (): SettingConfig => {
                 settingStore.audioEngine === "element",
             ),
           },
+          {
+            key: "audioDelayCompensation",
+            label: "音频与歌词同步补偿",
+            type: "input-number",
+            description:
+              "手动补偿音频与歌词进度延迟。<br>正值歌词变快，负值歌词进度变慢。<br>适用于移动端等自动延迟检测不准的设备。",
+            tags: [{ text: "Beta", type: "warning" }],
+            show: computed(() => settingStore.audioLatencyHint === "playback"),
+            min: -1000,
+            max: 1000,
+            step: 10,
+            suffix: "ms",
+            value: computed({
+              get: () => settingStore.audioDelayCompensation,
+              set: (v) => (settingStore.audioDelayCompensation = v ?? 0),
+            }),
+            defaultValue: 0,
+          },
           {
             key: "playSongDemo",
             label: "播放试听",

src/core/audio-player/AudioElementPlayer.ts

@@ -196,9 +196,11 @@ export class AudioElementPlayer extends BaseAudioPlayer {
     if (this.isInternalSeeking) {
       return this.targetSeekTime;
     }
-    // 基础时间 - 自动延迟补偿 + 手动同步偏移
+    // 基础时间 - 自动延迟补偿 + 手动延迟补偿
     return (
-      (this.audioElement.currentTime || 0) - this.compensatedLatency + this.syncOffset / 1000
+      (this.audioElement.currentTime || 0) -
+      this.compensatedLatency +
+      this.audioDelayCompensation / 1000
     );
   }
 

src/core/audio-player/BaseAudioPlayer.ts

@@ -67,8 +67,8 @@ export abstract class BaseAudioPlayer
 
   protected compensatedLatency = 0;
 
-  /** 用户手动设置的歌词同步偏移量 (毫秒) */
-  protected syncOffset = 0;
+  /** 用户手动设置的音频延迟补偿 (毫秒) */
+  protected audioDelayCompensation = 0;
 
   protected effectManager: AudioEffectManager | null = null;
 
@@ -494,8 +494,8 @@ export abstract class BaseAudioPlayer
    * 设置歌词同步偏移
    * @param offset 偏移量 (毫秒)
    */
-  public setSyncOffset(offset: number): void {
-    this.syncOffset = offset;
+  public setAudioDelayCompensation(offset: number): void {
+    this.audioDelayCompensation = offset;
   }
 
   /** 加载资源 */

src/core/audio-player/IPlaybackEngine.ts

@@ -137,10 +137,10 @@ export interface IPlaybackEngine {
   getRate(): number;
 
   /**
-   * 设置歌词同步偏移量
+   * 设置音频延迟手动补偿
    * @param offset 偏移量 (毫秒)
    */
-  setSyncOffset(offset: number): void;
+  setAudioDelayCompensation(offset: number): void;
 
   /**
    * 设置音频输出设备

src/core/player/AudioManager.ts

@@ -367,12 +367,12 @@ class AudioManager extends TypedEventTarget<AudioEventMap> implements IPlaybackE
   }
 
   /**
-   * 设置歌词同步偏移量
+   * 设置音频延迟手动补偿
    * @param offset 偏移量 (毫秒)
    */
-  public setSyncOffset(offset: number): void {
+  public setAudioDelayCompensation(offset: number): void {
     // FFmpeg 和 MPV 引擎可能没有实现此方法
-    this.engine.setSyncOffset?.(offset);
+    this.engine.setAudioDelayCompensation?.(offset);
   }
 
   /**
@@ -514,11 +514,11 @@ export const useAudioManager = (): AudioManager => {
       settingStore.audioEngine,
     );
 
-    // 监听歌词同步偏移量变化
+    // 监听音频延迟补偿变化
     watch(
-      () => settingStore.lyricSyncOffset,
+      () => settingStore.audioDelayCompensation,
       (offset) => {
-        win[AUDIO_MANAGER_KEY]?.setSyncOffset(offset);
+        win[AUDIO_MANAGER_KEY]?.setAudioDelayCompensation(offset);
       },
       { immediate: true }, // 立即执行一次以应用初始值
     );

src/stores/setting.ts

@@ -260,8 +260,8 @@ export interface SettingState {
   wordFadeWidth: number;
   /** 歌词时延调节步长（毫秒） */
   lyricOffsetStep: number;
-  /** 歌词同步微调（毫秒） */
-  lyricSyncOffset: number;
+  /** 音频延迟手动补偿（毫秒） */
+  audioDelayCompensation: number;
   /** 启用在线 TTML 歌词 */
   enableOnlineTTMLLyric: boolean;
   /** 启用 QM 歌词 */
@@ -612,7 +612,7 @@ export const useSettingStore = defineStore("setting", {
     hidePassedLines: false,
     wordFadeWidth: 0.5,
     lyricOffsetStep: 500,
-    lyricSyncOffset: 0,
+    audioDelayCompensation: 0,
     enableOnlineTTMLLyric: false,
     enableQQMusicLyric: false,
     lyricPriority: "auto",