[video_player] Adding support for preferred audio language

packages/video_player/video_player/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.9.6
+
+* Adds support for preferred audio language in video_player if platform supports it.
+
 ## 2.9.5
 
 * Fixes layout issue caused by `Transform.rotate` not affecting space calculation.
@@ -629,7 +633,7 @@ DefaultHttpDataSourceFactory by default.
 ## 0.9.0
 
 * Fixed the aspect ratio and orientation of videos. Videos are now properly displayed when recorded
- in portrait mode both in iOS and Android.
+  in portrait mode both in iOS and Android.
 
 ## 0.8.0
 

packages/video_player/video_player/example/pubspec.yaml

@@ -35,3 +35,7 @@ flutter:
     - assets/bumble_bee_captions.srt
     - assets/bumble_bee_captions.vtt
     - assets/Audio.mp3
+# FOR TESTING AND INITIAL REVIEW ONLY. DO NOT MERGE.
+# See https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changing-federated-plugins
+dependency_overrides:
+  video_player_platform_interface: {path: ../../../../packages/video_player/video_player_platform_interface}

packages/video_player/video_player/lib/video_player.dart

@@ -436,6 +436,11 @@ class VideoPlayerController extends ValueNotifier<VideoPlayerValue> {
           .setMixWithOthers(videoPlayerOptions!.mixWithOthers);
     }
 
+    if (videoPlayerOptions?.preferredAudioLanguage != null) {
+      await _videoPlayerPlatform.setPreferredAudioLanguage(
+          videoPlayerOptions!.preferredAudioLanguage);
+    }
+
     _textureId = (await _videoPlayerPlatform.create(dataSourceDescription)) ??
         kUninitializedTextureId;
     _creatingCompleter!.complete(null);
@@ -787,6 +792,12 @@ class VideoPlayerController extends ValueNotifier<VideoPlayerValue> {
     }
   }
 
+  /// Sets preferred audio language
+  Future<void> setPreferredAudioLanguage(String? preferredAudioLanguage) {
+    return _videoPlayerPlatform
+        .setPreferredAudioLanguage(preferredAudioLanguage);
+  }
+
   bool get _isDisposedOrNotInitialized => _isDisposed || !value.isInitialized;
 }
 

packages/video_player/video_player/pubspec.yaml

@@ -38,3 +38,7 @@ dev_dependencies:
 topics:
   - video
   - video-player
+# FOR TESTING AND INITIAL REVIEW ONLY. DO NOT MERGE.
+# See https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changing-federated-plugins
+dependency_overrides:
+  video_player_platform_interface: {path: ../../../packages/video_player/video_player_platform_interface}

packages/video_player/video_player/test/video_player_test.dart

@@ -84,6 +84,9 @@ class FakeController extends ValueNotifier<VideoPlayerValue>
   Future<void> setClosedCaptionFile(
     Future<ClosedCaptionFile>? closedCaptionFile,
   ) async {}
+
+  @override
+  Future<void> setPreferredAudioLanguage(String? preferredAudioLanguage) async {}
 }
 
 Future<ClosedCaptionFile> _loadClosedCaption() async =>

packages/video_player/video_player_android/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.8.3
+
+* Adds support for preferred audio language by passing preferredAudioLanguage string parameter (for example 'en' or 'fr') via VideoPlayerOptions when initializing VideoPlayerController.
+
 ## 2.8.2
 
 * Fixes a [bug](https://github.com/flutter/flutter/issues/164689) that can cause video to