video_player_videohole 0.3.0

Flutter plugin for displaying inline video on Tizen TV devices.

video_player_videohole

A fork of the video_player plugin to support playback of DRM streams (Widevine and PlayReady) on Tizen TV devices.

This plugin is only supported on Tizen TV devices. If you are targeting other types of devices or are not interested in playing DRM content in your app, use video_player and video_player_tizen instead.

Usage

To use this package, add video_player_videohole as a dependency in your pubspec.yaml file.

dependencies:
  video_player_videohole: ^0.3.0

Then you can import video_player_videohole in your Dart code:

import 'package:video_player_videohole/video_player.dart';

Note that video_player_videohole is not compatible with the original video_player plugin. If you're writing a cross-platform app for Tizen and other platforms, it is recommended to create two separate source files and import video_player and video_player_videohole in the files respectively.

Example

import 'package:flutter/material.dart';
import 'package:video_player_videohole/video_player.dart';

class RemoteVideo extends StatefulWidget {
  const RemoteVideo({Key? key}) : super(key: key);

  @override
  State<RemoteVideo> createState() => _RemoteVideoState();
}

class _RemoteVideoState extends State<RemoteVideo> {
  late VideoPlayerController _controller;

  @override
  void initState() {
    super.initState();
    _controller = VideoPlayerController.network(
      'https://media.w3.org/2010/05/bunny/trailer.mp4',
      drmConfigs: const DrmConfigs(
        type: DrmType.playready,
        licenseServerUrl:
            'http://test.playready.microsoft.com/service/rightsmanager.asmx',
      ),
    );
    _controller.addListener(() => setState(() {}));
    _controller.initialize().then((_) => setState(() {}));
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Center(
      child: AspectRatio(
        aspectRatio: _controller.value.aspectRatio,
        child: Stack(
          alignment: Alignment.bottomCenter,
          children: <Widget>[
            VideoPlayer(_controller),
            ClosedCaption(text: _controller.value.caption.text),
            GestureDetector(
              onTap: () {
                _controller.value.isPlaying
                    ? _controller.pause()
                    : _controller.play();
              },
            ),
            VideoProgressIndicator(_controller, allowScrubbing: true),
          ],
        ),
      ),
    );
  }
}

Required privileges

To use this plugin, you may need to declare the following privileges in your tizen-manifest.xml file.

<privileges>
  <privilege>http://tizen.org/privilege/mediastorage</privilege>
  <privilege>http://tizen.org/privilege/externalstorage</privilege>
  <privilege>http://tizen.org/privilege/internet</privilege>
  <privilege>http://developer.samsung.com/privilege/drmplay</privilege>
</privileges>

• The mediastorage privilege (http://tizen.org/privilege/mediastorage) is required to play video files located in the internal storage.
• The externalstorage privilege (http://tizen.org/privilege/externalstorage) is required to play video files located in the external storage.
• The internet privilege (http://tizen.org/privilege/internet) is required to play any URL from the network.
• The drmplay privilege (http://developer.samsung.com/privilege/drmplay) is required to play DRM content. The app must be signed with a partner-level certificate to use this privilege.

For detailed information on Tizen privileges, see Tizen Docs: API Privileges.

Limitations

TV emulator support is experimental. DRM content playback is not supported on TV emulators.

The following options are not currently supported.

• VideoPlayerOptions.allowBackgroundPlayback
• VideoPlayerOptions.mixWithOthers

This plugin has the following limitations.

• The httpHeaders option of VideoPlayerController.network only support 'Cookie' and 'User-Agent'.
• The setPlaybackSpeed method will fail if triggered within the last 3 seconds of the video.
• The playback speed will reset to 1.0 when the video is replayed in loop mode.
• The seekTo method works only when the playback speed is 1.0, and it sets the video position to the nearest keyframe, not the exact value passed.
• Dash sidecar subtitles are only supported on Tizen 7.0 and later.