iOS / tvOS SDK

Execute pod repo update first to add the new source and execute pod install after to install the new BitmovinPlayer dependency.

Copysource 'https://github.com/bitmovin/cocoapod-specs.git' pod 'BitmovinPlayer', 'Version Number'

Swift Package Manager is a tool for managing the distribution of Swift frameworks. It integrates with the Swift build system to automate the process of downloading, compiling, and linking dependencies.

Using Xcode

To integrate using Xcode 13, open your Project file and specify it in Project > Package Dependencies using the following URL:

Copyhttps://github.com/bitmovin/player-ios.git

Using Package.swift

To integrate using Apple's Swift package manager, add the following as a dependency to your Package.swift and replace the Version Number with the desired version of the SDK.

Copy.package(name: "BitmovinPlayer", url: "https://github.com/bitmovin/player-ios.git", .exact("Version Number"))

And then specify the BitmovinPlayer as a dependency of the desired Target. Here is an example of a Package.swift file:

Copylet package = Package( ... dependencies: [ .package(name: "BitmovinPlayer", url: "https://github.com/bitmovin/player-ios.git", .exact("Version Number")) ], targets: [ .target(name: "<NAME_OF_YOUR_PACKAGE>", dependencies: ["BitmovinPlayer"]) ] ... )

Limitation

Executing swift build from the command line is currently not supported. Open the Package in Xcode if you are developing another Package depending on BitmovinPlayer.

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.

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

Copy<key>BitmovinPlayerLicenseKey</key> <string>PLAYER_LICENSE_KEY</string>

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

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

Copy// Player using a default config let player = PlayerFactory.create() // Or with a explicit PlayerConfig let playerConfig = PlayerConfig() playerConfig.key = "..." // Only needed if the license key was not added to the Info.plist file let player = PlayerFactory.create(playerConfig: playerConfig)

Creating a SourceConfig based on a given Stream URL:

Copy// Create the HLS stream URL guard let streamUrl = URL(string: "https://bitmovin-a.akamaihd.net/content/MI201109210084_1/m3u8s/playlist.m3u8") else { return } // Create a SourceConfig let sourceConfig = SourceConfig(url: streamUrl, type: .hls) // Optionally set additional properties sourceConfig.title = "Art of motion"

Load the created Source into a Player:

Copy// Create a Source from the SourceConfig let source = SourceFactory.create(from: sourceConfig) player.load(source: source)

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

Copyplayer.load(sourceConfig: sourceConfig)

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

Copy// Create a PlayerView let playerView = PlayerView(player: player, frame: view.bounds) // Depending on your App layout you might want to set the autoresizingMask (recommended) playerView.autoresizingMask = [.flexibleHeight, .flexibleWidth] // Adding the view to the a container View playerContainerView.addSubview(playerView) playerContainerView.bringSubview(toFront: playerView)

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.