From 23a20d5d6da1f51abf29f68ec5f80398f0947920 Mon Sep 17 00:00:00 2001 From: Harvey Zhao Date: Sun, 4 Jan 2026 17:29:05 +0800 Subject: [PATCH] feat: enhance audio track plugin with waiting and playing event handling --- README.md | 2 +- .../uncompiled/artplayer-plugin-audio-track/index.js | 8 ++++++++ .../artplayer-plugin-audio-track/index.js.map | 2 +- packages/artplayer-plugin-audio-track/package.json | 2 +- packages/artplayer-plugin-audio-track/src/index.js | 12 ++++++++++++ 5 files changed, 23 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index c536d6a4b..db28673bc 100644 --- a/README.md +++ b/README.md @@ -114,7 +114,7 @@ let art = new Artplayer({ | [artplayer-plugin-auto-thumbnail](https://artplayer.org/?libs=./uncompiled/artplayer-plugin-auto-thumbnail/index.js&example=auto.thumbnail) | Auto-generated thumbnails | | | [artplayer-plugin-ambilight](https://artplayer.org/?libs=./uncompiled/artplayer-plugin-ambilight/index.js&example=ambilight) | Ambilight effect | | | [artplayer-plugin-document-pip](https://artplayer.org/?libs=./uncompiled/artplayer-plugin-document-pip/index.js&example=document.pip) | Document Picture-in-Picture | | -| [artplayer-plugin-audio-track](https://artplayer.org/?libs=./uncompiled/artplayer-plugin-audio-track/index.js&example=audio.track) | Audio track selection | | +| [artplayer-plugin-audio-track](https://artplayer.org/?libs=./uncompiled/artplayer-plugin-audio-track/index.js&example=audio.track) | Independent audio track playback | | | [artplayer-plugin-jassub](https://artplayer.org/?libs=./uncompiled/artplayer-plugin-jassub/index.js&example=jassub) | ASS/SSA subtitle support | | | [artplayer-plugin-danmuku-mask](https://artplayer.org/?libs=./uncompiled/artplayer-plugin-danmuku/index.js%0A./uncompiled/artplayer-plugin-danmuku-mask/index.js&example=danmuku.mask) | Danmuku masking (smart blocking) | | | [artplayer-plugin-asr](https://artplayer.org/?libs=./uncompiled/artplayer-plugin-asr/index.js&example=asr) | Automatic Speech Recognition | | diff --git a/docs/uncompiled/artplayer-plugin-audio-track/index.js b/docs/uncompiled/artplayer-plugin-audio-track/index.js index d1fce236e..23691913a 100644 --- a/docs/uncompiled/artplayer-plugin-audio-track/index.js +++ b/docs/uncompiled/artplayer-plugin-audio-track/index.js @@ -246,6 +246,14 @@ function artplayerPluginAudioTrack(option) { audio.volume = art.volume; audio.muted = art.muted; }); + art.on('video:waiting', ()=>{ + audio.pause(); + }); + art.on('video:playing', ()=>{ + if (url && art.playing) audio.play().catch((err)=>{ + console.warn(err); + }); + }); art.on('destroy', ()=>{ audio.pause(); audio.src = ''; diff --git a/docs/uncompiled/artplayer-plugin-audio-track/index.js.map b/docs/uncompiled/artplayer-plugin-audio-track/index.js.map index cd839d3ec..395eed1ce 100644 --- a/docs/uncompiled/artplayer-plugin-audio-track/index.js.map +++ b/docs/uncompiled/artplayer-plugin-audio-track/index.js.map @@ -1 +1 @@ -{"mappings":"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","sources":["packages/artplayer-plugin-audio-track/src/index.js","node_modules/@parcel/transformer-js/src/esmodule-helpers.js"],"sourcesContent":["export default function artplayerPluginAudioTrack(option) {\n return (art) => {\n let { url, offset = 0, sync = 0.3 } = option\n\n const audio = new Audio()\n audio.preload = 'auto'\n if (url) {\n audio.src = url\n }\n\n function syncAudio() {\n if (!art.video || !url)\n return\n\n const videoTime = art.currentTime\n const targetTime = videoTime + offset\n\n if (Math.abs(audio.currentTime - targetTime) > sync) {\n audio.currentTime = targetTime\n }\n }\n\n art.on('play', () => {\n if (!url)\n return\n syncAudio()\n audio.play().catch((err) => {\n console.warn(err)\n })\n })\n\n art.on('pause', () => {\n audio.pause()\n })\n\n art.on('seek', () => {\n syncAudio()\n })\n\n art.on('video:timeupdate', () => {\n if (art.playing) {\n syncAudio()\n }\n })\n\n art.on('video:ratechange', () => {\n audio.playbackRate = art.video.playbackRate\n })\n\n art.on('video:volumechange', () => {\n audio.volume = art.volume\n audio.muted = art.muted\n })\n\n art.on('destroy', () => {\n audio.pause()\n audio.src = ''\n audio.load()\n })\n\n function update(newOption) {\n if (newOption.url && newOption.url !== url) {\n url = newOption.url\n audio.src = url\n if (art.playing) {\n audio.play().catch(err => console.warn(err))\n }\n }\n\n if (newOption.offset !== undefined) {\n offset = newOption.offset\n }\n\n if (newOption.sync !== undefined) {\n sync = newOption.sync\n }\n }\n\n audio.volume = art.volume\n audio.muted = art.muted\n audio.playbackRate = art.video?.playbackRate || 1\n\n return {\n name: 'artplayerPluginAudioTrack',\n audio,\n update,\n }\n }\n}\n\nif (typeof window !== 'undefined') {\n window.artplayerPluginAudioTrack = artplayerPluginAudioTrack\n}\n","exports.interopDefault = function (a) {\n return a && a.__esModule ? a : {default: a};\n};\n\nexports.defineInteropFlag = function (a) {\n Object.defineProperty(a, '__esModule', {value: true});\n};\n\nexports.exportAll = function (source, dest) {\n Object.keys(source).forEach(function (key) {\n if (\n key === 'default' ||\n key === '__esModule' ||\n Object.prototype.hasOwnProperty.call(dest, key)\n ) {\n return;\n }\n\n Object.defineProperty(dest, key, {\n enumerable: true,\n get: function () {\n return source[key];\n },\n });\n });\n\n return dest;\n};\n\nexports.export = function (dest, destName, get) {\n Object.defineProperty(dest, destName, {\n enumerable: true,\n get: get,\n });\n};\n"],"names":[],"version":3,"file":"index.js.map","sourceRoot":"../../../"} \ No newline at end of file +{"mappings":"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","sources":["packages/artplayer-plugin-audio-track/src/index.js","node_modules/@parcel/transformer-js/src/esmodule-helpers.js"],"sourcesContent":["export default function artplayerPluginAudioTrack(option) {\n return (art) => {\n let { url, offset = 0, sync = 0.3 } = option\n\n const audio = new Audio()\n audio.preload = 'auto'\n if (url) {\n audio.src = url\n }\n\n function syncAudio() {\n if (!art.video || !url)\n return\n\n const videoTime = art.currentTime\n const targetTime = videoTime + offset\n\n if (Math.abs(audio.currentTime - targetTime) > sync) {\n audio.currentTime = targetTime\n }\n }\n\n art.on('play', () => {\n if (!url)\n return\n syncAudio()\n audio.play().catch((err) => {\n console.warn(err)\n })\n })\n\n art.on('pause', () => {\n audio.pause()\n })\n\n art.on('seek', () => {\n syncAudio()\n })\n\n art.on('video:timeupdate', () => {\n if (art.playing) {\n syncAudio()\n }\n })\n\n art.on('video:ratechange', () => {\n audio.playbackRate = art.video.playbackRate\n })\n\n art.on('video:volumechange', () => {\n audio.volume = art.volume\n audio.muted = art.muted\n })\n\n art.on('video:waiting', () => {\n audio.pause()\n })\n\n art.on('video:playing', () => {\n if (url && art.playing) {\n audio.play().catch((err) => {\n console.warn(err)\n })\n }\n })\n\n art.on('destroy', () => {\n audio.pause()\n audio.src = ''\n audio.load()\n })\n\n function update(newOption) {\n if (newOption.url && newOption.url !== url) {\n url = newOption.url\n audio.src = url\n if (art.playing) {\n audio.play().catch(err => console.warn(err))\n }\n }\n\n if (newOption.offset !== undefined) {\n offset = newOption.offset\n }\n\n if (newOption.sync !== undefined) {\n sync = newOption.sync\n }\n }\n\n audio.volume = art.volume\n audio.muted = art.muted\n audio.playbackRate = art.video?.playbackRate || 1\n\n return {\n name: 'artplayerPluginAudioTrack',\n audio,\n update,\n }\n }\n}\n\nif (typeof window !== 'undefined') {\n window.artplayerPluginAudioTrack = artplayerPluginAudioTrack\n}\n","exports.interopDefault = function (a) {\n return a && a.__esModule ? a : {default: a};\n};\n\nexports.defineInteropFlag = function (a) {\n Object.defineProperty(a, '__esModule', {value: true});\n};\n\nexports.exportAll = function (source, dest) {\n Object.keys(source).forEach(function (key) {\n if (\n key === 'default' ||\n key === '__esModule' ||\n Object.prototype.hasOwnProperty.call(dest, key)\n ) {\n return;\n }\n\n Object.defineProperty(dest, key, {\n enumerable: true,\n get: function () {\n return source[key];\n },\n });\n });\n\n return dest;\n};\n\nexports.export = function (dest, destName, get) {\n Object.defineProperty(dest, destName, {\n enumerable: true,\n get: get,\n });\n};\n"],"names":[],"version":3,"file":"index.js.map","sourceRoot":"../../../"} \ No newline at end of file diff --git a/packages/artplayer-plugin-audio-track/package.json b/packages/artplayer-plugin-audio-track/package.json index f615bb46a..82f75aaa9 100644 --- a/packages/artplayer-plugin-audio-track/package.json +++ b/packages/artplayer-plugin-audio-track/package.json @@ -1,6 +1,6 @@ { "name": "artplayer-plugin-audio-track", - "version": "1.0.0", + "version": "1.0.1", "description": "audio-track plugin for ArtPlayer", "author": "Harvey Zack ", "license": "MIT", diff --git a/packages/artplayer-plugin-audio-track/src/index.js b/packages/artplayer-plugin-audio-track/src/index.js index 4f261c9d5..bfaa317bc 100644 --- a/packages/artplayer-plugin-audio-track/src/index.js +++ b/packages/artplayer-plugin-audio-track/src/index.js @@ -52,6 +52,18 @@ export default function artplayerPluginAudioTrack(option) { audio.muted = art.muted }) + art.on('video:waiting', () => { + audio.pause() + }) + + art.on('video:playing', () => { + if (url && art.playing) { + audio.play().catch((err) => { + console.warn(err) + }) + } + }) + art.on('destroy', () => { audio.pause() audio.src = ''