Gumlet Flutter SDK

A Flutter plugin project wrapping the Native Gumlet Video Player SDKs for Android and iOS.

Installation

Add this plugin to your Flutter application's pubspec.yaml. You can include it via file path or direct git dependency if pushed.

Android Setup

The Android setup is fully automated. The plugin uses the private Maven repository hosted by Gumlet to pull the com.gumlet.video:player dependency. Ensure your application's android/app/build.gradle has a minSdkVersion of at least 24.

iOS Setup

The iOS setup is also fully automated. The plugin vendors the GumletVideoPlayer precompiled XCFramework. Ensure your iOS deployment target is at least iOS 13.0 inside ios/Podfile.

Usage

Import the package and drop the GumletPlayer widget securely anywhere within your Flutter layout natively:

import 'package:gumlet_video_player/gumlet_video_player.dart';

GumletPlayer(
  videoUrl: 'https://video.gumlet.io/YOUR_VIDEO_ID/main.m3u8',
  autoPlay: true,
  showControls: true,
  drmLicenseUrl: 'https://fairplay.gumlet.com/licence/123XYZ...', // Widevine or FairPlay URL
  certificateUrl: 'https://fairplay.gumlet.com/certificate/123XYZ...', // Apple FairPlay only
)

Parameters

Parameter	Type	Required	Default	Description
`videoUrl`	`String`	Yes	-	The raw video playback URL. Works natively with `m3u8` (HLS), `mpd` (DASH), and `mp4` formats.
`autoPlay`	`bool`	No	`true`	When set to true, the configured video instantly attempts playback immediately on mount.
`showControls`	`bool`	No	`true`	Visually toggles the native platform player OS-specific playback controls overlay ON/OFF.
`drmLicenseUrl`	`String?`	No	`null`	The DRM License URL mapping strictly to Widevine (Android API) or FairPlay (Apple API). Provide this to instantly unencrypt DRM-protected streams natively.
`certificateUrl`	`String?`	No	`null`	The Apple Fairplay Certificate Endpoint. Required on iOS only if utilizing DRM streams. Safe to continually pass on Android as it gracefully ignores this iOS-only parameter.

Apple iOS Simulator DRM Warning: Apple natively blocks all instances of FairPlay DRM playback securely inside Desktop Simulators, as they lack physical Secure Enclaves. Therefore, attempting DRM video in an iOS simulator heavily results in a guaranteed black screen rejection error. Run directly utilizing real iPhone hardware to debug DRM. Widevine plays reliably on Android Emulators seamlessly.