chore: Update danmuku plugin configuration handling and improve performance

docs/assets/example/danmuku.js

@@ -24,7 +24,7 @@ var art = new Artplayer({
             antiOverlap: true, // 弹幕是否防重叠
             synchronousPlayback: false, // 是否同步播放速度
             mount: undefined, // 弹幕发射器挂载点, 默认为播放器控制栏中部
-            heatmap: true, // 是否开启热力图
+            heatmap: false, // 是否开启热力图
             points: [], // 热力图数据
             filter: () => true, // 弹幕载入前的过滤器，只支持返回布尔值
             beforeEmit: () => true, // 弹幕发送前的过滤器，支持返回 Promise
@@ -33,6 +33,11 @@ var art = new Artplayer({
             maxLength: 200, // 弹幕输入框最大长度, 范围在[1 ~ 1000]
             lockTime: 5, // 输入框锁定时间，范围在[1 ~ 60]
             theme: 'dark', // 弹幕主题，支持 dark 和 light，只在自定义挂载时生效
+            OPACITY: {}, // 不透明度配置项
+            FONT_SIZE: {}, // 弹幕字号配置项
+            MARGIN: {}, // 显示区域配置项
+            SPEED: {}, // 弹幕速度配置项
+            COLOR: [], // 颜色列表配置项
         }),
     ],
 });

docs/uncompiled/artplayer-plugin-danmuku/index.js

@@ -202,6 +202,7 @@ class Danmuku {
         this.isStop = false; // 是否停止
         this.isHide = false; // 是否隐藏
         this.timer = null; // 定时器
+        this.index = 0; // 弹幕索引
         // 弹幕状态池
         this.states = {
             wait: [],
@@ -260,7 +261,12 @@ class Danmuku {
             visible: true,
             maxLength: 200,
             lockTime: 5,
-            theme: "dark"
+            theme: "dark",
+            OPACITY: {},
+            FONT_SIZE: {},
+            MARGIN: {},
+            SPEED: {},
+            COLOR: []
         };
     }
     // 配置校验
@@ -285,7 +291,12 @@ class Danmuku {
             visible: "boolean",
             maxLength: "number",
             lockTime: "number",
-            theme: "string"
+            theme: "string",
+            OPACITY: "object",
+            FONT_SIZE: "object",
+            MARGIN: "object",
+            SPEED: "object",
+            COLOR: "array"
         };
     }
     // 初始弹幕样式
@@ -352,11 +363,13 @@ class Danmuku {
         $ref.dataset.mode = "";
         return $ref;
     }
