✨ feat: 新增 API 及 Socket 获取播放信息

Author: imsyy

docs/api.md

@@ -169,6 +169,44 @@
 
 ---
 
+### 获取当前播放信息
+
+**接口**: `GET /api/control/song-info`
+
+**描述**: 获取当前播放的歌曲信息
+
+> [!WARNING]
+> 请勿频繁调用此接口（如每秒调用一次）来获取播放进度，这会导致软件性能异常。
+> 如需实时获取播放进度和状态，请使用 WebSocket 连接并监听相关事件。
+
+**响应示例**:
+
+```json
+{
+  "code": 200,
+  "message": "获取当前播放信息成功",
+  "data": {
+    "playStatus": "play",
+    "playName": "歌曲名",
+    "artistName": "歌手名",
+    "albumName": "专辑名",
+    "currentTime": 123.45,
+    "volume": 1,
+    "playRate": 1,
+    "id": 123456,
+    "name": "歌曲名",
+    "artists": "歌手名",
+    "album": "专辑名",
+    "cover": "http://...",
+    "duration": 300,
+    "lrcData": [],
+    "yrcData": []
+  }
+}
+```
+
+---
+
 ## 云音乐 API (Netease API)
 
 **基础路径**: `/api/netease`

docs/socket.md

@@ -108,6 +108,56 @@ ws.onmessage = (event) => {
 };
 ```
 
+## 获取信息
+
+**消息类型**: `get-song-info`
+
+**请求格式**:
+
+```json
+{
+  "type": "get-song-info"
+}
+```
+
+**响应格式**:
+
+成功响应：
+
+```json
+{
+  "type": "song-info",
+  "data": {
+    "playStatus": "play",
+    "playName": "歌曲名",
+    "artistName": "歌手名",
+    "albumName": "专辑名",
+    "currentTime": 123.45,
+    "volume": 1,
+    "playRate": 1,
+    "id": 123456,
+    "name": "歌曲名",
+    "artists": "歌手名",
+    "album": "专辑名",
+    "cover": "http://...",
+    "duration": 300,
+    "lrcData": [],
+    "yrcData": []
+  }
+}
+```
+
+错误响应：
+
+```json
+{
+  "type": "error",
+  "data": {
+    "message": "获取当前播放信息失败"
+  }
+}
+```
+
 ## 事件广播
 
 当播放器状态发生变化时，服务器会向所有连接的客户端广播消息。
@@ -167,7 +217,7 @@ ws.onmessage = (event) => {
   "type": "progress-change",
   "data": {
     "currentTime": 12000, // 当前播放时间(ms)
-    "duration": 240000,   // 总时长(ms)
+    "duration": 240000, // 总时长(ms)
     "timestamp": 1234567890123
   }
 }

electron/main/services/SocketService.ts

@@ -290,6 +290,8 @@ export class SocketService {
     // 根据消息类型进行处理
     if (messageObj.type === "control") {
       this.handleControlCommand(socket, messageObj.data as { command?: string });
+    } else if (messageObj.type === "get-song-info") {
+      this.handleGetSongInfo(socket);
     } else {
       // 未知的消息类型
       socketLog.warn(`⚠️ Unknown message type: ${messageObj.type}`);
@@ -300,6 +302,27 @@ export class SocketService {
     }
   }
 
+  /**
+   * 处理获取当前播放信息请求
+   * @param socket WebSocket 客户端连接
+   */
+  private async handleGetSongInfo(socket: WebSocket): Promise<void> {
+    try {
+      const { getTrackInfoFromRenderer } = await import("../utils/track-info");
+      const trackInfo = await getTrackInfoFromRenderer();
+      this.sendToClient(socket, {
+        type: "song-info",
+        data: trackInfo,
+      });
+    } catch (error) {
+      socketLog.error("❌ Error getting current track info:", error);
+      this.sendToClient(socket, {
+        type: "error",
+        data: { message: "获取当前播放信息失败" },
+      });
+    }
+  }
+
   /**
    * 向指定客户端发送消息
    * @param socket WebSocket 客户端连接

electron/main/utils/track-info.ts

@@ -0,0 +1,32 @@
+import { ipcMain } from "electron";
+import mainWindow from "../windows/main-window";
+
+/**
+ * 从渲染进程获取当前播放信息
+ * @returns Promise<any>
+ */
+export const getTrackInfoFromRenderer = async (): Promise<any> => {
+  return new Promise((resolve, reject) => {
+    const mainWin = mainWindow.getWin();
+    if (!mainWin || mainWin.isDestroyed() || mainWin.webContents.isDestroyed()) {
+      return reject(new Error("主窗口未找到"));
+    }
+
+    // 设置超时，防止无限等待
+    const timeout = setTimeout(() => {
+      ipcMain.removeListener("return-track-info", listener);
+      reject(new Error("获取播放信息超时"));
+    }, 2000);
+
+    const listener = (_event: any, data: any) => {
+      clearTimeout(timeout);
+      resolve(data);
+    };
+
+    // 监听一次性回复
+    ipcMain.once("return-track-info", listener);
+
+    // 发送请求
+    mainWin.webContents.send("request-track-info");
+  });
+};

electron/server/control/index.ts

@@ -197,6 +197,25 @@ export const initControlAPI = async (fastify: FastifyInstance) => {
           });
         }
       });
+
+      // 获取当前播放信息
+      fastify.get("/song-info", async (_request, reply) => {
+        try {
+          const { getTrackInfoFromRenderer } = await import("../../main/utils/track-info");
+          const trackInfo = await getTrackInfoFromRenderer();
+          return reply.send({
+            code: 200,
+            message: "获取当前播放信息成功",
+            data: trackInfo,
+          });
+        } catch (error) {
+          return reply.code(500).send({
+            code: 500,
+            message: "获取当前播放信息失败",
+            data: error instanceof Error ? error.message : error,
+          });
+        }
+      });
     },
     { prefix: "/control" },
   );

src/utils/initIpc.ts

@@ -93,6 +93,30 @@ const initIpc = () => {
       console.log("📡 Received protocol url:", url);
       handleProtocolUrl(url);
     });
+    // 请求播放信息
+    window.electron.ipcRenderer.on("request-track-info", () => {
+      const musicStore = useMusicStore();
+      const statusStore = useStatusStore();
+      const { name, artist, album } = getPlayerInfoObj() || {};
+      // 获取原始对象
+      const playSong = toRaw(musicStore.playSong);
+      const songLyric = toRaw(musicStore.songLyric);
+      window.electron.ipcRenderer.send(
+        "return-track-info",
+        cloneDeep({
+          playStatus: statusStore.playStatus,
+          playName: name,
+          artistName: artist,
+          albumName: album,
+          currentTime: statusStore.currentTime,
+          // 音量及播放速率
+          volume: statusStore.playVolume,
+          playRate: statusStore.playRate,
+          ...playSong,
+          ...songLyric,
+        }),
+      );
+    });
   } catch (error) {
     console.log(error);
   }