Getting started with Wowza Flowplayer iOS SDK
Update notice
This section contains documentation for the legacy version of the Wowza Flowplayer iOS SDK. To continue working with the SDK, we recommend that you migrate to version 4. The legacy version of the SDK is not actively maintained and will be retired on February 1, 2024.
This article includes an introduction to the core features of the Wowza Flowplayer SDK iOS and lists all the requirements for adding the SDK into an iOS Project. It assumes that you have basic understanding of iOS development and that you are familiar with Xcode and Swift.
The Wowza Flowplayer iOS SDK is a native media player. It's written entirely in Swift and provides an easy-to-use API that enables developers to create beautiful iOS applications that play audio and video both locally and over the Internet.
The Wowza Flowplayer iOS SDK uses AVPlayer as its core and, therefore, takes advantage of all its powerful features. The SDK supports adaptive streaming technologies such as HLS, as well as the most popular single container formats, such as MP4, MP3, AVI, and several more.
Our example apps are available open source on Github and it will help you better understand how to integrate the Wowza Flowplayer SDK iOS into your project.
Supported features
Some of the most important features of the Wowza Flowplayer iOS SDK include:
- HLS, MP4, MP3, AVI formats.
- Full screen playback and configurable device orientation management .
- Callbacks for monitoring a wide range of player events .
- IMA3 based VAST and VMAP ads .
- Customizable user interface .
Prerequisites
To be able to compile and run your application using the Wowza Flowplayer iOS SDK, the following few requirements need to be met:
Minimum iOS version
The Wowza Flowplayer iOS SDK is available to devices running iOS version 12.0+.
Dependencies
The Wowza Flowplayer iOS SDK depends on the following two dependencies:
-
Rollbar
:
1.12.14
-
Google Interactive Media Ads (IMA)
:
3.14.5
Add the SDK to your project
Once you have met all the prerequisites, you are ready to add the Wowza Flowplayer iOS SDK to your project and start developing. You can add the SDK using CocoaPods or via manual setup.
CocoaPods setup
-
Add
Flowplayer
together with its dependencies to yourPodfile
:pod 'Flowplayer', '~> 3.4.0'
-
To finalize, execute
pod install
.
Manual setup
- Download the binary framework of Wowza Flowplayer iOS SDK from here .
- As mentioned earlier, the Wowza Flowplayer iOS SDK depends on Rollbar and Google IMA which you need to download as well.
-
Next, you need to
link
and
embed
the frameworks into your target:
- Flowplayer (Main framework)
- FlowplayerCore (Supporting framework)
- Google IMA
- Rollbar
- Build your project.
Your target's Build Phases should look similar to this:
Update Info.plist
In your target's Info.plist
file, add a new string with the key FlowplayerAccessToken
and set the value to your Wowza Flowplayer access token to enable the player to play content.