feat(metronome): 双引擎(BgAudio 档位+InnerAudio 自定义)+音频迁移 CDN

- 档位模式用 BackgroundAudioManager+预合成循环 mp3, 锁屏可继续播放
- 自定义模式保留 InnerAudio, 支持任意 BPM(40~240)/拍号(2/3/4), 仅前台
- UI 折叠区区分两种模式, preset 默认进, 点"⚙ 自定义节奏"切换
- 音频资产全部迁移到腾讯云 COS, 删除本地 6 个 mp3/jpg (-210KB)
- server 上传白名单补 mp3/wav/m4a/aac/amr/wma 格式

TUICallKit-Vue3/training/hooks/useMetronome.ts

@@ -88,12 +88,17 @@ class AudioPool {
     }
 }
 
+/* InnerAudio 兼容本地路径和网络 URL,这里默认走 CDN,跟 BgAudio 保持一致便于维护
+   首次播放会下载 ~3KB,实测 100~300ms 完成,然后小程序会缓存,后续触发零延迟 */
+const DEFAULT_CLICK_SRC =
+    'https://gz-1349751149.cos.ap-guangzhou.myqcloud.com/uploads/file/20260526/20260526105128557ef8669.mp3'
+
 export function useMetronome(options: MetronomeOptions = {}) {
     const {
         initialBpm = 80,
         bpmMin = 40,
         bpmMax = 240,
-        clickSrc = '/training/static/audio/click.mp3',
+        clickSrc = DEFAULT_CLICK_SRC,
         accentSrc,
         poolSize = 4,
         onBeat,

TUICallKit-Vue3/training/hooks/useMetronomeBg.ts

@@ -28,31 +28,48 @@ export interface LoopPreset {
     label: string
 }
 
+/**
+ * 重要:微信 BackgroundAudioManager.src 只接受 http/https 网络流,不能是包内资源
+ * 所以必须把音频上传到 CDN(腾讯云 COS),并在小程序后台加 downloadFile 合法域名
+ *
+ * 当前线上文件(2026-05-26 上传到 cos.ap-guangzhou):
+ *   - loop_80bpm_2.mp3   循环音轨 慢走档
+ *   - loop_110bpm_2.mp3  循环音轨 健走档
+ *   - loop_130bpm_2.mp3  循环音轨 快走档
+ *
+ * 历史源文件(本地 training/static/audio/*.mp3) 已删除以减小包体积,
+ * 如果以后要重新合成,先从 COS 下回来再用 ffmpeg 处理
+ */
 export const LOOP_PRESETS: readonly LoopPreset[] = [
     {
         id: 'slow',
         bpm: 80,
         accent: 2,
-        src: '/training/static/audio/loop_80bpm_2.mp3',
+        src: 'https://gz-1349751149.cos.ap-guangzhou.myqcloud.com/uploads/file/20260526/20260526105129dcbc50112.mp3',
         label: '慢走 80 BPM',
     },
     {
         id: 'normal',
         bpm: 110,
         accent: 2,
-        src: '/training/static/audio/loop_110bpm_2.mp3',
+        src: 'https://gz-1349751149.cos.ap-guangzhou.myqcloud.com/uploads/file/20260526/202605261051284f5b04928.mp3',
         label: '健走 110 BPM',
     },
     {
         id: 'brisk',
         bpm: 130,
         accent: 2,
-        src: '/training/static/audio/loop_130bpm_2.mp3',
+        src: 'https://gz-1349751149.cos.ap-guangzhou.myqcloud.com/uploads/file/20260526/20260526105128164d77281.mp3',
         label: '快走 130 BPM',
     },
 ]
 
-const COVER_URL = '/training/static/audio/cover.jpg'
+/**
+ * 锁屏控制条封面
+ * 暂时留空,微信会显示默认音乐图标,等以后有正式品牌图再上传到 COS 后填入这里
+ * 注意:URL 必须是 https,且域名要加进小程序后台 downloadFile 合法域名
+ */
+const COVER_URL = ''
 
 export function useMetronomeBg() {
     const isPlaying = ref<boolean>(false)
@@ -74,7 +91,7 @@ export function useMetronomeBg() {
         m.title = '节拍器'
         m.epname = '甄养堂 · 健走'
         m.singer = '健走配速'
-        m.coverImgUrl = COVER_URL
+        if (COVER_URL) m.coverImgUrl = COVER_URL
         m.webUrl = ''
 
         m.onPlay(() => {