@grfzhl/vue-hls-player 1.1.24 → 1.1.26

package/README.md

@@ -207,6 +207,14 @@ At the moment the following attribute are supported:
 ```
 
 ### Last release:
+v1.1.26
+  - Prevent HLS chunk preloading during player initialization.
+  - Start HLS loading only after user interaction.
+  - Fallback to the first video frame when no preview image is available.
+v1.1.25
+  - Decouple audio language switching from subtitle selection.
+  - Preserve user-selected subtitle language across audio changes and HLS source reloads.
+  - Prevent unintended subtitle resets caused by audio language updates.
 v1.1.24
   - Add user-initiated language-changed emit.
   - Fix unwanted language re-sync on player init.

package/dist/VideoPlayer/BasePlayer.vue

@@ -8,7 +8,7 @@
       </div>
       <div class="media-overlay" v-if="initialPlayButton">
         <div class="initial-play" :class="{'hide-playbutton': hideInitialPlayButton}">
-          <media-play-button mediapaused="" class="media-button" aria-label="play" tabindex="0" role="button" @click="video.play()">
+          <media-play-button mediapaused="" class="media-button" aria-label="play" tabindex="0" role="button" @click="handleInitialPlay">
             <svg slot="icon" viewBox="0 0 32 32">
               <g>
                 <path id="icon-play" d="M20.7131 14.6976C21.7208 15.2735 21.7208 16.7265 20.7131 17.3024L12.7442 21.856C11.7442 22.4274 10.5 21.7054 10.5 20.5536L10.5 11.4464C10.5 10.2946 11.7442 9.57257 12.7442 10.144L20.7131 14.6976Z"></path>
@@ -31,6 +31,7 @@
           ref="video"
           :poster="previewImageLink"
           :controls="false"
+          preload="none"
           :title="title"
           controlslist="nodownload"
           playsinline
@@ -44,7 +45,7 @@
           <track 
             v-if="subtitles.length"
             v-for="(subtitle, i) in subtitles"
-            :key="subtitle.lang + '-' + currentLang"
+            :key="subtitle.lang + '-' + currentAudioLang"
             :src="subtitle.link"
             kind="subtitles"
             :srclang="subtitle.lang"
@@ -71,7 +72,7 @@
   <slot name="between-video-and-transcript"></slot> 
   <slot name="before-transcripts"></slot>
   <SubtitleBlock
-    :key="`${currentLang}-${currentSubtitleLang}`"
+    :key="`${currentAudioLang}-${currentSubtitleLang}`"
     ref="transcriptRef"
     :subtitle="currentSubtitle"
     :cursor="videoCursor"
@@ -185,35 +186,56 @@ let currentTime = 0
 let hls = null
 let buttonElement = null
 // --- lang switcher ---
-const currentLang = ref(props.defaultLang || 'en')
+const currentAudioLang = ref(props.defaultLang || 'en')
+
+const sessionSubtitleLang = 'vp_subtitle_lang'
+function initSubtitleLang() {
+  const stored = sessionStorage.getItem(sessionSubtitleLang)
+
+  if (stored && props.subtitles.some(s => s.lang === stored)) {
+    currentSubtitleLang.value = stored
+  } else {
+    currentSubtitleLang.value =
+      props.subtitles.find(s => s.lang === props.defaultLang)?.lang
+      || props.subtitles[0]?.lang
+  }
+
+  applySubtitleTrack(currentSubtitleLang.value)
+}
+
+function applySubtitleTrack(lang) {
+  Array.from(video.value?.textTracks || []).forEach(track => {
+    const tLang = (track.language || track.srclang || '').toLowerCase()
+    track.mode = tLang === lang.toLowerCase() ? 'showing' : 'disabled'
+  })
+}
+
+
+
 const isUserInitiatedLangChange = ref(false)
 
 let initialLoad = true;
+let defaultApplied = false
+const hlsInitialized = ref(false)
+const hlsInitializing = ref(false)
+const pendingPlayRequest = ref(false)
+const pendingSeekTime = ref(null)
+const previewFramePrimed = ref(false)
+const previewFrameLoading = ref(false)
 
 watch(
   () => props.defaultLang,
-  (newLang, oldLang) => {
-    if (initialLoad) {
-      initialLoad = false;
-      return;
-    }
-    
-    if (newLang && newLang !== oldLang && newLang !== currentLang.value) {
-      const hasSub = props.subtitles?.find(s => s.lang === newLang);
-      if (hasSub) {
-        currentSubtitleLang.value = newLang;
-        Array.from(video.value?.textTracks || []).forEach(track => {
-          const tLang = (track.language || track.srclang || '').toLowerCase();
-          track.mode = tLang === newLang.toLowerCase() ? 'showing' : 'disabled';
-        });
-      }
-    }
+  (lang) => {
+    if (defaultApplied) return
+    currentAudioLang.value = lang
+    defaultApplied = true
   }
 )
+
 // --- Remember and restore last subtitle language ---
 async function selectLang(lang) {
   if (!video.value || !hls) return;
-  if (lang === currentLang.value) return;
+  if (lang === currentAudioLang.value) return;
 
   const newSource = props.multiLangSources?.find(s => s.lang === lang);
   if (!newSource?.file_url) {
@@ -227,7 +249,7 @@ async function selectLang(lang) {
   const wasMuted = video.value.muted;
   const rate = video.value.playbackRate;
 
-  currentLang.value = lang;
+  currentAudioLang.value = lang;
   // Switching to ${lang}...
 
   try {
@@ -284,7 +306,7 @@ function updateLangMenuState() {
     const langElement = li.querySelector('span[data-lang]')
     const liLang = langElement?.dataset?.lang;
     // const liLang = li.textContent.trim().toLowerCase();
-    li.classList.toggle('active', liLang === currentLang.value.toLowerCase());
+    li.classList.toggle('active', liLang === currentAudioLang.value.toLowerCase());
   });
 
   // --- Subtitles ---
@@ -334,7 +356,12 @@ function emitPointerUpdate() {
 const videoElement = defineModel()
 
 onMounted(() => {
-  prepareVideoPlayer(props.link)
+  if (video.value) {
+    video.value.muted = mutedAttr.value
+    video.value.currentTime = props.progress
+  }
+  initVideo()
+  maybeLoadFirstFrame()
 })
 
 onUnmounted(() => {
@@ -369,23 +396,26 @@ const currentSubtitle = computed(() => {
   return props.subtitles[0];
 })
 
-watch(() => props.autoplay, (a) => {
-  if(a[0].autoplay && a[1] && a[1].paused) {
-    // autoplay is only possible when muted
-    a[1].muted = true
-    setTimeout(() => {
-      a[1].play().catch(err => console.warn("Autoplay-Error:", err));
-    }, 200)
+watch(() => props.autoplay, (autoplay) => {
+  if (!autoplay || !video.value || !video.value.paused) {
+    return
   }
+
+  video.value.muted = true
+  setTimeout(() => {
+    handleInitialPlay().catch(err => console.warn("Autoplay-Error:", err))
+  }, 200)
 })
 
 watch(
   () => props.link,
   (newLink, oldLink) => {
-  if (newLink !== oldLink) {
-    prepareVideoPlayer(newLink);
+    if (newLink !== oldLink) {
+      resetPlayer()
+      maybeLoadFirstFrame()
+    }
   }
-})
+)
 
 async function startFullscreen() {
   let vpVideoBlock = document.getElementById(props.fullScreenElement);
@@ -532,13 +562,130 @@ function toggleTranscript() {
   props.showTranscriptBlock = !props.showTranscriptBlock
 }
 
-function seekVideo(time) {
-  video.value.currentTime = time;
-  video.value.play()
+async function handleInitialPlay() {
+  await startPlayback()
+}
+
+async function startPlayback() {
+  if (!video.value) return
+
+  pendingPlayRequest.value = true
+  pendingSeekTime.value = null
+  initialPlayButton.value = false
+
+  if (!hlsInitialized.value) {
+    initPlayer(props.link)
+    return
+  }
+
+  if (previewFrameLoading.value && !previewFramePrimed.value) {
+    return
+  }
+
+  resumePreviewFrameStream()
+
+  try {
+    await video.value.play()
+    pendingPlayRequest.value = false
+  } catch (err) {
+    console.warn('[HLS] Play start failed:', err)
+    initialPlayButton.value = true
+  }
+}
+
+function initPlayer(src, { previewOnly = false } = {}) {
+  if (!video.value || !src || hlsInitialized.value || hlsInitializing.value) return
+
+  hlsInitializing.value = true
+
+  try {
+    prepareVideoPlayer(src, { previewOnly })
+    hlsInitialized.value = true
+  } finally {
+    hlsInitializing.value = false
+  }
+}
+
+function maybeLoadFirstFrame() {
+  if (
+    props.previewImageLink ||
+    !props.link ||
+    !video.value ||
+    hlsInitialized.value ||
+    hlsInitializing.value
+  ) {
+    return
+  }
+
+  initPlayer(props.link, { previewOnly: true })
+}
+
+function resumePreviewFrameStream() {
+  if (!previewFramePrimed.value || !hls || !video.value) return
+
+  previewFramePrimed.value = false
+  hls.startLoad(video.value.currentTime || 0)
+}
+
+function resetPlayer() {
+  hlsInitialized.value = false
+  hlsInitializing.value = false
+  pendingPlayRequest.value = false
+  pendingSeekTime.value = null
+  previewFramePrimed.value = false
+  previewFrameLoading.value = false
+  initialPlayButton.value = true
+  hideInitialPlayButton.value = false
+
+  if (hls) {
+    hls.detachMedia()
+    hls.destroy()
+    hls = null
+  }
+
+  if (!video.value) return
+
+  video.value.pause()
+  video.value.removeAttribute('src')
+  const source = video.value.querySelector('source')
+  if (source) {
+    source.removeAttribute('src')
+  }
+  video.value.load()
+  video.value.currentTime = props.progress
+  video.value.muted = mutedAttr.value
+}
+
+async function seekVideo(time) {
+  if (!video.value) return
+
+  if (!hlsInitialized.value) {
+    pendingSeekTime.value = time
+    pendingPlayRequest.value = true
+    initPlayer(props.link)
+    return
+  }
+
+  if (previewFrameLoading.value && !previewFramePrimed.value) {
+    pendingSeekTime.value = time
+    pendingPlayRequest.value = true
+    return
+  }
+
+  resumePreviewFrameStream()
+  video.value.currentTime = time
+
+  try {
+    await video.value.play()
+    pendingPlayRequest.value = false
+    pendingSeekTime.value = null
+  } catch (err) {
+    console.warn('[HLS] Seek play failed:', err)
+  }
 }
 
-function prepareVideoPlayer(link) {
-  if (!video.value) return;
+function prepareVideoPlayer(link, { previewOnly = false } = {}) {
+  if (!video.value || !link) return;
 
   // Reset previous HLS instance
   if (hls) {
@@ -546,15 +693,68 @@ function prepareVideoPlayer(link) {
     hls.destroy();
   }
 
+  const playerHlsConfig = {
+    ...hlsConfig,
+    autoStartLoad: !previewOnly,
+  };
+
   // Preparing video player with link: ${link}
-  hls = new Hls(hlsConfig);
+  hls = new Hls(playerHlsConfig);
   // Attach HLS
   hls.loadSource(link);
   hls.attachMedia(video.value);
-  video.value.textTracks.addEventListener('change', () => {
-    Array.from(video.value?.textTracks || []).forEach(track => {
-      console.log('[TrackChange] Track', track.language || track.srclang, '→', track.mode);
-    });
+  hls.once(Hls.Events.MANIFEST_PARSED, async () => {
+    if (!video.value) return;
+
+    video.value.muted = mutedAttr.value;
+    video.value.currentTime = pendingSeekTime.value ?? props.progress;
+
+    if (previewOnly) {
+      previewFrameLoading.value = true;
+      video.value.addEventListener('loadeddata', async () => {
+        previewFrameLoading.value = false;
+
+        if (!video.value || !hls) return;
+
+        video.value.pause();
+
+        if (!pendingPlayRequest.value) {
+          previewFramePrimed.value = true;
+          hls.stopLoad();
+          return;
+        }
+
+        previewFramePrimed.value = false;
+        hls.startLoad(video.value.currentTime || 0);
+
+        if (pendingSeekTime.value != null) {
+          video.value.currentTime = pendingSeekTime.value;
+        }
+
+        try {
+          await video.value.play();
+          pendingPlayRequest.value = false;
+          pendingSeekTime.value = null;
+        } catch (err) {
+          console.warn('[HLS] Play after first frame failed:', err);
+          initialPlayButton.value = true;
+        }
+      }, { once: true });
+
+      hls.startLoad(0);
+      return;
+    }
+
+    if (!pendingPlayRequest.value) return;
+
+    try {
+      await video.value.play();
+      pendingPlayRequest.value = false;
+      pendingSeekTime.value = null;
+    } catch (err) {
+      console.warn('[HLS] Play after manifest failed:', err);
+      initialPlayButton.value = true;
+    }
   });
   // Native subtitle handling – without polling
   Array.from(video.value?.textTracks || []).forEach(track => {
@@ -589,14 +789,7 @@ function prepareVideoPlayer(link) {
 
   // Initialize subtitles
   if (props.subtitles?.length > 0) {
-    const defaultSub = props.subtitles.find(s => s.lang === props.defaultLang);
-    currentSubtitleLang.value = defaultSub ? props.defaultLang : props.subtitles[0].lang;
-    Array.from(video.value?.textTracks || []).forEach(track => {
-      const tLang = (track.language || track.srclang || '').toLowerCase();
-      const shouldShow = tLang === currentSubtitleLang.value.toLowerCase();
-      track.mode = shouldShow ? 'showing' : 'disabled';
-      // console.log('[SubtitleInit] Track found:', tLang, '->', shouldShow ? 'showing' : 'disabled');
-    });
+    initSubtitleLang();
   }
 
   selectLang(props.defaultLang);
@@ -607,7 +800,6 @@ function prepareVideoPlayer(link) {
   video.value.currentTime = props.progress;
   // Chrome-like: update menu whenever track mode changes
   video.value.textTracks.addEventListener('change', updateLangMenuState);
-  initVideo(); // Init controls etc.
 }
 
 
@@ -875,7 +1067,7 @@ const mutationObserver = (mutationsList, observer) => {
             <span data-lang="${ src.lang }">${src.label || src.lang.toUpperCase()}</span>
             <span class="icon">${renderIcon()}</span>
           `;
