Getting Started

Welcome to the Inkrypt Video Player Flutter SDK: a Flutter plugin for DRM-protected video playback, built on top of the native Inkrypt Video Player SDKs for iOS and Android.

This guide covers everything you need to know before writing a single line of code.


How It Works

The Flutter SDK wraps the native iOS and Android Inkrypt Video Player SDKs using Flutter's platform view mechanism. Video rendering, DRM decryption, and the built-in player UI all happen on the native layer. The Dart layer exposes a widget and a controller API to load videos and control playback from Flutter.


Requirements

Flutter

RequirementMinimum Version
Flutter3.3.0
Dart SDK3.2.6

Verify your Flutter installation:

flutter doctor

Android

RequirementValue
Minimum Android SDK25 (Android 7.1)
Target Android SDK34
Kotlin VersionBelow 2.0.0

iOS

RequirementMinimum Version
iOS Deployment Target16.1
Xcode15.3
macOS (development machine)Sonoma 14.5+
Swift5.9+
CocoaPodsLatest stable

Why iOS 16.1? The native iOS SDK uses modern FairPlay DRM APIs that require iOS 16.6 as the minimum deployment target.

Physical device required: FairPlay DRM, the content protection system used by this SDK, is not supported on the iOS Simulator. You must test on a real iPhone or iPad.


Prerequisites

Android

Before continuing, ensure you have:

  • Android Studio Koala (2024.1.1) or later — Download
  • A physical or emulated Android device running API 25+

iOS

Before continuing, ensure all of the following are in place:

  1. Xcode 15.3 or later

Download from the Mac App Store or developer.apple.com/download. After installation, open Xcode at least once to complete the initial component setup.

  1. Xcode Command Line Tools

Open Terminal and run:

xcode-select --install

Then verify:

xcode-select -p 
# Expected output: /Applications/Xcode.app/Contents/Developer

After installation, open Xcode → Settings → Locations and confirm the Command Line Tools dropdown is set to your installed version.

  1. CocoaPods

The iOS integration uses CocoaPods to link the native framework. Install it with:

sudo gem install cocoapods

Verify:

pod --version
  1. A physical iOS device

Required for all DRM video playback testing. The iOS Simulator does not support FairPlay DRM.

Connect your device, unlock it, and tap Trust This Computer if prompted.