Getting Started

Welcome to the InkryptVideos iOS SDK - a drop-in, DRM-protected video player with built-in watermarking, quality selection, chapter navigation, and live analytics.

This guide walks you through everything you need before writing a single line of code.


Minimum Requirements

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

Why iOS 16.1?
The SDK uses modern AVFoundation APIs for FairPlay DRM streaming. These APIs require iOS 16.1 as the minimum supported OS version.

Why SwiftUI?
The player view (InkryptVideoPlayerView) is a native SwiftUI View. It can be embedded into UIKit-based apps using UIHostingController - see Basic Usage → UIKit Integration - but SwiftUI must be available in your project.


Tools You Will Need

1. Xcode

Xcode is Apple's official IDE for iOS development. You must have version 15.3 or later.

Download it from one of these sources:

After installation, open Xcode at least once to complete the initial component setup. Xcode will prompt you to install additional components - click Install and wait for it to finish.


2. Xcode Command Line Tools

The Command Line Tools package is required for building Swift projects from the terminal and for certain Xcode integrations.

Open Terminal and run:

xcode-select --install

A system dialog will appear. Click Install and wait for the download to complete.

image

Verify it installed correctly:

xcode-select -p

You should see output like /Applications/Xcode.app/Contents/Developer. If you see this path, you're good to go.


3. Apple Developer Account

To run your app on a physical device (required for FairPlay DRM video playback), you need an Apple Developer account linked to Xcode.

Important: FairPlay DRM, the content protection system used by the SDK, only works on real devices. The iOS Simulator does not support FairPlay. You must have a physical iPhone or iPad to test video playback.

Sign in to Xcode:

  1. Open Xcode

  2. From the menu bar, choose Xcode → Settings… (or Xcode → Preferences… on older versions)

  3. Click the Accounts tab

  4. Click the Add Account button in the bottom-left corner

    image
  5. Select Apple ID and click Continue

  6. Enter your Apple ID and password

A free Apple ID is sufficient for development and testing on your own device. A paid Apple Developer Program membership ($99/year) is required to distribute the app via TestFlight or the App Store.


4. A Physical iOS Device

Because FairPlay DRM is required to decrypt and play videos, you must test on a real iPhone or iPad.

Requirements for the device:

  • Runs iOS 16.1 or later
  • Is trusted by your Mac (when you first connect, tap Trust on the device)

How to connect:

  1. Plug the device into your Mac using a USB or USB-C cable
  2. Unlock the device
  3. If prompted on the device, tap Trust This Computer and enter your passcode

Once connected, the device will appear in Xcode's device selector at the top of the window.

image