Flutter Bunny Video Player #

A Flutter plugin that provides a native video player implementation for Android using Bunny.net streaming services. This plugin allows you to easily integrate and play videos from your Bunny Stream library in your Flutter applications.

Platform Support #

Features #

• Native Android video player implementation
• Seamless integration with Bunny.net streaming services
• Support for both portrait and landscape orientations

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_bunny_video_player: ^1.0.1

Or install via command line:

flutter pub add flutter_bunny_video_player

Add the following Gradle configuration to your Android:

1.Go to your github profile => [Developer settings] => [Personal access token] => [Generate new token] on github.com 2.Check read:packages 3.Click Generate token 4.Copy the generated token 5.Add below lines to your ~/.gradle/gradle.properties (the path may be different on Windows) or export as environment variables:

GITHUB_ACTOR={your github id}
GITHUB_TOKEN={the generated token}

Merge below lines to your /settings.gradle (If you are using the recent version of Android Gradle Plugin)

dependencyResolutionManagement {
  repositories {
      maven {
          url = uri("https://maven.pkg.github.com/BunnyWay/bunny-stream-android")
          credentials {
              // Use environment variables for GitHub Packages authentication
              // Ensure GITHUB_ACTOR and GITHUB_TOKEN are set in your environment
              // or gradle.properties file
              username = providers.gradleProperty("gpr.user").orNull
                  ?: providers.environmentVariable("GITHUB_ACTOR").orNull
                  ?: System.getenv("GITHUB_ACTOR")
                  ?: ""
              password = providers.gradleProperty("gpr.key").orNull
                  ?: providers.environmentVariable("GITHUB_TOKEN").orNull
                  ?: System.getenv("GITHUB_TOKEN")
                  ?: ""
          }
      }
  }
}

or to your /build.gradle

allprojects {
    repositories {
      maven {
          url = uri("https://maven.pkg.github.com/BunnyWay/bunny-stream-android")
          credentials {
              // Use environment variables for GitHub Packages authentication
              // Ensure GITHUB_ACTOR and GITHUB_TOKEN are set in your environment 
              // or gradle.properties file
              username = providers.gradleProperty("gpr.user").orNull
                  ?: providers.environmentVariable("GITHUB_ACTOR").orNull
                  ?: System.getenv("GITHUB_ACTOR")
                  ?: ""
              password = providers.gradleProperty("gpr.key").orNull
                  ?: providers.environmentVariable("GITHUB_TOKEN").orNull
                  ?: System.getenv("GITHUB_TOKEN")
                  ?: ""
          }
      }
  }
}

Usage #

1. First, import the package in your Dart file:

import 'package:flutter_bunny_video_player/flutter_bunny_video_player.dart';

2. Use the BunnyPlayerView widget in your Flutter app:

SizedBox(
  height: 300, // Set desired height
  child: BunnyPlayerView(
    accessKey: 'your_bunny_stream_access_key',  // Optional
    videoId: 'your_video_id',                    // Required
    libraryId: your_library_id,                  // Required
  ),
)

Required Parameters #

• videoId (String): The ID of the video you want to play from your Bunny Stream library
• libraryId (int): Your Bunny Stream library ID

Optional Parameters #

• accessKey (String?): Your Bunny Stream access key for secured videos

Sizing #

The video player view needs to be wrapped in a container with specific dimensions (like SizedBox or Container) to properly display the video player.

Complete Example #

import 'package:flutter/material.dart';
import 'package:flutter_bunny_video_player/flutter_bunny_video_player.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Bunny Video Player Example'),
        ),
        body: const Center(
          child: SizedBox(
            height: 300,
            child: BunnyPlayerView(
              accessKey: null,  // Set to your access key if needed
              videoId: "your-video-id",
              libraryId: your_library_id,
            ),
          ),
        ),
      ),
    );
  }
}

Requirements #

• Android 8.0 (API level 26)
• Internet permission in Android Manifest

Notes #

• This plugin currently only supports Android platform
• The video player automatically handles device orientation changes
• Wrap the BunnyPlayerView in a sized container for proper display
• Ensure your Android app has the necessary permissions and configurations in the manifest file