Impulse Player

The Impulse Player makes using a video player in Flutter easy. Under the hood, the Impulse Player uses Impulse Player Android and Impulse Player iOS.

Additionally the Impulse Player contains features such as Fullscreen handling out of the box.

Features:

• Single view to show and handle the player.
• Playback quality selection.
• Playback speed selection.
• Fullscreen handling.

Installing

Flutter

In root pubspec.yaml:

  impulse_player: ^0.1.0 # Remote

Android

In android/build.gradle:

allprojects {
    repositories {
        // ...
        maven { url "https://jitpack.io" }
    }
}

iOS

In ios/Podfile:

pod 'impulse_player_ios'

Usage

Create the controller:

final ImpulsePlayerController _controller = ImpulsePlayerController();

Use the ImpulsePlayerView widget with the created controller.

ImpulsePlayerView(
    controller: _controller,
),

Commands

The main commands to use the player:

_controller.load(
    "Title",
    "Subtitle",
    "url",
)
_controller.play()
_controller.pause()
_controller.seek(0)

Getters

The values exposed by the player.

_controller.isPlaying() // Boolean, default `false`
_controller.getState() // PlayerState, default `Loading`
_controller.getProgress() // Long, default `0`
_controller.getDuration() // Long, default `0`
_controller.getError() // String?, default `null`

Delegate

Listening to events from the player.

final ImpulsePlayerController _controller = ImpulsePlayerController(
onReady: () async {
    print("ImpulsePlayer: onReady");
},
onPlay: () {
    print("ImpulsePlayer: onPlay");
},
onPause: () {
    print("ImpulsePlayer: onPause");
},
onFinish: () {
    print("ImpulsePlayer: onFinish");
},
onError: (message) {
    print("ImpulsePlayer: onError: $message");
},
);

Alternatively, each callback can be set anytime directly via the controller, such as:

_controller.onReady = () async {
   print("ImpulsePlayer: onReady");
   await _controller.load("Title", "Subtitle", "url");
};

Customization

Apply a custom appearance to customize the look of the player.

ImpulsePlayer.setAppearance(
    const TextStyle(fontSize: 16, fontFamily: "Inter", fontWeight: FontWeight.w600),
    const TextStyle(fontSize: 14, fontFamily: "Inter", fontWeight: FontWeight.w600),
    const TextStyle(fontSize: 12, fontFamily: "Inter", fontWeight: FontWeight.w400),
    const TextStyle(fontSize: 14, fontFamily: "Inter", fontWeight: FontWeight.w400),
    const TextStyle(fontSize: 10, fontFamily: "Inter", fontWeight: FontWeight.w400),
    const TextStyle(fontSize: 16, fontFamily: "Inter", fontWeight: FontWeight.w400),
    const TextStyle(fontSize: 14, fontFamily: "Inter", fontWeight: FontWeight.w400),
    const Color(0x4945FF),
);

Note: To use custom fonts its required to also add the fonts to the Android and iOS project. Otherwise the custom fonts will not work within the Impulse Player.

Android:

• Inside the assets folder, create a fonts folder if that doesn't exist yet.
• Put the fonts in there as regular: <familyName>.ttf and italic: <familyName>-<style>.ttf. For example when using the Inter font. The files will be:
  • Inter.ttf
  • Inter-Italic.ttf

iOS:

Note: Due to how Fonts are setup in iOS, using other weights than regular/bold from flutter to iOS is not possible. Therefore weights up to 500 is determined to be regular and from weight 500 and above it is determined bold.

• Add the font files to the project.
• In the Info.plist add the fonts to the Fonts provided by application key. These values should match the exact file name, including the extension.