@codenkay/video-nsgplayer-core 1.0.0 → 2.0.0

package/dist/index.d.cts

@@ -5,6 +5,22 @@ type PlayerState = "idle" | "loading" | "ready" | "playing" | "paused" | "buffer
 type HlsSupportMode = "hls.js" | "native" | "unsupported";
 type QualitySelection = "auto" | number;
 type PlaybackRate = 0.5 | 0.75 | 1 | 1.25 | 1.5 | 2;
+type PlayerTextTrack = {
+    index: number;
+    id: string;
+    label: string;
+    language?: string;
+    uri?: string;
+};
+type PlayerAudioTrack = {
+    index: number;
+    id: string;
+    label: string;
+    language?: string;
+    uri?: string;
+};
+/** Runtime caption selection: off or a concrete subtitle track index. */
+type TextTrackSelection = "off" | number;
 type HlsQualityLevel = {
     index: number;
     height: number;
@@ -222,6 +238,14 @@ type PlayerEventMap = {
         selection: QualitySelection;
         label?: string;
     };
+    texttrackchange: {
+        tracks: PlayerTextTrack[];
+        selection: TextTrackSelection;
+    };
+    audiotrackchange: {
+        tracks: PlayerAudioTrack[];
+        selection: number;
+    };
     volumechange: {
         volume: number;
         muted: boolean;
@@ -390,6 +414,10 @@ type HlsEngineCallbacks = {
     onAuthRecoveryNeeded?: (reason: string) => void;
     onQualitiesChange?: (levels: HlsQualityLevel[]) => void;
     onQualitySelectionChange?: (selection: QualitySelection) => void;
+    onTextTracksChange?: (tracks: PlayerTextTrack[]) => void;
+    onTextTrackSelectionChange?: (selection: TextTrackSelection) => void;
+    onAudioTracksChange?: (tracks: PlayerAudioTrack[]) => void;
+    onAudioTrackSelectionChange?: (selection: number) => void;
     onEnded?: () => void;
 };
 type HlsEngineOptions = {
@@ -431,6 +459,11 @@ declare class HlsEngine {
     private mediaRecoveryCount;
     private qualities;
     private qualitySelection;
+    private textTracks;
+    private textTrackSelection;
+    private audioTracks;
+    private audioTrackSelection;
+    private nativeTextTrackCleanup;
     constructor(options: HlsEngineOptions);
     start(): Promise<void>;
     private startWithHlsJs;
@@ -442,7 +475,16 @@ declare class HlsEngine {
     setQuality(selection: QualitySelection): void;
     getQuality(): QualitySelection;
     getQualities(): HlsQualityLevel[];
+    getTextTracks(): PlayerTextTrack[];
+    getTextTrackSelection(): TextTrackSelection;
+    setTextTrack(selection: TextTrackSelection): void;
+    getAudioTracks(): PlayerAudioTrack[];
+    getAudioTrackSelection(): number;
+    setAudioTrack(index: number): void;
     getSupportMode(): HlsSupportMode;
+    private syncHlsSubtitleTracks;
+    private syncHlsAudioTracks;
+    private bindNativeTextTracks;
     destroy(): void;
 }
 
@@ -468,9 +510,17 @@ type VideoPlayer = {
     getQuality: () => QualitySelection;
     setQuality: (selection: QualitySelection | string) => void;
     getAvailableQualities: () => ReturnType<HlsEngine["getQualities"]>;
+    getTextTracks: () => PlayerTextTrack[];
+    getSelectedTextTrack: () => TextTrackSelection;
+    setTextTrack: (selection: TextTrackSelection) => void;
+    getAudioTracks: () => PlayerAudioTrack[];
+    getSelectedAudioTrack: () => number;
+    setAudioTrack: (index: number) => void;
     enterFullscreen: () => Promise<void>;
     exitFullscreen: () => Promise<void>;
     isFullscreen: () => boolean;
+    /** Attach fullscreen target container (host UI chrome). Zoom stays UI-only. */
+    setFullscreenElement: (el: HTMLElement | null) => void;
     reload: () => Promise<void>;
     destroy: () => void;
     getDiagnostics: () => PlayerDiagnostics;
@@ -642,4 +692,4 @@ declare function redactValue(key: string, value: unknown, seen?: WeakSet<object>
  */
 declare function redactObject(obj: Record<string, unknown>, seen?: WeakSet<object>, depth?: number): Record<string, unknown>;
 
-export { type AccessibilityConfig, type AnalyticsConfig, type AuthConfig, AuthManager, AuthParamsStore, type AuthToken, type AuthTokenProviderContext, type BufferedRange, type ControlsConfig, type CreateVideoPlayerOptions, DEFAULT_CONTROLS, DEFAULT_LIVE_EDGE_TOLERANCE_SECONDS, DEFAULT_PLAYER_BEHAVIOR, DEFAULT_PLAYER_CONFIG, DEFAULT_THEME, DEFAULT_WATERMARK, type DebugConfig, EventEmitter, type HlsQualityLevel, type HlsSupportMode, type LiveMediaSnapshot, type LoggingConfig, PACKAGE_VERSION, PLAYBACK_RATES, type PlayIconPreset, type PlaybackCredentialConfig, type PlaybackRate, type PlaybackSource, type PlaybackSourceContext, PlaybackSourceManager, type PlayerBehaviorConfig, type PlayerConfig, type PlayerDiagnostics, type PlayerError, PlayerErrorCode, type PlayerEventMap, type PlayerSkipSeconds, type PlayerState, type PlayerZoomLevel, type QualitySelection, RefreshManager, SECRET_SCAN_MAX_DEPTH, type SeekToLiveResult, type StreamingConfig, type ThemeConfig, type VideoPlayer, type WatermarkConfig, assertNoSecretsInConfig, createAuthParamsLoader, createPlayerError, createVideoPlayer, getLiveEdgeTime, isAtLiveEdge, isEncryptionKeyUrl, isPlainObject, mergePlayerConfig, redactObject, redactSensitive, redactValue, resolveBuiltinHlsLoader, rewriteHlsRequestUrl, seekToLiveEdge, themeToCssVars };
+export { type AccessibilityConfig, type AnalyticsConfig, type AuthConfig, AuthManager, AuthParamsStore, type AuthToken, type AuthTokenProviderContext, type BufferedRange, type ControlsConfig, type CreateVideoPlayerOptions, DEFAULT_CONTROLS, DEFAULT_LIVE_EDGE_TOLERANCE_SECONDS, DEFAULT_PLAYER_BEHAVIOR, DEFAULT_PLAYER_CONFIG, DEFAULT_THEME, DEFAULT_WATERMARK, type DebugConfig, EventEmitter, type HlsQualityLevel, type HlsSupportMode, type LiveMediaSnapshot, type LoggingConfig, PACKAGE_VERSION, PLAYBACK_RATES, type PlayIconPreset, type PlaybackCredentialConfig, type PlaybackRate, type PlaybackSource, type PlaybackSourceContext, PlaybackSourceManager, type PlayerAudioTrack, type PlayerBehaviorConfig, type PlayerConfig, type PlayerDiagnostics, type PlayerError, PlayerErrorCode, type PlayerEventMap, type PlayerSkipSeconds, type PlayerState, type PlayerTextTrack, type PlayerZoomLevel, type QualitySelection, RefreshManager, SECRET_SCAN_MAX_DEPTH, type SeekToLiveResult, type StreamingConfig, type TextTrackSelection, type ThemeConfig, type VideoPlayer, type WatermarkConfig, assertNoSecretsInConfig, createAuthParamsLoader, createPlayerError, createVideoPlayer, getLiveEdgeTime, isAtLiveEdge, isEncryptionKeyUrl, isPlainObject, mergePlayerConfig, redactObject, redactSensitive, redactValue, resolveBuiltinHlsLoader, rewriteHlsRequestUrl, seekToLiveEdge, themeToCssVars };

package/dist/index.d.ts

@@ -5,6 +5,22 @@ type PlayerState = "idle" | "loading" | "ready" | "playing" | "paused" | "buffer
 type HlsSupportMode = "hls.js" | "native" | "unsupported";
 type QualitySelection = "auto" | number;
 type PlaybackRate = 0.5 | 0.75 | 1 | 1.25 | 1.5 | 2;
+type PlayerTextTrack = {
+    index: number;
+    id: string;
+    label: string;
+    language?: string;
+    uri?: string;
+};
+type PlayerAudioTrack = {
+    index: number;
+    id: string;
+    label: string;
+    language?: string;
+    uri?: string;
+};
+/** Runtime caption selection: off or a concrete subtitle track index. */
+type TextTrackSelection = "off" | number;
 type HlsQualityLevel = {
     index: number;
     height: number;
@@ -222,6 +238,14 @@ type PlayerEventMap = {
         selection: QualitySelection;
         label?: string;
     };
+    texttrackchange: {
+        tracks: PlayerTextTrack[];
+        selection: TextTrackSelection;
+    };
+    audiotrackchange: {
+        tracks: PlayerAudioTrack[];
+        selection: number;
+    };
     volumechange: {
         volume: number;
         muted: boolean;
@@ -390,6 +414,10 @@ type HlsEngineCallbacks = {
     onAuthRecoveryNeeded?: (reason: string) => void;
     onQualitiesChange?: (levels: HlsQualityLevel[]) => void;
     onQualitySelectionChange?: (selection: QualitySelection) => void;
+    onTextTracksChange?: (tracks: PlayerTextTrack[]) => void;
+    onTextTrackSelectionChange?: (selection: TextTrackSelection) => void;
+    onAudioTracksChange?: (tracks: PlayerAudioTrack[]) => void;
+    onAudioTrackSelectionChange?: (selection: number) => void;
     onEnded?: () => void;
 };
 type HlsEngineOptions = {
@@ -431,6 +459,11 @@ declare class HlsEngine {
     private mediaRecoveryCount;
     private qualities;
     private qualitySelection;
+    private textTracks;
+    private textTrackSelection;
+    private audioTracks;
+    private audioTrackSelection;
+    private nativeTextTrackCleanup;
     constructor(options: HlsEngineOptions);
     start(): Promise<void>;
     private startWithHlsJs;
@@ -442,7 +475,16 @@ declare class HlsEngine {
     setQuality(selection: QualitySelection): void;
     getQuality(): QualitySelection;
     getQualities(): HlsQualityLevel[];
+    getTextTracks(): PlayerTextTrack[];
+    getTextTrackSelection(): TextTrackSelection;
+    setTextTrack(selection: TextTrackSelection): void;
+    getAudioTracks(): PlayerAudioTrack[];
+    getAudioTrackSelection(): number;
+    setAudioTrack(index: number): void;
     getSupportMode(): HlsSupportMode;
+    private syncHlsSubtitleTracks;
+    private syncHlsAudioTracks;
+    private bindNativeTextTracks;
     destroy(): void;
 }
 
@@ -468,9 +510,17 @@ type VideoPlayer = {
     getQuality: () => QualitySelection;
     setQuality: (selection: QualitySelection | string) => void;
     getAvailableQualities: () => ReturnType<HlsEngine["getQualities"]>;
+    getTextTracks: () => PlayerTextTrack[];
+    getSelectedTextTrack: () => TextTrackSelection;
+    setTextTrack: (selection: TextTrackSelection) => void;
+    getAudioTracks: () => PlayerAudioTrack[];
+    getSelectedAudioTrack: () => number;
+    setAudioTrack: (index: number) => void;
     enterFullscreen: () => Promise<void>;
     exitFullscreen: () => Promise<void>;
     isFullscreen: () => boolean;
+    /** Attach fullscreen target container (host UI chrome). Zoom stays UI-only. */
+    setFullscreenElement: (el: HTMLElement | null) => void;
     reload: () => Promise<void>;
     destroy: () => void;
     getDiagnostics: () => PlayerDiagnostics;
@@ -642,4 +692,4 @@ declare function redactValue(key: string, value: unknown, seen?: WeakSet<object>
  */
 declare function redactObject(obj: Record<string, unknown>, seen?: WeakSet<object>, depth?: number): Record<string, unknown>;
 
-export { type AccessibilityConfig, type AnalyticsConfig, type AuthConfig, AuthManager, AuthParamsStore, type AuthToken, type AuthTokenProviderContext, type BufferedRange, type ControlsConfig, type CreateVideoPlayerOptions, DEFAULT_CONTROLS, DEFAULT_LIVE_EDGE_TOLERANCE_SECONDS, DEFAULT_PLAYER_BEHAVIOR, DEFAULT_PLAYER_CONFIG, DEFAULT_THEME, DEFAULT_WATERMARK, type DebugConfig, EventEmitter, type HlsQualityLevel, type HlsSupportMode, type LiveMediaSnapshot, type LoggingConfig, PACKAGE_VERSION, PLAYBACK_RATES, type PlayIconPreset, type PlaybackCredentialConfig, type PlaybackRate, type PlaybackSource, type PlaybackSourceContext, PlaybackSourceManager, type PlayerBehaviorConfig, type PlayerConfig, type PlayerDiagnostics, type PlayerError, PlayerErrorCode, type PlayerEventMap, type PlayerSkipSeconds, type PlayerState, type PlayerZoomLevel, type QualitySelection, RefreshManager, SECRET_SCAN_MAX_DEPTH, type SeekToLiveResult, type StreamingConfig, type ThemeConfig, type VideoPlayer, type WatermarkConfig, assertNoSecretsInConfig, createAuthParamsLoader, createPlayerError, createVideoPlayer, getLiveEdgeTime, isAtLiveEdge, isEncryptionKeyUrl, isPlainObject, mergePlayerConfig, redactObject, redactSensitive, redactValue, resolveBuiltinHlsLoader, rewriteHlsRequestUrl, seekToLiveEdge, themeToCssVars };
+export { type AccessibilityConfig, type AnalyticsConfig, type AuthConfig, AuthManager, AuthParamsStore, type AuthToken, type AuthTokenProviderContext, type BufferedRange, type ControlsConfig, type CreateVideoPlayerOptions, DEFAULT_CONTROLS, DEFAULT_LIVE_EDGE_TOLERANCE_SECONDS, DEFAULT_PLAYER_BEHAVIOR, DEFAULT_PLAYER_CONFIG, DEFAULT_THEME, DEFAULT_WATERMARK, type DebugConfig, EventEmitter, type HlsQualityLevel, type HlsSupportMode, type LiveMediaSnapshot, type LoggingConfig, PACKAGE_VERSION, PLAYBACK_RATES, type PlayIconPreset, type PlaybackCredentialConfig, type PlaybackRate, type PlaybackSource, type PlaybackSourceContext, PlaybackSourceManager, type PlayerAudioTrack, type PlayerBehaviorConfig, type PlayerConfig, type PlayerDiagnostics, type PlayerError, PlayerErrorCode, type PlayerEventMap, type PlayerSkipSeconds, type PlayerState, type PlayerTextTrack, type PlayerZoomLevel, type QualitySelection, RefreshManager, SECRET_SCAN_MAX_DEPTH, type SeekToLiveResult, type StreamingConfig, type TextTrackSelection, type ThemeConfig, type VideoPlayer, type WatermarkConfig, assertNoSecretsInConfig, createAuthParamsLoader, createPlayerError, createVideoPlayer, getLiveEdgeTime, isAtLiveEdge, isEncryptionKeyUrl, isPlainObject, mergePlayerConfig, redactObject, redactSensitive, redactValue, resolveBuiltinHlsLoader, rewriteHlsRequestUrl, seekToLiveEdge, themeToCssVars };

package/dist/index.js

@@ -971,6 +971,11 @@ var HlsEngine = class {
     this.mediaRecoveryCount = 0;
     this.qualities = [];
     this.qualitySelection = "auto";
+    this.textTracks = [];
+    this.textTrackSelection = "off";
+    this.audioTracks = [];
+    this.audioTrackSelection = 0;
+    this.nativeTextTrackCleanup = null;
   }
   async start() {
     const { videoEl, playbackUrl, startMuted, volume } = this.options;
@@ -990,6 +995,7 @@ var HlsEngine = class {
       this.options.callbacks.onSupportMode?.("native");
       videoEl.src = this.options.authParams.applyToUrl(playbackUrl);
       this.bindMediaEvents();
+      this.bindNativeTextTracks();
       this.options.callbacks.onStateChange?.("ready");
       await this.applyStartPositionAndAutoplay();
       return;
@@ -1033,9 +1039,19 @@ var HlsEngine = class {
         label: level.height != null && level.height > 0 ? `${level.height}p` : `Level ${index}`
       }));
       callbacks.onQualitiesChange?.(this.qualities);
+      this.syncHlsSubtitleTracks();
+      this.syncHlsAudioTracks();
       callbacks.onStateChange?.("ready");
       void this.applyStartPositionAndAutoplay();
     });
+    this.hls.on(Hls.Events.SUBTITLE_TRACKS_UPDATED, () => {
+      if (this.destroyed) return;
+      this.syncHlsSubtitleTracks();
+    });
+    this.hls.on(Hls.Events.AUDIO_TRACKS_UPDATED, () => {
+      if (this.destroyed) return;
+      this.syncHlsAudioTracks();
+    });
     this.hls.on(Hls.Events.ERROR, (_event, data) => {
       this.handleHlsError(Hls, data);
     });
@@ -1161,12 +1177,120 @@ var HlsEngine = class {
   getQualities() {
     return this.qualities;
   }
+  getTextTracks() {
+    return this.textTracks;
+  }
+  getTextTrackSelection() {
+    return this.textTrackSelection;
+  }
+  setTextTrack(selection) {
+    if (this.destroyed) return;
+    this.textTrackSelection = selection;
+    this.options.callbacks.onTextTrackSelectionChange?.(selection);
+    if (this.supportMode === "hls.js" && this.hls) {
+      this.hls.subtitleDisplay = selection !== "off";
+      this.hls.subtitleTrack = selection === "off" ? -1 : selection;
+      return;
+    }
+    if (this.supportMode === "native" && this.options.videoEl) {
+      const tracks = this.options.videoEl.textTracks;
+      for (let i = 0; i < tracks.length; i += 1) {
+        const track = tracks[i];
+        track.mode = selection !== "off" && i === selection ? "showing" : "disabled";
+      }
+    }
+  }
+  getAudioTracks() {
+    return this.audioTracks;
+  }
+  getAudioTrackSelection() {
+    return this.audioTrackSelection;
+  }
+  setAudioTrack(index) {
+    if (this.destroyed) return;
+    if (!Number.isInteger(index) || index < 0 || this.audioTracks.length > 0 && index >= this.audioTracks.length) {
+      return;
+    }
+    this.audioTrackSelection = index;
+    this.options.callbacks.onAudioTrackSelectionChange?.(index);
+    if (this.supportMode === "hls.js" && this.hls) {
+      this.hls.audioTrack = index;
+      return;
+    }
+    if (this.supportMode === "native" && this.options.videoEl) {
+      const audioTracks = this.options.videoEl.audioTracks;
+      if (audioTracks && audioTracks.length > 0) {
+        for (let i = 0; i < audioTracks.length; i += 1) {
+          audioTracks[i].enabled = i === index;
+        }
+      }
+    }
+  }
   getSupportMode() {
     return this.supportMode;
   }
+  syncHlsSubtitleTracks() {
+    if (!this.hls) return;
+    const tracks = (this.hls.subtitleTracks ?? []).map(
+      (track, index) => ({
+        index,
+        id: String(track.id ?? index),
+        label: track.name || track.lang || `Subtitles ${index + 1}`,
+        language: track.lang
+      })
+    );
+    this.textTracks = tracks;
+    this.options.callbacks.onTextTracksChange?.(tracks);
+  }
+  syncHlsAudioTracks() {
+    if (!this.hls) return;
+    const tracks = (this.hls.audioTracks ?? []).map(
+      (track, index) => ({
+        index,
+        id: String(track.id ?? index),
+        label: track.name || track.lang || `Audio ${index + 1}`,
+        language: track.lang
+      })
+    );
+    this.audioTracks = tracks;
+    this.options.callbacks.onAudioTracksChange?.(tracks);
+    if (tracks.length > 0) {
+      this.audioTrackSelection = 0;
+      this.options.callbacks.onAudioTrackSelectionChange?.(0);
+    }
+  }
+  bindNativeTextTracks() {
+    const { videoEl } = this.options;
+    const syncFromElement = () => {
+      if (this.destroyed || this.textTracks.length > 0) return;
+      const list = videoEl.textTracks;
+      const tracks = [];
+      for (let i = 0; i < list.length; i += 1) {
+        const track = list[i];
+        if (track.kind !== "subtitles" && track.kind !== "captions") continue;
+        tracks.push({
+          index: tracks.length,
+          id: track.id || `native-${tracks.length}`,
+          label: track.label || track.language || `Track ${tracks.length + 1}`,
+          language: track.language || void 0
+        });
+      }
+      if (tracks.length === 0) return;
+      this.textTracks = tracks;
+      this.options.callbacks.onTextTracksChange?.(tracks);
+    };
+    const textTracks = videoEl.textTracks;
+    textTracks.addEventListener?.("addtrack", syncFromElement);
+    syncFromElement();
+    this.nativeTextTrackCleanup = () => {
+      textTracks.removeEventListener?.("addtrack", syncFromElement);
+    };
+  }
   destroy() {
     if (this.destroyed) return;
     this.destroyed = true;
+    this.nativeTextTrackCleanup?.();
+    this.nativeTextTrackCleanup = null;
     this.hls?.destroy();
     this.hls = null;
     const { videoEl } = this.options;
@@ -1223,11 +1347,40 @@ function createVideoPlayer(options) {
   let refreshManager = null;
   let fullscreenEl = null;
   let isLiveStream = false;
+  let mediaCleanup = null;
   const setState = (next) => {
     if (destroyed && next !== "destroyed") return;
     state = next;
     events.emit("statechange", { state: next });
   };
+  const bindMediaProgressEvents = (el) => {
+    mediaCleanup?.();
+    const onTimeUpdate = () => {
+      if (destroyed) return;
+      events.emit("timeupdate", {
+        currentTime: el.currentTime,
+        duration: Number.isFinite(el.duration) ? el.duration : 0
+      });
+    };
+    const onProgress = () => {
+      if (destroyed) return;
+      let bufferedEnd = 0;
+      try {
+        if (el.buffered.length > 0) {
+          bufferedEnd = el.buffered.end(el.buffered.length - 1);
+        }
+      } catch {
+        bufferedEnd = 0;
+      }
+      events.emit("progress", { bufferedEnd });
+    };
+    el.addEventListener("timeupdate", onTimeUpdate);
+    el.addEventListener("progress", onProgress);
+    mediaCleanup = () => {
+      el.removeEventListener("timeupdate", onTimeUpdate);
+      el.removeEventListener("progress", onProgress);
+    };
+  };
   const authManager = new AuthManager(
     options.auth,
     options.auth?.refreshBeforeExpiryMs ?? 6e4,
@@ -1278,6 +1431,7 @@ function createVideoPlayer(options) {
         isLiveStream = Boolean(source.live);
       }
       const el = ensureVideoElement();
+      bindMediaProgressEvents(el);
       engine?.destroy();
       engine = new HlsEngine({
         videoEl: el,
@@ -1336,6 +1490,30 @@ function createVideoPlayer(options) {
               label: typeof selection === "number" ? level?.label : "auto"
             });
           },
+          onTextTracksChange: (tracks) => {
+            events.emit("texttrackchange", {
+              tracks,
+              selection: engine?.getTextTrackSelection() ?? "off"
+            });
+          },
+          onTextTrackSelectionChange: (selection) => {
+            events.emit("texttrackchange", {
+              tracks: engine?.getTextTracks() ?? [],
+              selection
+            });
+          },
+          onAudioTracksChange: (tracks) => {
+            events.emit("audiotrackchange", {
+              tracks,
+              selection: engine?.getAudioTrackSelection() ?? 0
+            });
+          },
+          onAudioTrackSelectionChange: (selection) => {
+            events.emit("audiotrackchange", {
+              tracks: engine?.getAudioTracks() ?? [],
+              selection
+            });
+          },
           onEnded: () => events.emit("ended")
         }
       });
@@ -1494,6 +1672,24 @@ function createVideoPlayer(options) {
     getAvailableQualities() {
       return engine?.getQualities() ?? [];
     },
+    getTextTracks() {
+      return engine?.getTextTracks() ?? [];
+    },
+    getSelectedTextTrack() {
+      return engine?.getTextTrackSelection() ?? "off";
+    },
+    setTextTrack(selection) {
+      engine?.setTextTrack(selection);
+    },
+    getAudioTracks() {
+      return engine?.getAudioTracks() ?? [];
+    },
+    getSelectedAudioTrack() {
+      return engine?.getAudioTrackSelection() ?? 0;
+    },
+    setAudioTrack(index) {
+      engine?.setAudioTrack(index);
+    },
     async enterFullscreen() {
       const target = fullscreenEl ?? videoEl?.parentElement ?? videoEl;
       if (target && "requestFullscreen" in target) {
@@ -1510,6 +1706,9 @@ function createVideoPlayer(options) {
     isFullscreen() {
       return Boolean(document.fullscreenElement);
     },
+    setFullscreenElement(el) {
+      fullscreenEl = el;
+    },
     async reload() {
       refreshManager?.stop();
       engine?.destroy();
@@ -1518,6 +1717,8 @@ function createVideoPlayer(options) {
     destroy() {
       if (destroyed) return;
       destroyed = true;
+      mediaCleanup?.();
+      mediaCleanup = null;
       refreshManager?.stop();
       refreshManager = null;
       engine?.destroy();