[object Object] Icon

Learn how to create, start, manage and modify Encodings

[object Object] Icon

Learn how to create, start, manage and modify Players

[object Object] Icon

Learn how to create, start, manage and modify Analyticss

Docs Home
User shortcuts for search
Focus by pressing f
Hide results by pressing Esc
Navigate via   keys

iOS / tvOS SDK

The following tutorials show you how to configure, integrate and customize your Player on iOS.

Step 1: Add the SDK to your ProjectLink Icon

Add the Player SDK to the Project Using CocoaPods

Add the following lines to the Podfile of your project while replacing Version Number with the desired version of the SDK. All available versions are listed in the cocoapod repository.

Run pod repo update to add the newly added source and run pod install to install it.

Add the Player SDK to the Project directly

As an alternative to CocoaPods, you can download the XCFramework release from our CDN. Therefore you can use the URL to the XCFramework from the podspec file in the according version in the cocoapod repositoryor using this link: (Replacing Version Number with the desired version of the SDK) https://cdn.bitmovin.com/player/ios_tvos/'Version Number'/BitmovinPlayer.zip

Then, when using Xcode, just drag and drop the downloaded XCFramework into your project.

Step 2: Setup the PlayerLink Icon

Configure the license key

Add the license key to the <dict> in Info.plist:

Alternatively you can also add the license key programmatically to the PlayerConfig via PlayerConfig.key.

Create the Player

Creating a Player instance either with a default or a custom config:

Configure the Source

Creating a SourceConfig based on a given Stream URL:

Load a Source

Load the created Source into a Player:

When there is no need to access the Source instance before loading it, it's also possible to directly load a SourceConfig into the Player.

Create a PlayerView

Create a view provided by the SDK which will be used for rendering the video:

Step 3: Configure your Player LicenseLink Icon

Allowlist Bundle Identifiers

In order to use the player in your app you have to allowlist the bundle identifier of your app for which you want to enable the player. This is a security mechanism and protects your license from being used elsewhere.

Domain allowlisting can be done in the dashboard under Player -> Licenses.


Step 4: Final ReviewLink Icon

In this tutorial you learned how to add the Bitmovin Player iOS SDK to your project, set up the player license, use the Player and how to configure it.

Now you can start having a look at the configuration options and adapt the player to your needs.

More ExamplesLink Icon

You can find many more fully functional code examples in our Github Repository.


Give us feedback