非曲库资源，希望支持seek功能。实现断点续播

[boluofan]

功能描述

未入库的曲库资源，未通过/songs/{id}/play接口推送至音响。而是通过/mina/play-url 接口直接推送url。无法使用新增的seek功能实现断点续播，希望支持。

使用场景

有声书插件资源，未入库曲库。使用外部挂载方式进行加载。并通过/mina/play-url 接口直接推送url至音响。
参数如下：

{
    "account_id": "2851554***",
    "device_id": "116df685-7d60-4af2-aa8c-32f5500d6082",
    "url": "https://***.boluofan.top:23522/api/v1/jsplugin/audiobook/api/books/%E9%9B%AA%E4%B8%AD%E6%82%8D%E5%88%80%E8%A1%8C/chapters/%E9%9B%AA%E4%B8%AD%E6%82%8D%E5%88%80%E8%A1%8C-ch002/audio?access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRfaWQiOiJNb3ppbGxhLzUuMCAoV2luZG93cyBOVCAxMC4wOyBXaW42NDsgeDY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvMTUwLjAuMC4wIFNhZmFyaS81MzcuMzYgRWRnLzE1MC4wLjAuMCIsImV4cCI6MTc4NTg5MjQyMiwiaWF0IjoxNzg1Mjg3NjIyLCJqdGkiOiIwYWE4NzY0NTA1YWU3YzBhM2M4YWRlODNjNjM2YTFlYSJ9.zBlGcnS-LkAU7K7YexvR8QhjCVTx4fsoAmFMTLLAjeI"
}

你设想的实现方式

无

现有替代方案

无

[hanxi]

已在宿主侧实现，plugin-sdk v2.13.2 起可用。

用法

serveFile 指令新增两个可选字段：

return {
  serveFile: {
    filePath: playablePath,
    seekSeconds: 120.5,       // 从第 120.5 秒起播
    durationSeconds: 3600,    // 章节总时长（可选，用于超时计算）
  }
};

典型写法（从请求 query 中读取 ?seek=N）：

router.get("/api/books/:id/chapters/:chapterId/audio", async (req, params) => {
  const chapter = bm.getChapter(params.id, params.chapterId);
  if (!chapter) return errorResponse("未找到章节", 404);

  const playablePath = await ensurePlayablePath(chapter.fileRelPath);
  const seekSeconds = parseFloat(req.query?.seek || "0");

  return {
    serveFile: {
      filePath: playablePath,
      seekSeconds: seekSeconds > 0 ? seekSeconds : undefined,
      durationSeconds: chapter.duration || undefined,
    }
  };
});

行为说明

场景	行为
seekSeconds 省略或 0	标准 http.ServeFile（支持 Range，浏览器/just_audio 正常 seek）
seekSeconds > 0，ffmpeg 可用	从第 N 秒起的 chunked MP3 流（无 Content-Length，Cache-Control: no-store）
seekSeconds > 0，ffmpeg 不可用/并发满	优雅降级为从头完整提供文件

durationSeconds 用于 ffmpeg 进程超时保护，省略时使用 3 小时兜底（足够覆盖有声书），传了能更精确地回收孤儿进程。

[boluofan]

收到，感谢！