Refactor Native Subtitles feature. Fix playback on ios

src/assets/locales/en.json

@@ -777,8 +777,8 @@
         "refreshing": "Refreshing...",
         "empty": "There are no provided subtitles for this.",
         "notFound": "None of the available options match your query",
-        "useNativeSubtitles": "Use native video subtitles",
+        "useNativeSubtitles": "Native video subtitles",
-        "useNativeSubtitlesDescription": "May fix subtitles when casting and in PiP",
+        "useNativeSubtitlesDescription": "Broadcast subtitles for native fullscreen and PiP",
         "delayLate": "Heard audio",
         "delayEarly": "Saw caption"
       },

src/components/player/base/SubtitleView.tsx

@@ -8,6 +8,7 @@ import {
 } from "@/components/player/utils/captions";
 import { Transition } from "@/components/utils/Transition";
 import { usePlayerStore } from "@/stores/player/store";
+import { usePreferencesStore } from "@/stores/preferences";
 import { SubtitleStyling, useSubtitleStore } from "@/stores/subtitles";
 
 const wordOverrides: Record<string, string> = {
@@ -151,12 +152,17 @@ export function SubtitleRenderer() {
 
 export function SubtitleView(props: { controlsShown: boolean }) {
   const caption = usePlayerStore((s) => s.caption.selected);
-  const captionAsTrack = usePlayerStore((s) => s.caption.asTrack);
+  const source = usePlayerStore((s) => s.source);
   const display = usePlayerStore((s) => s.display);
   const isCasting = display?.getType() === "casting";
   const styling = useSubtitleStore((s) => s.styling);
+  const enableNativeSubtitles = usePreferencesStore(
+    (s) => s.enableNativeSubtitles,
+  );
 
-  if (captionAsTrack || !caption || isCasting) return null;
+  // Hide custom captions when native subtitles are enabled
+  const shouldUseNativeTrack = enableNativeSubtitles && source !== null;
+  if (shouldUseNativeTrack || !caption || isCasting) return null;
 
   return (
     <Transition animation="slide-up" show>

src/components/player/internals/VideoContainer.tsx

@@ -4,6 +4,7 @@ import { makeVideoElementDisplayInterface } from "@/components/player/display/ba
 import { convertSubtitlesToObjectUrl } from "@/components/player/utils/captions";
 import { playerStatus } from "@/stores/player/slices/source";
 import { usePlayerStore } from "@/stores/player/store";
+import { usePreferencesStore } from "@/stores/preferences";
 
 import { useInitializeSource } from "../hooks/useInitializePlayer";
 
@@ -66,13 +67,19 @@ function VideoElement() {
   const trackEl = useRef<HTMLTrackElement>(null);
   const display = usePlayerStore((s) => s.display);
   const srtData = usePlayerStore((s) => s.caption.selected?.srtData);
-  const captionAsTrack = usePlayerStore((s) => s.caption.asTrack);
   const language = usePlayerStore((s) => s.caption.selected?.language);
+  const source = usePlayerStore((s) => s.source);
+  const enableNativeSubtitles = usePreferencesStore(
+    (s) => s.enableNativeSubtitles,
+  );
   const trackObjectUrl = useObjectUrl(
     () => (srtData ? convertSubtitlesToObjectUrl(srtData) : null),
     [srtData],
   );
 
+  // Use native tracks when the setting is enabled
+  const shouldUseNativeTrack = enableNativeSubtitles && source !== null;
+
   // report video element to display interface
   useEffect(() => {
     if (display && videoEl.current) {
@@ -80,17 +87,20 @@ function VideoElement() {
     }
   }, [display, videoEl]);
 
-  // select track as showing if it exists
+  // Control track visibility based on setting
   useEffect(() => {
     if (trackEl.current) {
-      trackEl.current.track.mode = "showing";
+      trackEl.current.track.mode = shouldUseNativeTrack ? "showing" : "hidden";
     }
-  }, [trackEl]);
+  }, [shouldUseNativeTrack, trackEl]);
 
+  // Attach track when native subtitles are enabled
+  // SubtitleView handles showing custom captions when native subtitles are disabled
   let subtitleTrack: ReactNode = null;
-  if (captionAsTrack && trackObjectUrl && language)
+  if (shouldUseNativeTrack && trackObjectUrl && language) {
     subtitleTrack = (
       <track
+        ref={trackEl}
         label="P-Stream Captions"
         kind="subtitles"
         srcLang={language}
@@ -98,6 +108,7 @@ function VideoElement() {
         default
       />
     );
+  }
 
   return (
     <video