Skip to content

Commit

Permalink
Update Bitmovin Player iOS SDK to version 2.61.0
Browse files Browse the repository at this point in the history
  • Loading branch information
stonko1994 committed Mar 2, 2021
1 parent 2d2dd37 commit 890bef6
Show file tree
Hide file tree
Showing 2 changed files with 53 additions and 21 deletions.
2 changes: 1 addition & 1 deletion Podfile
Expand Up @@ -6,7 +6,7 @@ source 'https://github.com/bitmovin/cocoapod-specs.git'
workspace 'BitmovinPlayerSamples'

def bitmovin_player
pod 'BitmovinPlayer', '2.60.0'
pod 'BitmovinPlayer', '2.61.0'
end

def google_cast
Expand Down
72 changes: 52 additions & 20 deletions README.md
@@ -1,24 +1,54 @@
# bitmovin-player-ios-samples
This repository contains sample apps which are using the Bitmovin Player iOS SDK. The following sample apps are included at the moment:
This repository contains sample apps which are using the Bitmovin Player iOS SDK.

**Table of Content**

* [Available Sample Apps](#available-sample-apps)
* [Sample Apps Setup Instructions](#sample-app-setup-instructions)
* [How to integrate the Bitmovin Player iOS SDK](#how-to-integrate-the-bitmovin-player-ios-sdk)
* [Adding the SDK To Your Project](#adding-the-sdk-to-your-project)
* [Using CocoaPods](#using-cocoapods)
* [Add the SDK directly](#adding-the-sdk-directly)
* [Prepare your Bitmovin Player License](#prepare-your-bitmovin-player-license)
* [Development Notes](#development-notes)
* [Casting Requirements](#casting-requirements)
* [Documentation & Release Notes](#documentation-and-release-notes)
* [Support](#support)

---

## Available Sample Apps

### Basics
+ **BasicPlayback:** Shows how the Bitmovin Player can be setup for basic playback of HLS or progressive streams.
+ **BasicPlaybackTV:** Shows how the Bitmovin Player can be setup for basic playback of HLS or progressive streams in a tvOS application.
+ **BasicDRMPlayback:** Shows how the Bitmovin Player can be setup and configured for playback of FairPlay Streaming protected content.
+ **BasicCasting** Shows how the ChromeCast support of the Bitmovin Player can be setup and configured.
+ **BasicPlaylist** Shows how to implement queueing / playlists.
+ **BasicMetadataHandling** Shows how the Bitmovin Player can be setup and configured for playback of content which contains metadata.
+ **CustomHtmlUi** Shows how the Bitmovin Player can be setup and configured to use a custom HTML UI. In addition this sample includes how to communication between the javascript UI and the native code.

### DRM
+ **BasicDRMPlayback:** Shows how the Bitmovin Player can be setup and configured for playback of FairPlay Streaming protected content.

### Offline Playback
+ **BasicOfflinePlayback** Shows how the Bitmovin Player can be used to download protected and unprotected content for offline playback.

### Playback & Casting
+ **BackgroundPlayback** Shows how background playback can be implemented for the Bitmovin Player (e.g. to play audio in silent mode).
+ **BasicCasting** Shows how the ChromeCast support of the Bitmovin Player can be setup and configured. (Please mind the [Casting Requirements](#casting-requirements))
+ **AdvancedCasting** Shows how to implement advanced casting use cases. (Please mind the [Casting Requirements](#casting-requirements))

### Advertising
+ **BasicAds** Shows how the Bitmovin Player can be setup and configured for playback of ads.

### UI
+ **CustomHtmlUi** Shows how the Bitmovin Player can be setup and configured to use a custom HTML UI. In addition this sample includes how to communication between the javascript UI and the native code.
+ **SystemUI** Shows how the system UI can be used instead of Bitmovin's default UI.
+ **BasicPlaylist** Shows how to implement queueing / playlists.
+ **BasicOfflinePlayback** Shows how the Bitmovin Player can be used to download protected and unprotected content for offline playback.
+ **BackgroundPlayback** Shows how background playback can be implemented for the Bitmovin Player.
+ **AdvancedCasting** Shows how to implement advanced casting use cases.
+ **BasicFullscreenHandling** Shows how to use the `BitmovinFullscreenHandler`-protocol to implement basic fullscreen handling.

## Using The Sample Apps

## Sample App Setup Instructions
Please execute `pod install --repo-update` to properly initialize the workspace. In each sample app you also have to add your Bitmovin Player license key to `Info.plist` file as `BitmovinPlayerLicenseKey`.

In addition to that you have to log in to [https://dashboard.bitmovin.com](https://dashboard.bitmovin.com), where you have to add the following bundle identifier of the sample application as an allowed domain under `Player -> Licenses`:
In addition to that you have to log in to [https://bitmovin.com/dashboard](https://bitmovin.com/dashboard), where you have to add the following bundle identifier of the sample application as an allowed domain under `Player -> Licenses`:

com.bitmovin.player.samples.playback.basic
com.bitmovin.player.samples.tv.playback.basic
Expand All @@ -34,7 +64,7 @@ In addition to that you have to log in to [https://dashboard.bitmovin.com](https
com.bitmovin.player.samples.casting.advanced
com.bitmovin.player.samples.fullscreen.basic

## Using The Bitmovin Player iOS SDK
## How to integrate the Bitmovin Player iOS SDK
When you want to develop an own iOS application using the Bitmovin Player iOS SDK read through the following steps.

### Adding the SDK To Your Project
Expand All @@ -43,30 +73,32 @@ To add the SDK as a dependency to your project, you have two options: Using Coco
#### Using CocoaPods
1. Add `source 'https://github.com/bitmovin/cocoapod-specs.git'` to your Podfile.
1. Run `pod repo update` to add the newly added source.
1. Add `pod 'BitmovinPlayer', '2.60.0'` to your Podfile.
1. Add `pod 'BitmovinPlayer', '2.61.0'` to your Podfile.
1. Install the pod using `pod install`.

See the `Podfile` of this repository for a full example.

#### Adding the SDK Directly
When using Xcode, go to the `General` settings page and add the SDK bundle (`BitmovinPlayer.framework`) under `Linked Frameworks and Libraries`. The SDK bundles for iOS and tvOS can be downloaded [here](https://cdn.bitmovin.com/player/ios_tvos/2.60.0/BitmovinPlayer.zip).
When using Xcode, go to the `General` settings page and add the SDK bundle (`BitmovinPlayer.framework`) under `Linked Frameworks and Libraries`. The SDK bundles for iOS and tvOS can be downloaded [here](https://cdn.bitmovin.com/player/ios_tvos/2.61.0/BitmovinPlayer.zip).

### Project Setup
#### Prepare your Bitmovin Player license

+ Add your Bitmovin player license key to the `Info.plist` file as `BitmovinPlayerLicenseKey`.

Your player license key can be found when logging in into [https://dashboard.bitmovin.com](https://dashboard.bitmovin.com) and navigating to `Player -> Licenses`.
Your player license key can be found when logging in into [https://bitmovin.com/dashboard](https://bitmovin.com/dashboard) and navigating to `Player -> Licenses`.

+ Add the Bundle identifier of the iOS application which is using the SDK as an allowed domain to the Bitmovin licensing backend. This can be also done under `Player -> Licenses` when logging in into [https://dashboard.bitmovin.com](https://dashboard.bitmovin.com) with your account.

When you do not do this, you'll get a license error when starting the application which contains the player.

#### Note for iOS 12
If you develop using XCode 10 targeting iOS 12 make sure you use a provisioning profile with `Access WiFi Information` enabled for the `BasicCasting` as well as for the `AdvancedCasting` sample.

#### Note for iOS 13
If you develop using XCode 11 targeting iOS 13 please make sure the `NSBluetoothAlwaysUsageDescription` key is set in the `info.plist` for both the `BasicCasting` and the `AdvancedCasting` samples.
## Development Notes
### Casting Requirements
* If you develop using **XCode 10 targeting iOS 12** make sure you use a provisioning profile with `Access WiFi Information` enabled for the `BasicCasting` as well as for the `AdvancedCasting` sample.
* If you develop using **XCode 11 targeting iOS 13** please make sure the `NSBluetoothAlwaysUsageDescription` key is set in the `info.plist` for both the `BasicCasting` and the `AdvancedCasting` samples.

## Documentation And Release Notes
- You can find the latest API documentation [here](https://bitmovin.com/ios-sdk-documentation/).
- The release notes can be found [here](https://bitmovin.com/release-notes-ios-sdk/).

## Support
If you have any questions or issues with this SDK or its examples, or you require other technical support for our services, please login to your Bitmovin Dashboard at https://bitmovin.com/dashboard and [create a new support case](https://bitmovin.com/dashboard/support/cases/create). Our team will get back to you as soon as possible :+1:

0 comments on commit 890bef6

Please sign in to comment.