[video_player_avplay] Add new features for DASH (#909)

Author: gin7773

packages/video_player_avplay/CHANGELOG.md

@@ -1,3 +1,14 @@
+## 0.7.0
+* Add new features for DASH video player
+  1. Support update token before and after player prepare done.
+  2. Support setting resolution, frame rate and whether to update same language code.
+  3. Support obtaining streaming information such as audio, video, and subtitle.
+  4. Support getting the http response header of the requested url.
+  5. Support capturing ad information in the stream.
+* Update plusplayer
+  1. [DASH] Fix the issue of incorrect duration after the stream changes from live to static.
+  2. [Common] Add protect for smpted image subtitle decoder.
+
 ## 0.6.0
 * Support multi TizenOS version.
 

packages/video_player_avplay/README.md

@@ -12,7 +12,7 @@ To use this package, add `video_player_avplay` as a dependency in your `pubspec.
 
 ```yaml
 dependencies:
-  video_player_avplay: ^0.6.0
+  video_player_avplay: ^0.7.0
 ```
 
 Then you can import `video_player_avplay` in your Dart code:

packages/video_player_avplay/example/lib/main.dart

@@ -127,23 +127,48 @@ class _DashRomoteVideo extends StatefulWidget {
 
 class _DashRomoteVideoState extends State<_DashRomoteVideo> {
   late VideoPlayerController _controller;
+  // Optional
+  final Map<StreamingPropertyType, String> _streamingProperties =
+      <StreamingPropertyType, String>{
+    StreamingPropertyType.unwantedResolution: '3840X2160',
+    StreamingPropertyType.unwantedFramerate: '60',
+    StreamingPropertyType.updateSameLanguageCode: '1',
+
+    /// update token [before] dash-player prepare done.
+    StreamingPropertyType.dashToken: 'YWJyVHlwZT1CUi1BVkMtREFTSC',
+    StreamingPropertyType.openHttpHeader: 'TRUE',
+  };
 
   @override
   void initState() {
     super.initState();
     _controller = VideoPlayerController.network(
       'https://dash.akamaized.net/dash264/TestCasesUHD/2b/11/MultiRate.mpd',
       formatHint: VideoFormat.dash,
+      streamingProperty: _streamingProperties,
     );
 
     _controller.addListener(() {
       if (_controller.value.hasError) {
         print(_controller.value.errorDescription);
       }
+      if (_controller.value.hasAdInfo) {
+        print(_controller.value.adInfo);
+      }
       setState(() {});
     });
     _controller.setLooping(true);
-    _controller.initialize().then((_) => setState(() {}));
+    _controller.initialize().then((_) {
+      setState(() {});
+      // update token [after] dash-player prepare done.
+      _controller.updateDashToken('YWJyVHlwZT1CUi1BVkMtREFTSC');
+      // New features: get the following properties.
+      _controller.getStreamingProperty(StreamingPropertyType.audioStreamInfo);
+      _controller
+          .getStreamingProperty(StreamingPropertyType.subtitleStreamInfo);
+      _controller.getStreamingProperty(StreamingPropertyType.videoStreamInfo);
+      _controller.getData(<DashPlayerProperty>{DashPlayerProperty.httpHeader});
+    });
     _controller.play();
   }
 

packages/video_player_avplay/lib/src/ad_info_from_dash.dart

@@ -0,0 +1,95 @@
+// Copyright 2025 Samsung Electronics Co., Ltd. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'package:flutter/foundation.dart' show immutable, objectRuntimeType;
+
+/// Ad information class for DASH. This class contains all the necessary information about an ad.
+@immutable
+class AdInfoFromDash {
+  /// Create a new instance of [AdInfoFromDash].
+  const AdInfoFromDash({
+    required this.adId,
+    required this.cancelIndicator,
+    required this.startTime,
+    required this.endTime,
+    required this.durationTime,
+    required this.outOfNetworkIndicator,
+  });
+
+  /// The unique identifier for the ad event from DASH.
+  final int adId;
+
+  /// When set to "true", indicates that a previously sent segmentation event, has been cancelled.
+  final bool cancelIndicator;
+
+  /// The start time of the ad in milliseconds.
+  final int startTime;
+
+  /// The end time of the ad in milliseconds.
+  final int endTime;
+
+  /// The duration of the ad in milliseconds.
+  final int durationTime;
+
+  /// When set to "1", indicates that the splice event is AD insert start time point, AD start time, end time and Duration are valid.
+  /// When set to "0",  indicates that the splice event is AD end time point, only end time is valid.
+  final int outOfNetworkIndicator;
+
+  /// Parse the ad information from a map. Returns null if the map is null or empty. Otherwise, returns a new instance of [AdInfoFromDash].
+  static AdInfoFromDash? fromAdInfoMap(Map<Object?, Object?>? adInfo) {
+    if (adInfo!.isNotEmpty) {
+      final int adId = adInfo['id']! as int;
+      final int startTime = adInfo['start_ms']! as int;
+      final int endTime = adInfo['end_ms']! as int;
+      final int durationTime = adInfo['duration_ms']! as int;
+      final int outOfNetworkIndicator =
+          adInfo['out_of_network_indicator']! as int;
+      final bool cancelIndicator = adInfo['cancel_indicator']! as bool;
+
+      return AdInfoFromDash(
+        adId: adId,
+        cancelIndicator: cancelIndicator,
+        startTime: startTime,
+        endTime: endTime,
+        durationTime: durationTime,
+        outOfNetworkIndicator: outOfNetworkIndicator,
+      );
+    }
+
+    return null;
+  }
+
+  @override
+  String toString() {
+    return '${objectRuntimeType(this, 'AdInfoFromDash')}('
+        'adId: $adId, '
+        'cancelIndicator: $cancelIndicator, '
+        'startTime: $startTime, '
+        'endTime: $endTime, '
+        'durationTime: $durationTime, '
+        'outOfNetworkIndicator: $outOfNetworkIndicator)';
+  }
+
+  @override
+  bool operator ==(Object other) =>
+      identical(this, other) ||
+      other is AdInfoFromDash &&
+          runtimeType == other.runtimeType &&
+          adId == other.adId &&
+          cancelIndicator == other.cancelIndicator &&
+          startTime == other.startTime &&
+          endTime == other.endTime &&
+          durationTime == other.durationTime &&
+          outOfNetworkIndicator == other.outOfNetworkIndicator;
+
+  @override
+  int get hashCode => Object.hash(
+        adId,
+        cancelIndicator,
+        startTime,
+        endTime,
+        durationTime,
+        outOfNetworkIndicator,
+      );
+}