@lumia.wang/koishi-plugin-adapter-bilibili 0.1.1 → 0.1.2

package/docs/video-toolkit.md

@@ -5,6 +5,7 @@ Other plugins can use these methods on an authenticated `bot.internal` without m
 | Method | Result |
 | --- | --- |
 | `getVideoSubtitle(bvid)` | `{ bvid, cid, language, text }`; `text` is empty when no subtitle track exists |
+| `getVideoAudio(bvid, { maxDuration?, maxBytes? })` | Since 0.1.2: `{ bvid, cid, duration, mime: 'audio/mp4', data: Buffer }` for the first part's AAC track |
 | `getVideoComments(bvid, options?)` | Normalized comments with string IDs, text, author, likes and mention presence |
 | `getUserVideos(uid, { days?, pages? })` | Recent submissions, ordered by publication time |
 | `getRelatedVideos(bvid)` | Related videos as `VideoBrief[]` |
@@ -15,6 +16,7 @@ Other plugins can use these methods on an authenticated `bot.internal` without m
 
 `getVideoComments` accepts `limit` (1–60), `root` (thread root ID), `sort` (`hot` or `time`), and `anonymous`.
 `getUserVideos` accepts `days` (1–90, default 7) and `pages` (1–5, default 2).
+`getVideoAudio` defaults to 600 seconds and 32 MiB. Callers may choose smaller limits, up to 1800 seconds and 64 MiB. Invalid limits, excessive duration, an unavailable AAC track, empty downloads and excessive download size throw errors. Interrupted/oversized streams are closed. Audio downloads use the context HTTP client without the adapter Cookie, while playback URL requests reuse the account and WBI signature. No external downloader or media process is started.
 Mention objects are `{ id: 'numeric UID', name: 'exact nickname' }`; include the matching `@nickname` in the text. IDs should be passed as strings.
 
 These new APIs propagate request failures and Bilibili error codes instead of treating them as empty content. A missing comment receipt does not trigger a retry. Existing `sendComment` behavior is unchanged: it remains a reply-only API for received comment targets.

package/lib/bilibiliAPI/apis/videoToolkit.d.ts

@@ -45,7 +45,19 @@ export interface FavoriteFolder {
     id: number;
     title: string;
 }
