Gumlet Video Player - Flutter Integration Demo

This repository serves as a complete, referenceable standalone sample demonstrating how to integrate the gumlet_video_player Flutter plugin seamlessly into your own applications.

Prerequisites & Installation

To add the SDK to your Flutter project, open your terminal and simply run:

flutter pub add gumlet_video_player

Because this plugin utilizes deeply native C-bridges (AVPlayer & ExoPlayer SDKs), you must ensure your app's core bounds meet the required targets:

1. For iOS (ios/Podfile)
Set your deployment minimum to iOS 13 by uncommenting and altering the second line:

platform :ios, '13.0'

2. For Android (android/app/build.gradle)
Set your minimum SDK boundaries to 24:

defaultConfig {
    ...
    minSdkVersion 24
}

Immediate Implementation

Gumlet automatically builds both the iOS and Android video textures. Simply drop the GumletPlayer widget natively into any build configuration:

import 'package:gumlet_video_player/gumlet_video_player.dart';

GumletPlayer(
    videoUrl: 'https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8',
    showControls: true,
    autoPlay: true,
)

Security & DRM Streaming

Gumlet Video Player is strictly built to interpret streaming keys mapped to Apple's FairPlay and Google's Widevine.

The plugin intelligently binds these differently per platform underneath the widget structure. For cross-platform DRM, integrate the endpoints directly:

GumletPlayer(
    videoUrl: 'https://video.gumlet.io/123XYZ/main.m3u8',
    
    // License mapping works instantly on both Android Widevine and iOS FairPlay endpoints.
    drmLicenseUrl: 'https://fairplay.gumlet.com/licence/123XYZ...',
    
    // (Apple FairPlay Only): Certificate endpoint 
    // Android ignores this property entirely as Widevine processes software streams.
    certificateUrl: 'https://fairplay.gumlet.com/certificate/123XYZ...',
)

Important iOS Simulators Warning: Apple explicitly enforces hardware Secure Enclaves for FairPlay decoding. You must deploy your testing bundle entirely onto an actual hardware physical iPhone. The iOS Simulator rigidly refuses FairPlay packets and will result in Failed to get CKC logs. Widevine DRM will gracefully run natively on Android Emulators seamlessly.

Exploring This Demo Locally

1. Clone this repository directly mapping our live package.
2. Run flutter pub get.
3. Select your connected Native Device.
4. Hit flutter run!