Step by step integration of the Mediamelon Player SDK with Nowtilus SSAI with AV Player
Step 1: Get the MMGenericFramework Framework Library
Download the MMGenericFramework faremwork
Copy the MMGenericFramework framework to the AVPlayerWithNowtilusSSAI directory
If you are building for the simulator use the MMGenericFramework.framework in the iphonesimulator-x86 and which building for the device use the MMGenericFramework.framework in the iphoneos-arm64 directory
Step 2: Integrating the MMGeneric Framework with the AV Player Sample Application
There are a few steps involved for integrating the MediaMelon Player SDK using the MediaMelonSmartStreaming Framework:
Add the appropriate MMGenericFramework to the AV Player Sample Application
Add the AVPlayerIntegrationWrapper.swift file from the Wrapper directory
Provide Asset information
Add the MMSSAIAdManagerDelegate callbacks
Initializing SSAIAd Manager
Set Macro Substitution data
Stop the Ad Manager
All AV Player related code of the sample application can be found in the Swift classViewController.swift
1. Import Frameworks
import MMGenericFramework
2. Ad the AVPlayerIntegrationWrapper.swift file
This is the integration layer between the MediaMelon Framework and AV Player. This needs to be added to the project. Unless absolutely necessary , this file should not be modified.
3. Provide Asset information
After the instance of the player is create, we should set the asset information and send it to before starting its playback. In ViewController.swift, call function self.configureMMSDKwithURL(player: AVPlayer)
Add the MMSSAIManagerDelegate the ViewController class in ViewController.swift. This delegate will be used for receiving Ad related events and data. At every Ad event the Delegate will fire the notifyMMSSAIAdEventsWith function. This can be used to display Ad related data, enable or disable Ad skipping etc.
classViewController:UIViewController, MMSSAIManagerDelegate ..... func notifyMMSSAIAdEvents(eventName:MMSSAIAdSate, adInfo: MMSSAIAdDetails) {if(eventName == MMSSAIAdSate.adPlaying) { print ("Ad progress ", ((AVPlayerIntegrationWrapper.getAdPlaybackTime(adInfo: adInfo)*100)/AVPlayerIntegrationWrapper.getAdDuration(adInfo: adInfo)))
}else {print("---------------------------------------------------")print(" Ad Id :",AVPlayerIntegrationWrapper.getAdId(adInfo: adInfo))print(" Ad Title :",AVPlayerIntegrationWrapper.getAdTitle(adInfo: adInfo)) print(" Ad Index :",AVPlayerIntegrationWrapper.getAdIndex(adInfo: adInfo)," of ", AVPlayerIntegrationWrapper.getAdTotalAdsInPod(adInfo: adInfo) )
print(" Ad Server :",AVPlayerIntegrationWrapper.getAdServer(adInfo: adInfo))print(" Ad Duration :",AVPlayerIntegrationWrapper.getAdDuration(adInfo: adInfo))print(" Ad Position :",AVPlayerIntegrationWrapper.getAdPosition(adInfo: adInfo))print(" Ad Event :",eventName )if( eventName == MMSSAIAdSate.adImpression) {let clickURL = AVPlayerIntegrationWrapper.getClickThroughURL(adInfo: adInfo)let clickTrackingURL = AVPlayerIntegrationWrapper.getClickTrackingURL(adInfo: adInfo)print("Video Click URL:", clickURL)print("Video Click Tracking URL:", clickTrackingURL) }print("---------------------------------------------------") } }
Ad Events Supported
Sample output
---------------------------------------------------
Ad Id : 502180
Ad Title : Video_4
Ad Index : 1 of 1
Ad Server : VMAX
Ad Duration : 25
Ad Position : MID
Ad Event : adCueTimelineStart
---------------------------------------------------
---------------------------------------------------
Ad Id : 502180
Ad Title : Video_4
Ad Index : 1 of 1
Ad Server : VMAX
Ad Duration : 25
Ad Position : MID
Ad Event : adImpression
Video Click URL: XXXXXXXXXXXXXXX
Video Click Tracking URL: XXXXXXXXXXXXXXXXXXX
---------------------------------------------------
---------------------------------------------------
Ad Id : 502180
Ad Title : Video_4
Ad Index : 1 of 1
Ad Server : VMAX
Ad Duration : 25
Ad Position : MID
Ad Event : adStarted
---------------------------------------------------
Ad progress 4
Ad progress 8
Ad progress 12
Ad progress 16
Ad progress 20
---------------------------------------------------
Ad Id : 502180
Ad Title : Video_4
Ad Index : 1 of 1
Ad Server : VMAX
Ad Duration : 25
Ad Position : MID
Ad Event : adFirstQuartile
---------------------------------------------------
Ad progress 24
Ad progress 28
Ad progress 32
Ad progress 36
Ad progress 40
Ad progress 44
---------------------------------------------------
Ad Id : 502180
Ad Title : Video_4
Ad Index : 1 of 1
Ad Server : VMAX
Ad Duration : 25
Ad Position : MID
Ad Event : adMidpoint
---------------------------------------------------
Ad progress 48
Ad progress 52
Ad progress 56
Ad progress 60
Ad progress 64
Ad progress 68
Ad progress 72
---------------------------------------------------
Ad Id : 502180
Ad Title : Video_4
Ad Index : 1 of 1
Ad Server : VMAX
Ad Duration : 25
Ad Position : MID
Ad Event : adThirdQuartile
---------------------------------------------------
Ad progress 76
Ad progress 80
Ad progress 84
Ad progress 88
Ad progress 92
Ad progress 96
---------------------------------------------------
Ad Id : 502180
Ad Title : Video_4
Ad Index : 1 of 1
Ad Server : VMAX
Ad Duration : 25
Ad Position : MID
Ad Event : adCompleted
---------------------------------------------------
---------------------------------------------------
Ad Id : 502180
Ad Title : Video_4
Ad Index : 1 of 1
Ad Server : VMAX
Ad Duration : 25
Ad Position : MID
Ad Event : adCueTimelineEnd
---------------------------------------------------
5. Initialize the SSAI Ad Manager
Initialize the SSAI Ad Manager to track the Ads and report Ad related metric. For live stream the isLive is set to true. The below steps explains how to initialize SSAI Ad Manager without polling for vast. Incase of VOD, STEP 1 and STEP 2 are optional as we get the timeline data from source url. vodResponseData should contain the API response from the source URL.
Read the Manifest data from player API and retreive the Vast file from X-AD-VAST tag in the #EXT-X-DATERANGE metadata in the manifest file. To enable this mode there are a a few steps required
AVPlayerIntegrationWrapper.shared.initialiseSSAIAdManager(mediaUrl: self.mediaURL, isLive: self.isLive, pollForVast: false, vodResponseData: self.vodResponseData) // Poll for vast set to false used the metadatacollector for accesing manifest data
6. Set Macro Substitution Data for Tracking URLs
Provide the macro substitution data into a dictionary as shown below and send it to the AVPlayerIntegrationWrapper file.