Nowtilus IOS Demo App Documentation
This document guides in using the Nowtilus IOS Demo App.
Home Screen
In the home screen, the SSAI URL should be provided in the allocated text box. If it is a live stream, switch on the live button and click on the play button to load the media. If it is a VOD, switch off the live button and click on the play button to load the media. Once you click on the play button, screen 2 will appear where we can see the video player and ad information.
Player Screen
This screen contains four different views as shown in the image.
The first view on the top contains the ad tracking information like tracking urls.
The second view in the middle of the screen contains the AV Player and its player controls.
The third view contains the functionalities like Ad Ends in, Click Ad and Skip Ad. In this, Ad Ends in text view shows the ad remaining time in seconds. As the ad progresses, the time reduces and the timer will get to 0 when the ad ends. Click Ad is a button which when clicked will redirect the user to safari browser and it opens the Ad Click Through url of that ad. Skip Ad button helps to skip the ads in VOD streams. This button will be enabled after 5 seconds from the ad start. Currently this functionality is disabled for live streams.
The fourth view contains the current playing ad information like Ad Event, Ad Number, Ad Title and Ad ID.
List of Ad Events:
adCueTimelineAdded
adCueTimelineStart
adImpression
adStarted
adFirstQuartile
adMidpoint
adThirdQuartile
adComplete
adCueTimelineEnd
Stream URL Types
Live:
This app can handle multiple live URLs like - Resolver, View, Master.m3u8 and Audio only. Based on the input URL given, the app will internally classify the URL and fetch the data accordingly.
Sample Live Stream URLs:
Master.m3u8: http://audio.enfqb0aqbtg3cwet.germanywestcentral.azurecontainer.io:3001/hls/master.m3u8
VOD:
A curl request to the VOD URL will be made and response of this request will be passed to the MediaMelon SDK for Ad detection.
UI Elements
This section helps in understanding how the screen layouts are arranged for modifications.
Home Screen
View Controller file of this screen is called as ViewController. The layout of the screen looks like below:
In addition to the above layout, in the ViewController file, labels for Title
, Version
, URL Title
and Live Text
are added. The positioning and the fit of all these elements are handled in the viewDidLoad
function of the ViewController file. OnClick
action for the play button is also handled in this file. In this onClick
action, stream url
and isLive
variables will be assigned with the values taken from the user.
Player Screen
View Controller file of this screen is called as SecondViewController. The layout of the screen looks like below:
Inside the main view of this screen, total 4 individual views are added as shown in the above image. Positions and arrangements of all these views and elements are handled in a function called arrangeTheScreenViews
inside the SecondViewController file.
Ad Events Info
Ad events info is being assigned to the UI inside the notifyMMSSAIAdEvents
function of this file.
Handling Click Ad
Button
Click Ad
Button In this, Ad Click Through url is fetched from the SSAIAdManger and the same will be opened in the safari browser. The player will be paused when user clicked on the button and the player will be resumed when user came back to the application from browser.
At the same time, when user clicked on the Ad, adClickTrackingUrls
will be fired from the SSAIAdManger.
Handling Skip Ad
Button
Skip Ad
ButtonThe skip ad button will be enabled after 5 seconds of the Ad Start for VOD streams. This button is disabled for live streams as of now.
Handling Ad Remaining Time TextView
Ad remaining time is calculated as the difference between adEndTime
and currentPlayerPosition
. The function named notifyAdRemainingTime
will be called 2 times in every second from the SSAIAdManger using delegates to update the ad remaining time.
Last updated