VrPlayer

What the Flutter

Crafted with passion by What the Flutter 🦜

Pub Build Status CodeFactor


Getting Started

Based on Kaltura Playkit SDK:

The VrPlayer plugin lets you play 360° and VR videos smoothly on Android and iOS platforms, delivering an immersive viewing experience with touch and device motion controls. These types of videos, commonly referred to as immersive, 360, or spherical videos, are captured by utilizing an omnidirectional camera or multiple cameras to record the entire panoramic view simultaneously.

Usage

VrPlayer(
  x: 0,
  y: 0,
  onCreated: onViewPlayerCreated,
  width: playerWidth,
  height: playerHeight,
),

You should implement onViewPlayerCreated to receive player events.

void onViewPlayerCreated(
  VrPlayerController controller,
  VrPlayerObserver observer,
) {
  _viewPlayerController = controller;
  observer
    ..onStateChange = onReceiveState
    ..onDurationChange = onReceiveDuration
    ..onPositionChange = onChangePosition
    ..onFinishedChange = onReceiveEnded;
  _viewPlayerController.loadVideo(
    videoUrl:
        'https://cdn.bitmovin.com/content/assets/playhouse-vr/m3u8s/105560.m3u8',
  );
}

VrPlayerController

The VrPlayerController can be used to change the state of a VrPlayer. Note that the methods can only be used after the VrPlayer has been created.

Method Description
loadVideo({String? videoUrl, String? videoPath}) Initializes video based on configuration. Invoke actions which need to be run on player start. Pass videoPath to load local files, or videoUrl to play files from network. Local files supports only Android.
isPlaying() Check current player state.
play() Play video.
pause() Pause video.
seekTo() Seek to position.
setVolume() Set video volume level from 0 (no sound) to 1 (max).
fullScreen() (Android only) Enable/disable fullscreen mode. On IOS you need to pass new width and height to VrPlayer widget
toggleVRMode() Switch between 360° mode and VR mode.
onSizeChanged() (Android only) Reload player when you need to change size of nativeView.
onPause() (Android only) Dispose player on pause.
onResume() (Android only) Reload player.
onOrientationChanged() (Android only) Notily player when orientation changed.

Local Files Guide (Android only)

Working with video from storage is a bit difficult than from the Internet. Follow the instructions bellow to launch local files correctly.

  1. Add <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/> to the file AndroidmManifest.xml.
  2. Request permission to read external storage from user.
  3. Call loadVideo() with correct videoPath.

License Information

All code in this project is released under the AGPLv3 license unless a different license for a particular library is specified in the applicable library path.

Contribution

This repository welcomes contributions from the community! Whether you're looking to fix bugs, improve existing features, or add new ones, we would be happy to review and merge your contributions.

Libraries

vr_player
The VrPlayer plugin lets you play 360° and VR videos smoothly on Android and iOS platforms, delivering an immersive viewing experience with touch and device motion controls. These types of videos, commonly referred to as immersive, 360, or spherical videos, are captured by utilizing an omnidirectional camera or multiple cameras to record the entire panoramic view simultaneously.