feat: Add subtitle sync ui for easy alignment

src/components/playback/playbackmanager.js

@@ -29,6 +29,7 @@ import { MediaError } from 'types/mediaError';
 import { getMediaError } from 'utils/mediaError';
 import { toApi } from 'utils/jellyfin-apiclient/compat';
 import { bindSkipSegment } from './skipsegment.ts';
+import { TICKS_PER_SECOND } from 'constants/time';
 
 const UNLIMITED_ITEMS = -1;
 
@@ -1640,6 +1641,50 @@ export class PlaybackManager {
             return index !== -1 && self.isSubtitleStreamExternal(index, player);
         };
 
+        /**
+         * Gets the current subtitle track events in a normalized format.
+         * This method attempts to get subtitle events from either:
+         * 1. The player's getCurrentTrackEvents method (for Jellyfin events)
+         * 2. The player's getTextTracks method (for VTT cues)
+         *
+         * @param {Object} player - The player instance to get subtitle events from
+         * @returns {Array<{startTime: number, endTime: number, text: string}>|null} An array of normalized subtitle events or null if none found
+         */
+        self.getCurrentSubtitleTrackEvents = function (player) {
+            player = player || self._currentPlayer;
+
+            // Try to get events using the new method
+            if (player && player.getCurrentTrackEvents) {
+                const events = player.getCurrentTrackEvents();
+                if (events && events.length) {
+                    // Convert ticks to seconds format
+                    return events.map(event => ({
+                        startTime: event.StartPositionTicks / TICKS_PER_SECOND,
+                        endTime: event.EndPositionTicks / TICKS_PER_SECOND,
+                        text: event.Text || ''
+                    }));
+                }
+            }
+
+            // Try to get text tracks using the player's getTextTracks method
+            if (player && player.getTextTracks) {
+                const textTracks = player.getTextTracks();
+                if (textTracks && textTracks.length > 0) {
+                    const activeTrack = textTracks[0]; // Get the first active track
+                    if (activeTrack && activeTrack.cues && activeTrack.cues.length > 0) {
+                        // Convert VTTCues to our format
+                        return Array.from(activeTrack.cues).map(cue => ({
+                            startTime: cue.startTime,
+                            endTime: cue.endTime,
+                            text: cue.text || ''
+                        }));
+                    }
+                }
+            }
+
+            return null;
+        };
+
         self.seek = function (ticks, player) {
             ticks = Math.max(0, ticks);