-    // 获取准备好发送的弹幕：有的是ready状态（如之前因为弹幕太多而暂停发送的弹幕），有的是wait状态
+    // 获取准备好发送的弹幕
     get readys() {
         const { currentTime } = this.art;
         const result = [];
+        // 有的是ready状态：之前因为弹幕太多而暂停发送的弹幕
         this.filter("ready", (danmu)=>result.push(danmu));
+        // 有的是wait状态：符合时间范围的弹幕
         this.filter("wait", (danmu)=>{
             if (currentTime + 0.1 >= danmu.time && danmu.time >= currentTime - 0.1) result.push(danmu);
         });
@@ -405,6 +418,7 @@ class Danmuku {
             this.$danmuku.innerText = ""; // 清空弹幕层
             this.danmus.forEach((danmu)=>this.emit(danmu)); // 逐个验证原始弹幕并转换为实际弹幕
             this.art.emit("artplayerPluginDanmuku:loaded", this.queue);
+            console.log("Danmuku loaded:", this.queue);
         } catch (error) {
             this.art.emit("artplayerPluginDanmuku:error", error);
             throw error;
@@ -444,15 +458,19 @@ class Danmuku {
         ].includes(danmu.mode)) return this;
         // 自定义弹幕过滤函数
         if (!this.option.filter(danmu)) return this;
-        // 转换为wait状态
-        this.setState(danmu, "wait");
-        // 添加到实际弹幕队列
-        this.queue.push({
+        // 添加自定义属性
+        const item = {
             ...danmu,
+            $state: "wait",
+            $id: this.index++,
             $ref: null,
             $restTime: 0,
             $lastStartTime: 0
-        });
+        };
+        // 转换为wait状态
+        this.setState(item, "wait");
+        // 添加到实际弹幕队列
+        this.queue.push(item);
         // 弹幕有四个状态：
         // - wait: 弹幕还未开始显示，没有被添加到 DOM 中
         // - ready: 弹幕准备好显示，没有被添加到 DOM 中
@@ -508,7 +526,7 @@ class Danmuku {
     // 设置弹幕状态
     setState(danmu, state) {
         // 从原状态池中删除
-        if (danmu.$state) this.states[danmu.$state] = this.states[danmu.$state].filter((item)=>item !== danmu);
+        this.states[danmu.$state] = this.states[danmu.$state].filter((item)=>item !== danmu);
         // 设置新状态
         danmu.$state = state;
         // 设置DOM节点状态
@@ -1012,21 +1030,23 @@ class Setting {
         `;
     }
     get OPACITY() {
-        return this.option.OPACITY || {
+        return {
             min: 0,
             max: 100,
-            steps: []
+            steps: [],
+            ...this.option.OPACITY
         };
     }
     get FONT_SIZE() {
-        return this.option.FONT_SIZE || {
+        return {
             min: 12,
             max: 120,
-            steps: []
+            steps: [],
+            ...this.option.FONT_SIZE
         };
     }
     get MARGIN() {
-        return this.option.MARGIN || {
+        return {
             min: 0,
             max: 3,
             steps: [
@@ -1058,11 +1078,12 @@ class Setting {
                         10
                     ]
                 }
-            ]
+            ],
+            ...this.option.MARGIN
         };
     }
     get SPEED() {
-        return this.option.SPEED || {
+        return {
             min: 0,
             max: 4,
             steps: [
@@ -1088,11 +1109,12 @@ class Setting {
                     name: "\u6781\u5FEB",
                     value: 1
                 }
-            ]
+            ],
+            ...this.option.SPEED
         };
     }
     get COLOR() {
-        return this.option.COLOR || [
+        return this.option.COLOR.length ? this.option.COLOR : [
             "#FE0302",
             "#FF7204",
             "#FFAA02",

docs/uncompiled/artplayer-plugin-danmuku/index.js.map

@@ -1 +1 @@
-{"mappings":"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 truncated
+{"mappings":"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 truncated

packages/artplayer-plugin-danmuku/src/danmuku.js

@@ -18,6 +18,7 @@ export default class Danmuku {
         this.isStop = false; // 是否停止
         this.isHide = false; // 是否隐藏
         this.timer = null; // 定时器
+        this.index = 0; // 弹幕索引
 
         // 弹幕状态池
         this.states = {
@@ -75,6 +76,11 @@ export default class Danmuku {
             maxLength: 200, // 弹幕输入框最大长度, 范围在[1 ~ 1000]
             lockTime: 5, // 输入框锁定时间，范围在[1 ~ 60]
             theme: 'dark', // 弹幕主题，支持 dark 和 light，只在自定义挂载时生效
+            OPACITY: {}, // 不透明度配置项
+            FONT_SIZE: {}, // 弹幕字号配置项
+            MARGIN: {}, // 显示区域配置项
+            SPEED: {}, // 弹幕速度配置项
+            COLOR: [], // 颜色列表配置项
         };
     }
 
@@ -101,6 +107,11 @@ export default class Danmuku {
             maxLength: 'number',
             lockTime: 'number',
             theme: 'string',
+            OPACITY: 'object',
+            FONT_SIZE: 'object',
+            MARGIN: 'object',
+            SPEED: 'object',
+            COLOR: 'array',
         };
     }
 
@@ -190,12 +201,16 @@ export default class Danmuku {
         return $ref;
     }
 
-    // 获取准备好发送的弹幕：有的是ready状态（如之前因为弹幕太多而暂停发送的弹幕），有的是wait状态
+    // 获取准备好发送的弹幕
     get readys() {
         const { currentTime } = this.art;
 
         const result = [];
+
+        // 有的是ready状态：之前因为弹幕太多而暂停发送的弹幕
         this.filter('ready', (danmu) => result.push(danmu));
+
+        // 有的是wait状态：符合时间范围的弹幕
         this.filter('wait', (danmu) => {
             if (currentTime + 0.1 >= danmu.time && danmu.time >= currentTime - 0.1) {
                 result.push(danmu);
@@ -264,6 +279,7 @@ export default class Danmuku {
             this.$danmuku.innerText = ''; // 清空弹幕层
             this.danmus.forEach((danmu) => this.emit(danmu)); // 逐个验证原始弹幕并转换为实际弹幕
             this.art.emit('artplayerPluginDanmuku:loaded', this.queue);
+            console.log('Danmuku loaded:', this.queue);
         } catch (error) {
             this.art.emit('artplayerPluginDanmuku:error', error);
             throw error;
@@ -322,16 +338,21 @@ export default class Danmuku {
         // 自定义弹幕过滤函数
         if (!this.option.filter(danmu)) return this;
 
-        // 转换为wait状态
-        this.setState(danmu, 'wait');
-
-        // 添加到实际弹幕队列
-        this.queue.push({
+        // 添加自定义属性
+        const item = {
             ...danmu,
+            $state: 'wait', // 弹幕初始状态
+            $id: this.index++, // 弹幕唯一标识
             $ref: null, // 弹幕 DOM 节点
             $restTime: 0, // 弹幕剩余时间
             $lastStartTime: 0, // 弹幕上次开始时间
-        });
+        };
+
+        // 转换为wait状态
+        this.setState(item, 'wait');
+
+        // 添加到实际弹幕队列
+        this.queue.push(item);
 
         // 弹幕有四个状态：
         // - wait: 弹幕还未开始显示，没有被添加到 DOM 中
@@ -413,9 +434,7 @@ export default class Danmuku {
     // 设置弹幕状态
     setState(danmu, state) {
         // 从原状态池中删除
-        if (danmu.$state) {
-            this.states[danmu.$state] = this.states[danmu.$state].filter((item) => item !== danmu);
-        }
+        this.states[danmu.$state] = this.states[danmu.$state].filter((item) => item !== danmu);
 
         // 设置新状态
         danmu.$state = state;

packages/artplayer-plugin-danmuku/src/setting.js

@@ -186,104 +186,100 @@ export default class Setting {
     }
 
     get OPACITY() {
-        return (
-            this.option.OPACITY || {
-                min: 0,
-                max: 100,
-                steps: [],
-            }
-        );
+        return {
+            min: 0,
+            max: 100,
+            steps: [],
+            ...this.option.OPACITY,
+        };
     }
 
     get FONT_SIZE() {
-        return (
-            this.option.FONT_SIZE || {
-                min: 12,
-                max: 120,
-                steps: [],
-            }
-        );
+        return {
+            min: 12,
+            max: 120,
+            steps: [],
+            ...this.option.FONT_SIZE,
+        };
     }
 
     get MARGIN() {
-        return (
-            this.option.MARGIN || {
-                min: 0,
-                max: 3,
-                steps: [
-                    {
-                        name: '1/4',
-                        value: [10, '75%'],
-                    },
-                    {
-                        name: '半屏',
-                        value: [10, '50%'],
-                    },
-                    {
-                        name: '3/4',
-                        value: [10, '25%'],
-                    },
-                    {
-                        name: '满屏',
-                        value: [10, 10],
-                    },
-                ],
-            }
-        );
+        return {
+            min: 0,
+            max: 3,
+            steps: [
+                {
+                    name: '1/4',
+                    value: [10, '75%'],
+                },
+                {
+                    name: '半屏',
+                    value: [10, '50%'],
+                },
+                {
+                    name: '3/4',
+                    value: [10, '25%'],
+                },
+                {
+                    name: '满屏',
+                    value: [10, 10],
+                },
+            ],
+            ...this.option.MARGIN,
+        };
     }
 
     get SPEED() {
-        return (
-            this.option.SPEED || {
-                min: 0,
-                max: 4,
-                steps: [
-                    {
-                        name: '极慢',
-                        value: 10,
-                    },
-                    {
-                        name: '较慢',
-                        value: 7.5,
-                        hide: true,
-                    },
-                    {
-                        name: '适中',
-                        value: 5,
-                    },
-                    {
-                        name: '较快',
-                        value: 2.5,
-                        hide: true,
-                    },
-                    {
-                        name: '极快',
-                        value: 1,
-                    },
-                ],
-            }
-        );
+        return {
+            min: 0,
+            max: 4,
+            steps: [
+                {
+                    name: '极慢',
+                    value: 10,
+                },
+                {
+                    name: '较慢',
+                    value: 7.5,
+                    hide: true,
+                },
+                {
+                    name: '适中',
+                    value: 5,
+                },
+                {
+                    name: '较快',
+                    value: 2.5,
+                    hide: true,
+                },
+                {
+                    name: '极快',
+                    value: 1,
+                },
+            ],
+            ...this.option.SPEED,
+        };
     }
 
     get COLOR() {
-        return (
-            this.option.COLOR || [
-                '#FE0302',
-                '#FF7204',
-                '#FFAA02',
-                '#FFD302',
-                '#FFFF00',
-                '#A0EE00',
-                '#00CD00',
-                '#019899',
-                '#4266BE',
-                '#89D5FF',
-                '#CC0273',
-                '#222222',
-                '#9B9B9B',
-                '#FFFFFF',
-            ]
-        );
+        return this.option.COLOR.length
+            ? this.option.COLOR
+            : [
+                  '#FE0302',
+                  '#FF7204',
+                  '#FFAA02',
+                  '#FFD302',
+                  '#FFFF00',
+                  '#A0EE00',
+                  '#00CD00',
+                  '#019899',
+                  '#4266BE',
+                  '#89D5FF',
+                  '#CC0273',
+                  '#222222',
+                  '#9B9B9B',
+                  '#FFFFFF',
+              ];
     }
 
     query(selector) {

packages/artplayer-plugin-danmuku/types/artplayer-plugin-danmuku.d.ts

@@ -169,7 +169,7 @@ type Option = {
     // 不透明度配置项
     OPACITY?: Slider;
 
-    // 速度配置项
+    // 弹幕速度配置项
     SPEED?: Slider;
 
     // 显示区域配置项

packages/artplayer-vitepress/docs/plugin/danmuku.md

@@ -62,7 +62,7 @@ https://unpkg.com/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.js
 
 ```js
 {
-    danmuku: [], // 弹幕源
+    danmuku: [], // 弹幕数据
     speed: 5, // 弹幕持续时间，范围在[1 ~ 10]
     margin: [10, '25%'], // 弹幕上下边距，支持像素数字和百分比
     opacity: 1, // 弹幕透明度，范围在[0 ~ 1]
@@ -82,6 +82,11 @@ https://unpkg.com/artplayer-plugin-danmuku/dist/artplayer-plugin-danmuku.js
     maxLength: 200, // 弹幕输入框最大长度, 范围在[1 ~ 1000]
     lockTime: 5, // 输入框锁定时间，范围在[1 ~ 60]
     theme: 'dark', // 弹幕主题，支持 dark 和 light，只在自定义挂载时生效
+    OPACITY: {}, // 不透明度配置项
+    FONT_SIZE: {}, // 弹幕字号配置项
+    MARGIN: {}, // 显示区域配置项
+    SPEED: {}, // 弹幕速度配置项
+    COLOR: [], // 颜色列表配置项
 }
 ```