AMP Core

Akamai Adaptive Media Player is a media player for iOS and tvOS. Akamai AMP can manage different plugins like Chromecast Playback, Akamai Media Analytics, Playback Statistics, Facebook Audience Network, ComScore, and VR.

This is the main module, it takes the AVPlayer and augments its functionality to provide proper event notifications, using a well defined and documented protocol stating what events exist and what they are all about. It also ships with a custom UI

Installation

Import the AmpCore.framework into your project to manage basic playback and its related functions like ID3 Tracks, Multi-Language and Closed Captions support. Note: Make sure to add the frameworks as Embedded Binaries or you’ll get an error about a missing image.

How to Use

To initialize the Core and use basic playback, first import the required frameworks and make sure to implement the PlayerEventObserver protocol on your View Controller

import UIKit
import AmpCore
class ViewController: UIViewController, PlayerEventObserver {

Then, let’s add the AMP Player variable in our UIViewController:

var ampPlayer: AmpPlayer!

And it’s time to instantiate it now in your viewDidLoad function:

override func viewDidLoad() {
    super.viewDidLoad()
    self.ampPlayer = AmpPlayer(parentView: self.view)
    self.ampPlayer.setLicense(license)
    self.ampPlayer.registerObserver(self)
    self.ampPlayer.play(url: YOUR_VIDEO_URL)
}

The previous initializes the player, sets the license, registers the class as an observer and then starts handling the stream, this will not start your playback, there are a couple of ways you can implement autoplay in our player. The first way is to simply set the autoplay property of the AmpPlayer’s instance to true:

self.ampPlayer.autoplay = true

The other way to accomplish autoplay in our play is to listen to the onBufferingStateChanged and check for the state BufferingState.ready, then you would proceed to call play in your AmpPlayer instance:

func onBufferingStateChanged(_ ampPlayer: AmpPlayer) {
   if (ampPlayer.bufferingState == BufferingState.ready) {
      // Here we use the manual way to achieve autoplay
      ampPlayer.play()
   }
}

Setting up the player

The following variables and methods can be used the player set up.

Variables

Methods

Setters

Playback

These are the variables and methods used specifically to configure media playback:

Variables

Methods

Visualization

These are the visualization related variables and methods

Variables

Methods

Notifications

These methods handle the notifications on player events

Miscellaneous

These variables can assist with AMP related tasks

Variables