-          if (src.lang === currentLang.value) li.classList.add('active');
+          if (src.lang === currentAudioLang.value) li.classList.add('active');
           li.addEventListener('click', () => {
             audioCol.querySelectorAll('li').forEach(el => el.classList.remove('active'));
             li.classList.add('active');
@@ -894,14 +1086,10 @@ const mutationObserver = (mutationsList, observer) => {
 
           if (sub.lang === currentSubtitleLang.value) li.classList.add('active');
           li.addEventListener('click', () => {
-            Array.from(video.value?.textTracks || []).forEach(track => {
-              const tLang = (track.language || track.srclang || '').toLowerCase();
-              track.mode = tLang === sub.lang.toLowerCase() ? 'showing' : 'disabled';
-            });
-            subCol.querySelectorAll('li').forEach(el => el.classList.remove('active'));
-            li.classList.add('active');
-            menu.style.display = 'none';
-            currentSubtitleLang.value = sub.lang;
+            currentSubtitleLang.value = sub.lang
+            sessionStorage.setItem(sessionSubtitleLang, sub.lang)
+            applySubtitleTrack(sub.lang)
+            menu.style.display = 'none'
           });
           subCol.appendChild(li);
         });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@grfzhl/vue-hls-player",
   "private": false,
-  "version": "1.1.24",
+  "version": "1.1.26",
   "type": "module",
   "files": [
     "dist"