+export interface VideoAudioOptions {
+    maxDuration?: number;
+    maxBytes?: number;
+}
+export interface VideoAudio {
+    bvid: string;
+    cid: number;
+    duration: number;
+    mime: 'audio/mp4';
+    data: Buffer;
+}
 export interface VideoToolkit {
+    getVideoAudio(bvid: string, options?: VideoAudioOptions): Promise<VideoAudio>;
     getVideoSubtitle(bvid: string): Promise<VideoSubtitle>;
     getVideoComments(bvid: string, options?: VideoCommentOptions): Promise<VideoComment[]>;
     getUserVideos(uid: string, options?: UserVideoOptions): Promise<VideoBrief[]>;
@@ -64,6 +76,8 @@ export declare class VideoToolkitAPI implements VideoToolkit {
     private post;
     private info;
     getVideoSubtitle(bvid: string): Promise<VideoSubtitle>;
+    /** Downloads one bounded AAC track for Node-based audio processing. */
+    getVideoAudio(bvid: string, options?: VideoAudioOptions): Promise<VideoAudio>;
     getVideoComments(bvid: string, options?: VideoCommentOptions): Promise<VideoComment[]>;
     getUserVideos(uid: string, options?: UserVideoOptions): Promise<VideoBrief[]>;
     getRelatedVideos(bvid: string): Promise<VideoBrief[]>;

package/lib/bilibiliAPI/internal.d.ts

@@ -1,6 +1,6 @@
 import { Context } from 'koishi';
 import { BilibiliDmBot } from '../bot/bot';
-import { VideoCommentOptions, UserVideoOptions } from './apis/videoToolkit';
+import { VideoCommentOptions, UserVideoOptions, VideoAudioOptions } from './apis/videoToolkit';
 import { BilibiliCommentMention, BilibiliCommentTarget } from './apis/comment';
 import { DynamicItem, FollowingUser, InternalInterface, SearchUser, SearchVideo, SearchLiveRoom, SearchLiveUser, SearchArticle, ComprehensiveSearchResponse, SearchOptions, VideoData, ExternalParseResponse, VideoConclusionData } from './apis/types';
 export declare class Internal implements InternalInterface {
@@ -21,6 +21,7 @@ export declare class Internal implements InternalInterface {
     isCommentPollingActive(): boolean;
     sendComment(channelId: string, content: string, target?: BilibiliCommentTarget, mentions?: BilibiliCommentMention[]): Promise<string | null>;
     getVideoSubtitle(bvid: string): Promise<import(".").VideoSubtitle>;
+    getVideoAudio(bvid: string, options?: VideoAudioOptions): Promise<import(".").VideoAudio>;
     getVideoComments(bvid: string, options?: VideoCommentOptions): Promise<import(".").VideoComment[]>;
     getUserVideos(uid: string, options?: UserVideoOptions): Promise<import(".").VideoBrief[]>;
     getRelatedVideos(bvid: string): Promise<import(".").VideoBrief[]>;

package/lib/index.js

@@ -2668,6 +2668,41 @@ var init_videoToolkit = __esm({
         const body = await this.ctx.http.get(url2.href);
         return { bvid, cid, language: track.lan, text: body.body.map((row) => row.content).join("\n") };
       }
+      /** Downloads one bounded AAC track for Node-based audio processing. */
+      async getVideoAudio(bvid, options = {}) {
+        const maxDuration = options.maxDuration ?? 600;
+        const maxBytes = options.maxBytes ?? 32 * 1024 * 1024;
+        if (!Number.isFinite(maxDuration) || maxDuration <= 0 || maxDuration > 1800) throw new Error("Invalid audio duration limit");
+        if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0 || maxBytes > 64 * 1024 * 1024) throw new Error("Invalid audio size limit");
+        const info = await this.info(bvid);
+        const cid = info.cid || info.pages?.[0]?.cid;
+        if (!cid) throw new Error("Video has no cid");
+        if (!info.duration || info.duration > maxDuration) throw new Error(`Video exceeds audio duration limit (${maxDuration}s)`);
+        const player = await this.get(
+          "/x/player/wbi/playurl",
+          { bvid, cid, fnval: 16, fnver: 0, fourk: 0, qn: 16 },
+          true
+        );
+        const tracks = (player.dash?.audio || []).filter((track2) => [30216, 30232, 30280].includes(track2.id) && (!track2.codecid || track2.codecid === 0));
+        const track = tracks.sort((a, b) => (a.bandwidth || 0) - (b.bandwidth || 0))[0];
+        if (!track) throw new Error("Video has no supported AAC audio track");
+        const url2 = new URL(track.baseUrl || track.base_url || "");
+        if (url2.protocol !== "https:") throw new Error("Invalid audio URL protocol");
+        const stream4 = await this.ctx.http.get(url2.href, {
+          responseType: "stream",
+          timeout: 6e4,
+          headers: { Referer: `https://www.bilibili.com/video/${bvid}`, "User-Agent": "Mozilla/5.0" }
+        });
+        const chunks = [];
+        let length = 0;
+        for await (const chunk of stream4) {
+          length += chunk.byteLength;
+          if (length > maxBytes) throw new Error(`Audio exceeds download size limit (${maxBytes} bytes)`);
+          chunks.push(Buffer.from(chunk));
+        }
+        if (!length) throw new Error("Video audio is empty");
+        return { bvid, cid, duration: info.duration, mime: "audio/mp4", data: Buffer.concat(chunks, length) };
+      }
       async getVideoComments(bvid, options = {}) {
         const info = await this.info(bvid);
         const limit = Math.max(1, Math.min(options.limit ?? 30, 60));
@@ -3138,6 +3173,9 @@ var init_internal = __esm({
       getVideoSubtitle(bvid) {
         return this.videoToolkitAPI.getVideoSubtitle(bvid);
       }
+      getVideoAudio(bvid, options) {
+        return this.videoToolkitAPI.getVideoAudio(bvid, options);
+      }
       getVideoComments(bvid, options) {
         return this.videoToolkitAPI.getVideoComments(bvid, options);
       }