{"id":114,"date":"2026-03-08T19:07:01","date_gmt":"2026-03-08T11:07:01","guid":{"rendered":"https:\/\/fisssssh.top\/index.php\/2026\/05\/27\/electron-react-music-player\/"},"modified":"2026-03-08T19:07:01","modified_gmt":"2026-03-08T11:07:01","slug":"electron-react-music-player","status":"publish","type":"post","link":"https:\/\/fisssssh.top\/index.php\/2026\/03\/08\/electron-react-music-player\/","title":{"rendered":"\u4ece\u96f6\u6784\u5efa\u684c\u9762\u97f3\u4e50\u64ad\u653e\u5668 – Electron + React + TypeScript \u5b9e\u8df5"},"content":{"rendered":"\n

\u4f20\u7edf\u684c\u9762\u97f3\u4e50\u64ad\u653e\u5668\u8981\u4e48\u529f\u80fd\u5355\u4e00\u53ea\u80fd\u64ad\u672c\u5730\u6587\u4ef6\uff0c\u8981\u4e48\u754c\u9762\u8fd8\u505c\u7559\u5728\u5341\u5e74\u524d\u7684\u98ce\u683c\u3002\u4f5c\u4e3a\u5f00\u53d1\u8005\u517c\u97f3\u4e50\u7231\u597d\u8005\uff0c\u6211\u5e0c\u671b\u6709\u4e00\u4e2a\u65e2\u80fd\u7ba1\u7406\u672c\u5730\u97f3\u4e50\u3001\u53c8\u80fd\u4eceB\u7ad9\u4e00\u952e\u63d0\u53d6\u97f3\u9891\u3001\u754c\u9762\u8fd8\u597d\u770b\u7684\u64ad\u653e\u5668\u3002\u5728\u6bd4\u8f83\u4e86WPF\u3001Qt\u548cElectron\u4e4b\u540e\uff0c\u6700\u7ec8\u9009\u62e9\u4e86 Electron + React + TypeScript<\/strong> \u7684\u6280\u672f\u6808\uff0c\u82b1\u4e86\u4e24\u5468\u65f6\u95f4\u4ece\u96f6\u6784\u5efa\u4e86 FishMusic\uff08MusicWave\uff09\u3002\u672c\u6587\u8bb0\u5f55\u6574\u4e2a\u9879\u76ee\u7684\u67b6\u6784\u8bbe\u8ba1\u3001\u6838\u5fc3\u6280\u672f\u5b9e\u73b0\u548c\u8e29\u5751\u7ecf\u9a8c\u3002<\/p>\n\n\n\n

\u4e00\u3001\u6280\u672f\u9009\u578b\uff1a\u4e3a\u4ec0\u4e48\u662f Electron\uff1f<\/h2>\n\n\n\n

\u684c\u9762\u5e94\u7528\u7684\u5f00\u53d1\u8def\u7ebf\u4e3b\u8981\u6709\u4e09\u6761\uff1a\u539f\u751f\uff08C++\/WinUI\uff09\u3001\u6258\u7ba1\uff08C# WPF \/ Java Swing\uff09\u3001Web\u58f3\uff08Electron \/ Tauri\uff09\u3002\u6700\u7ec8\u9009\u62e9 Electron \u57fa\u4e8e\u51e0\u4e2a\u8003\u91cf\uff1a<\/p>\n\n\n\n

\u7ef4\u5ea6<\/th>WPF (.NET)<\/th>Qt (C++)<\/th>Electron<\/th>Tauri<\/th><\/tr><\/thead>
UI \u5f00\u53d1\u6548\u7387<\/td>\u4e2d<\/td>\u4f4e<\/td>\u9ad8<\/td>\u9ad8<\/td><\/tr>
\u751f\u6001\/\u7ec4\u4ef6\u5e93<\/td>\u4e2d<\/td>\u4e2d<\/td>\u6781\u4e30\u5bcc<\/td>\u5c11<\/td><\/tr>
\u6587\u4ef6\u7cfb\u7edf\u80fd\u529b<\/td>\u5f3a<\/td>\u5f3a<\/td>\u5f3a\uff08Node.js\uff09<\/td>\u5f3a\uff08Rust\uff09<\/td><\/tr>
FFmpeg \u96c6\u6210<\/td>\u9700\u5c01\u88c5<\/td>\u9700\u5c01\u88c5<\/td>npm \u76f4\u88c5<\/td>\u9700Rust\u7ed1\u5b9a<\/td><\/tr>
\u6253\u5305\u4f53\u79ef<\/td>\u4e2d<\/td>\u5c0f<\/td>\u5927\uff08~150MB\uff09<\/td>\u5c0f\uff08~10MB\uff09<\/td><\/tr>
\u8de8\u5e73\u53f0<\/td>\u4ec5Windows<\/td>\u597d<\/td>\u597d<\/td>\u597d<\/td><\/tr><\/tbody><\/table>
\u684c\u9762\u6846\u67b6\u6280\u672f\u9009\u578b\u5bf9\u6bd4<\/figcaption><\/figure>\n\n\n\n

\u5173\u952e\u51b3\u7b56\u56e0\u7d20\uff1a<\/strong>FishMusic \u7684\u6838\u5fc3\u529f\u80fd\u4f9d\u8d56 FFmpeg\uff08\u97f3\u9891\u8f6c\u7801\uff09\u548c HTTP \u8bf7\u6c42\uff08B\u7ad9 API \u8c03\u7528\uff09\uff0cNode.js \u751f\u6001\u4e2d fluent-ffmpeg<\/code> \u548c net.request<\/code> \u53ef\u4ee5\u76f4\u63a5\u6ee1\u8db3\u8fd9\u4e9b\u9700\u6c42\uff0c\u65e0\u9700\u989d\u5916\u7684 Native Addon \u5f00\u53d1\u3002\u6b64\u5916\uff0cAnt Design 5 \u63d0\u4f9b\u4e86\u6210\u719f\u7684 UI \u7ec4\u4ef6\u5e93\uff0c\u4ece Table\u3001Modal \u5230 Slider \u4e00\u5e94\u4ff1\u5168\uff0c\u5927\u5e45\u964d\u4f4e\u4e86 UI \u5f00\u53d1\u6210\u672c\u3002<\/p>\n\n\n\n

\u4e8c\u3001\u6574\u4f53\u67b6\u6784\u8bbe\u8ba1<\/h2>\n\n\n\n

\u9879\u76ee\u91c7\u7528\u7ecf\u5178\u7684 Electron \u4e3b\u8fdb\u7a0b + \u6e32\u67d3\u8fdb\u7a0b<\/strong> \u53cc\u5c42\u67b6\u6784\uff0c\u901a\u8fc7 Preload \u811a\u672c\u66b4\u9732\u5b89\u5168\u7684 IPC \u63a5\u53e3\uff1a<\/p>\n\n\n\n

==========================================================\n                    \u6e32\u67d3\u8fdb\u7a0b (Renderer)\n  React 18 + TypeScript + Ant Design 5 + Zustand\n  +-- pages\/   (Home \/ Library \/ Playlists \/ Settings)\n  +-- components\/ (Layout \/ PlayerBar \/ ExtractModal)\n  +-- stores\/  (playerStore \/ playlistStore \/ persistence)\n  +-- hooks\/   (useAudioPlayer \/ useCoverUrl)\n----------------------------------------------------------\n              Preload (contextBridge)\n  window.electronAPI = {\n    extractBilibili, downloadAudio, convertToMP3,\n    cropAudio, getCoverUrl, selectDirectory, ...\n  }\n----------------------------------------------------------\n                    \u4e3b\u8fdb\u7a0b (Main)\n  Electron + Node.js\n  +-- ipc\/bilibili.ts     (IPC handler)\n  +-- services\/bilibili.ts (B\u7ad9 API \/ WBI)\n  +-- services\/downloader.ts (net.request)\n  +-- services\/ffmpeg.ts  (fluent-ffmpeg)\n  +-- store\/json-store.ts (JSON \u539f\u5b50\u8bfb\u5199)\n==========================================================<\/code><\/pre>\n\n\n\n
2.1 \u5b89\u5168\u6a21\u578b\uff1aPreload + contextBridge<\/h3>\n\n\n\n
Electron \u5e94\u7528\u6700\u5927\u7684\u5b89\u5168\u9690\u60a3\u662f\u6e32\u67d3\u8fdb\u7a0b\u76f4\u63a5\u8bbf\u95ee Node.js API\u3002FishMusic \u9075\u5faa Electron \u5b89\u5168\u6700\u4f73\u5b9e\u8df5\uff1a<\/p>\n\n\n\n
    \n
  • contextIsolation: true<\/strong> \u2014 \u6e32\u67d3\u8fdb\u7a0b\u4e0e\u4e3b\u8fdb\u7a0b\u5b8c\u5168\u9694\u79bb\uff0c\u65e0\u6cd5\u76f4\u63a5\u8bbf\u95ee Node.js<\/li>\n
  • nodeIntegration: false<\/strong> \u2014 \u7981\u6b62\u6e32\u67d3\u8fdb\u7a0b\u4f7f\u7528 require()<\/li>\n
  • Preload \u811a\u672c<\/strong> \u2014 \u901a\u8fc7 contextBridge.exposeInMainWorld<\/code> \u66b4\u9732\u6709\u9650 API\uff0c\u6240\u6709\u53c2\u6570\u7ecf\u8fc7\u7c7b\u578b\u6821\u9a8c<\/li>\n
  • IPC Handler<\/strong> \u2014 \u4e3b\u8fdb\u7a0b\u6ce8\u518c ipcMain.handle('channel', handler)<\/code>\uff0c\u6e32\u67d3\u8fdb\u7a0b\u901a\u8fc7 window.electronAPI.methodName(args)<\/code> \u8c03\u7528\uff0c\u5e95\u5c42\u81ea\u52a8\u8d70 ipcRenderer.invoke<\/code><\/li>\n<\/ul>\n\n\n\n
    \u8fd9\u79cd\u8bbe\u8ba1\u786e\u4fdd\u5373\u4f7f\u524d\u7aef\u4ee3\u7801\u88ab XSS \u653b\u51fb\uff0c\u653b\u51fb\u8005\u4e5f\u4ec5\u80fd\u8c03\u7528 Preload \u66b4\u9732\u7684\u6709\u9650\u65b9\u6cd5\uff0c\u65e0\u6cd5\u76f4\u63a5\u6267\u884c\u7cfb\u7edf\u547d\u4ee4\u3002<\/p>\n\n\n\n
    \u4e09\u3001B\u7ad9\u97f3\u9891\u63d0\u53d6\uff1a\u5b8c\u6574\u94fe\u8def<\/h2>\n\n\n\n
    \u8fd9\u662f FishMusic \u6700\u6838\u5fc3\u4e5f\u6700\u590d\u6742\u7684\u529f\u80fd\u3002\u4ece\u7528\u6237\u7c98\u8d34\u94fe\u63a5\u5230\u83b7\u5f97 MP3 \u6587\u4ef6\uff0c\u7ecf\u5386\u4e86\u591a\u4e2a\u6b65\u9aa4\u3002<\/p>\n\n\n\n
    3.1 WBI \u7b7e\u540d\u7b97\u6cd5<\/h3>\n\n\n\n
    B\u7ad9\u4ece2023\u5e74\u8d77\u542f\u7528\u4e86 WBI\uff08Web Interface\uff09\u7b7e\u540d\u673a\u5236\uff0c\u6240\u6709 API \u8bf7\u6c42\u5fc5\u987b\u643a\u5e26 w_rid<\/code> \u548c wts<\/code> \u53c2\u6570\u3002\u7b7e\u540d\u539f\u7406\uff1a<\/p>\n\n\n\n
    \/\/ 1. \u4ece B\u7ad9 API \u83b7\u53d6 img_key \u548c sub_key\uff08\u6bcf24h\u8fc7\u671f\uff09\nconst { img_key, sub_key } = await fetch('https:\/\/api.bilibili.com\/x\/web-interface\/nav')\n\n\/\/ 2. \u88c1\u526a\u5bc6\u94a5\uff1a\u53bb\u9664\u975e\u5341\u516d\u8fdb\u5236\u5b57\u7b26\uff0c\u53d6\u7b2c9\u5230\u7b2c40\u4f4d\nconst mixinKey = (img_key + sub_key).replace(\/[^a-f0-9]\/g, '').slice(8, 40)\n\n\/\/ 3. \u5bf9\u8bf7\u6c42\u53c2\u6570\u6392\u5e8f\u3001\u62fc\u63a5\u3001\u52a0\u76d0\u3001\u53d6MD5\nconst params = { ...originalParams, wts: Math.floor(Date.now() \/ 1000) }\nconst sorted = Object.keys(params).sort()\n  .map(k => k + '=' + encodeURIComponent(params[k])).join('&')\nconst w_rid = md5(sorted + mixinKey)\n\n\/\/ 4. \u6700\u7ec8\u8bf7\u6c42 URL\nconst url = `https:\/\/api.bilibili.com\/x\/player\/pagelist?${sorted}&w_rid=${w_rid}`<\/code><\/pre>\n\n\n\n
    WBI \u5bc6\u94a5\u6bcf24\u5c0f\u65f6\u8f6e\u6362\uff0c\u56e0\u6b64\u5e94\u7528\u542f\u52a8\u65f6\u9700\u8981\u91cd\u65b0\u83b7\u53d6\u3002\u5b9e\u73b0\u65f6\u52a0\u4e86\u7f13\u5b58\u903b\u8f91\uff0c\u907f\u514d\u77ed\u65f6\u95f4\u5185\u91cd\u590d\u8bf7\u6c42\u3002\u5982\u679c\u8bf7\u6c42\u8fd4\u56de -352 \u9519\u8bef\u7801\uff0c\u81ea\u52a8\u5237\u65b0\u5bc6\u94a5\u5e76\u91cd\u8bd5\u3002<\/p>\n\n\n\n
    3.2 \u591a\u8282\u70b9\u4e0b\u8f7d\u4e0e\u8d85\u65f6\u5207\u6362<\/h3>\n\n\n\n
    B\u7ad9\u89c6\u9891\u7684\u97f3\u9891\u6d41\u6258\u7ba1\u5728\u591a\u4e2a CDN \u8282\u70b9\u4e0a\uff0c\u4e0d\u540c\u8fd0\u8425\u5546\u7684\u8bbf\u95ee\u901f\u5ea6\u5dee\u5f02\u5f88\u5927\u3002FishMusic \u7684\u4e0b\u8f7d\u7b56\u7565\uff1aAPI \u8fd4\u56de\u7684 audio_streams \u6570\u7ec4\u6309\u5e26\u5bbd\u964d\u5e8f\u6392\u5217\uff0c\u4f18\u5148\u5c1d\u8bd5\u6700\u5feb\u7684\u8282\u70b9\uff1b\u6bcf\u4e2a\u8282\u70b915\u79d2\u8fde\u63a5\u8d85\u65f6\uff0c\u5931\u8d25\u81ea\u52a8\u5207\u4e0b\u4e00\u4e2a\uff1b\u4f7f\u7528 electron.net.request<\/code> \u800c\u975e\u6d4f\u89c8\u5668 fetch\uff0c\u7ed5\u8fc7 CORS \u9650\u5236\uff1b\u4e0b\u8f7d\u8fdb\u5ea6\u901a\u8fc7 response.on('data')<\/code> \u5b9e\u65f6\u56de\u4f20\u7ed9\u6e32\u67d3\u8fdb\u7a0b\u3002<\/p>\n\n\n\n
    3.3 FFmpeg \u97f3\u9891\u8f6c\u7801<\/h3>\n\n\n\n
    B\u7ad9\u4e0b\u8f7d\u7684\u97f3\u9891\u4e3a m4s \u683c\u5f0f\uff08MPEG-DASH \u5206\u6bb5\u6d41\uff09\uff0c\u9700\u8981\u8f6c\u7801\u4e3a MP3\u3002\u4f7f\u7528 fluent-ffmpeg<\/code> \u5c01\u88c5 FFmpeg\uff1a<\/p>\n\n\n\n
    import ffmpeg from 'fluent-ffmpeg';\nimport ffmpegStatic from 'ffmpeg-static';\n\nffmpeg.setFfmpegPath(ffmpegStatic);\n\nexport async function convertToMP3(inputPath: string, outputPath: string) {\n  return new Promise((resolve, reject) => {\n    ffmpeg(inputPath)\n      .audioCodec('libmp3lame')\n      .audioBitrate(320)        \/\/ 320kbps \u9ad8\u97f3\u8d28\n      .output(outputPath)\n      .on('progress', (info) => {\n        mainWindow.webContents.send('convert-progress', info.percent);\n      })\n      .on('end', resolve)\n      .on('error', reject)\n      .run();\n  });\n}<\/code><\/pre>\n\n\n\n
    \u5173\u952e\u70b9\uff1a<\/strong>ffmpeg-static<\/code> \u662f\u9884\u7f16\u8bd1\u7684 FFmpeg \u4e8c\u8fdb\u5236\u5305\u3002\u5728 electron-builder.yml \u4e2d\u914d\u7f6e asarUnpack: ['node_modules\/ffmpeg-static\/**']<\/code>\uff0c\u56e0\u4e3a .asar \u5f52\u6863\u662f\u53ea\u8bfb\u7684\uff0cffmpeg \u4e8c\u8fdb\u5236\u5fc5\u987b\u89e3\u538b\u5230\u6587\u4ef6\u7cfb\u7edf\u624d\u80fd\u6267\u884c\u3002<\/p>\n\n\n\n
    \u56db\u3001\u97f3\u9891\u7f16\u8f91\u5668\uff1awavesurfer.js \u6ce2\u5f62\u53ef\u89c6\u5316<\/h2>\n\n\n\n
    \u97f3\u9891\u7f16\u8f91\u662f FishMusic \u7684\u4e00\u5927\u4eae\u70b9\u3002\u6838\u5fc3\u4f9d\u8d56 wavesurfer.js v7<\/strong>\uff0c\u57fa\u4e8e Web Audio API \u7684\u97f3\u9891\u6ce2\u5f62\u6e32\u67d3\u5e93\u3002<\/p>\n\n\n\n
    \u6ce2\u5f62\u6e32\u67d3\u6d41\u7a0b\uff1a\u901a\u8fc7 fetch<\/code> \u52a0\u8f7d\u97f3\u9891\u6587\u4ef6 \u2192 AudioContext.decodeAudioData()<\/code> \u89e3\u7801\u4e3a PCM \u2192 \u5bf9 PCM \u505a\u964d\u91c7\u6837\u751f\u6210\u6ce2\u5f62\u6210\u50cf\u6570\u636e \u2192 Canvas \u4e0a\u7ed8\u5236\u6ce2\u5f62\uff08X\u8f74\u65f6\u95f4\uff0cY\u8f74\u632f\u5e45\uff09\u3002<\/p>\n\n\n\n
    FishMusic \u5728\u6b64\u57fa\u7840\u4e0a\u6269\u5c55\u4e86\u4ee5\u4e0b\u529f\u80fd\uff1a<\/p>\n\n\n\n