import 'package:flutter/material.dart'; import '../mpv/mpv.dart'; import '../models/plex_metadata.dart'; import '../screens/video_player_screen.dart'; import '../services/settings_service.dart'; /// Navigates to the VideoPlayerScreen with instant transitions to prevent white flash. /// /// This utility function provides a consistent way to navigate to the video player /// across the app, using PageRouteBuilder with zero-duration transitions to eliminate /// the white flash that occurs with MaterialPageRoute. /// /// Parameters: /// - [context]: The build context for navigation /// - [metadata]: The Plex metadata for the content to play /// - [preferredAudioTrack]: Optional audio track to select on playback start /// - [preferredSubtitleTrack]: Optional subtitle track to select on playback start /// - [preferredPlaybackRate]: Optional playback speed to set on playback start /// - [selectedMediaIndex]: Optional media version index to use; if not provided, /// loads the saved preference for the series/movie. Defaults to 0 if no preference exists. /// - [usePushReplacement]: If true, replaces current route instead of pushing; /// useful for episode-to-episode navigation. Defaults to false. /// /// Returns a Future that completes with a boolean indicating whether the content /// was watched, or null if navigation was cancelled. Future navigateToVideoPlayer( BuildContext context, { required PlexMetadata metadata, MpvAudioTrack? preferredAudioTrack, MpvSubtitleTrack? preferredSubtitleTrack, double? preferredPlaybackRate, int? selectedMediaIndex, bool usePushReplacement = false, }) async { // Extract navigator before any async operations final navigator = Navigator.of(context); // Load saved media version preference if not explicitly provided int mediaIndex = selectedMediaIndex ?? 0; if (selectedMediaIndex == null) { try { final settingsService = await SettingsService.getInstance(); final seriesKey = metadata.grandparentRatingKey ?? metadata.ratingKey; final savedPreference = settingsService.getMediaVersionPreference( seriesKey, ); if (savedPreference != null) { mediaIndex = savedPreference; } } catch (e) { // Ignore errors loading preference, use default } } final route = PageRouteBuilder( pageBuilder: (context, animation, secondaryAnimation) => VideoPlayerScreen( metadata: metadata, preferredAudioTrack: preferredAudioTrack, preferredSubtitleTrack: preferredSubtitleTrack, preferredPlaybackRate: preferredPlaybackRate, selectedMediaIndex: mediaIndex, ), transitionDuration: Duration.zero, reverseTransitionDuration: Duration.zero, ); if (usePushReplacement) { return navigator.pushReplacement(route); } else { return navigator.push(route); } }