This guide will walk you through the steps for adding a Kaltura video player to your iOS mobile application. You’ll learn how to import the SDK, find the necessary credentials, and load the player with your Entry ID of choice. Because the player is focused on performance and giving you the simplest integration possible, it does not contain a UI. That being said, this guide will show you how to listen to events in order to manage the player state, as well as examples for adding play/pause buttons and a slider to the player.
Lastly, this guide will cover how to add plugins to the application, specifically the Kaltura Video Analytics plugin.
You’ll need two things:
- Your Kaltura Partner ID, which can be found in the KMC under Settings>Integration Settings
- Any video entry, which can be found in the KMC as well.
You’ll need to install a few Kaltura pods. Consider this sample Podfile
- The Playkit Pod is made up of the core Player infrastructure
- The PlatKitProviders Pod adds the Media Entry Providers, which are responsible from bringing in media data from Kaltura
If you don’t already have a Podfile, go to your project directory and run
pod init. This will create a new Podfile for you, where you should add the desired pods (see example above) and then run
pod install from the command line. You might need to close and reopen Xcode.
The code below will cover a few functions needed in order to get the bare bones of a kaltura player, as well as a few additional steps regarding implementing your player UI and adding plugins.
In the Controller, import the relevant Kaltura Libraries
Set your partner ID and entry ID
The Kaltura Session is an authorization string that identifies the user watching the video. Including a Kaltura Session (KS) in the player allows for monitoring and analytics of the video, as well as the ability to restrict content access. The KS would generally be created on the server side of the application, and passed to the controller.
However, if your application does not already create a Kaltura Session, follow this guide to learn how to generate a KS with the Application Token API.
Inside the class, below the
ks declaration, add a declaration for the Player.
Now lets create our video player. Head over to the Storyboard and create a new PlayerView of the desired size. Add a referencing outlet to your ViewController named playerContainer. Create a new function called
playerSetup and set the player variable to equal the new playerContainer
Now in the
viewDidLoad function, load the player. We’ll start without a pluginConfig, but we will cover adding plugins later in this guide.
Next, call the newly created setupPlayer function.
Now create and call a new function called
In the loadMedia function, you’ll use the
Now set your entry ID on that
Load the media by creating a
MediaConfig with a video start time of zero seconds, and then passing that config to
loadMedia function should now look like this:
At this point, you should be able to successfully run the code and see your video player in the app. Your code would look like this:
You’ve probably noticed that there are no buttons for playing or pausing the video. To learn about adding elements to the Player’s UI, click here
The Kaltura Player SDK also offers various plugins for iOS that can be added to the player. Learn more here.