AVPlayer (Cocoapods)
This guide provides detailed instructions on integrating the MediaMelon Player SDK into an iOS Media Player Application.
Step 0: Creating AVPlayer based media player application
Create a directory for integration by doing the following. Open the terminal, change directory to the home directory, and create a folder sampleintegration
cd ~/
mkdir sampleintegration
cd sampleintegration/
Pull the Sample Application from https://sdk.mediamelon.com/$CustomerID/SampleAVPlayerWithFreeWheelAds.zip
and unzip it
wget https://sdk.mediamelon.com/$CustomerID/SampleAVPlayerWithFreeWheelAds.zip
Get the sample app dependencies by changing the directory to the ~/sampleintegration/SampleAVPlayerWithFreeWheelAds
and execute the following commands
Step 1: Building the MediaMelonSmartStreaming Framework
Execute the following two commands on the terminal in the folder ~/sampleintegration/SampleAVPlayerWithFreeWheelAds
sudo gem install cocoapods
pod init
touch Podfile
open Podfile
Edit the Podfile
target 'SwiftDemo' do
# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
pod 'MediaMelon-AVPlayer-iOS'
# Pods for SwiftDemo
end
Finally, install the pod pod install
Step 2: Integrating the MediaMelonSmartStreaming Framework
There are five steps involved for integrating the MediaMelon Player SDK using the MediaMelonSmartStreaming Framework:
Importing the framework
Providing asset information for the content before starting the player and after creating its instance
Cleaning up the SDK integration session
Disable manifest fetching by the SDK
Passing FWContext object
Open the project file ~/sampleintegration/SampleAVPlayerWithFreeWheelAds/SwiftDemo.workspace
in XCode and edit the file DemoViewController.swift
as mentioned below
1. Import Frameworks
import AVFoundation
import MediaMelonSmartStreaming
2. Provide Asset information
private func configureMMSDKWithURL(hlsURLStr: String, player: AVPlayer) {
//Integration Step 2
print("Integrating with \(String(describing: AVPlayerIntegrationWrapper.getVersion()))")
AVPlayerIntegrationWrapper.shared.enableLogTrace(logStTrace: true)
let assetInfo = MMAssetInformation(assetURL: hlsURLStr, assetID: String(arc4random()), assetName: "assetNameRandom", videoId: "VIDEO_ID")
// Optional Asset metadata
assetInfo.setContentType("Movie") //Type of content (Movie / Special / Clip / Scene)
assetInfo.setDrmProtection("Fairplay") //Widevine, Fairplay, Playready etc. Unknown means content is protected, but protection type is unknown. For clear contents, do not set this field
assetInfo.setEpisodeNumber("10") //Sequence Number of the Episode (string).
assetInfo.setSeriesTitle("testSeries") //Title of the series
assetInfo.setSeason("testSeason") //Season For example - Season1,2,3 etc
assetInfo.setGenre("testGenre") //Genre of the content
// Optional custom metadata
assetInfo.addCustomKVP("CustomKVP1Key", "CustomKVP1Value")
assetInfo.addCustomKVP("CustomKVP2Key", "CustomKVP2Value")
assetInfo.setQBRMode(.QBRModeDisabled, withMetaURL: nil)
let registrationInfo = MMRegistrationInformation(customerID: "<your_customer_id>", playerName: "<player_name>")
registrationInfo.setPlayerInformation(brand: "<player_brand>", model: "<player_model>", version: "<player_version>")
registrationInfo.setSubscriberInformation(subscriberID: "<subscriber_id>", subscriberType: "<subscriber_type>", subscriberTag: "SubscriberTAG")
AVPlayerIntegrationWrapper.initializeAssetForPlayer(assetInfo: assetInfo, registrationInformation: registrationInfo, player: player)
//End of integration Step 2
}
3. Cleaning up the SDK Session
AVPlayerIntegrationWrapper.cleanUp()
5. Disable manifest fetching by the SDK
If your workflow restricts the manifest to be accessible from both player and the MediaMelon Player SDK simultaneously, then, you can disable the fetch of manifest via disableManifestsFetch()
in method _configureMMSDKwithURL()
private func configureMMSDKWithURL(hlsURLStr: String) {
.
.
.
AVPlayerIntegrationWrapper.cleanUp()
AVPlayerIntegrationWrapper.disableManifestsFetch(disable: true)
AVPlayerIntegrationWrapper.initializeAssetForPlayer(assetInfo: assetInfo, registrationInformation: registrationInfo, player: player)
}
Last updated
Was this helpful?