Adaptive Media Player: iOS/tvOS SDK Guide

Document created by Herberth Alvarado Employee on May 9, 2016Last modified by Miguel Lopez Valenciano on May 22, 2017
Version 24Show Document
  • View in full screen mode

Maintainers: David Cortes Saenz & Miguel Lopez Valenciano

 

On iOS, the SDK deliverable consists of a set of iOS libraries and resource files to be integrated into an existing iOS application project and a demo player.

 

 

 

Features

The SDK is able to play live and on-demand streams using the Apple HLS streaming format, with the following features:

  • Support of multiple player instances
  • Support for DVR and seeking
  • Support of fullscreen mode and auto rotation in such mode
  • AES content encryption
  • Token authentication support
  • Adaptive bitrate
  • Hardware-accelerated playback
  • Support of Media Analytics from Akamai Media Player configuration files
  • Support for WebVTT closed captions
  • Support for progressive media downloads (MP4 format) for advertisement
  • Support for Apple Airplay.
  • Support fo ChromeCast.

 

The SDK:

  • Is already integrated with the following third party plugins:
    • Google DoubleClick for Published (DFP) – Advertisement
    • Google ChromeCast device
  • Supports almost any iOS device in the market running iOS 7.0 minimum
  • Supports closed captioning in compliance with the rules set by the Federal Communications Commission (FCC) for Internet video.

 

Modules

 

iOS

 

AmpCore

Our main module, it basically 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

Check this module’s API documentation here: AmpCore Reference

AmpIMA

Facilitates the integration of Google Interactive Media Ads, by eliminating all the boilerplate code required to setup IMA, and also the integration between IMA, AVPlayer, and the player’s view. We also provide custom IMA events and errors inspired by the ones in the AmpCore module for consistency in our SDK usage.

Check this module’s API documentation here: AmpIMA Reference

AmpFreewheel

Eases the integration of Freewheel, by eliminating all the boilerplate code required to setup Freewheel, and also the integration between Freewheel, AVPlayer, and the player’s view. We also provide custom Freewheel events and errors inspired by the ones in the AmpCore module for consistency in our SDK usage. AmpFreewheel Reference

AmpMediaAnalytics

Integrates the Akamai Media Analytics library with our AmpCore module events, meaning that default events are already handled, so leaving you the only task of specifying your custom dimensions.

Check this module’s API documentation here: AmpMediaAnalytics Reference

AmpOctoshape

Handles the initialization and deinitialization of the Octoshape server, as well as the communication with it. This module augments the AmpCore module behind the scenes, so you only have to initialize this module to start playing Octoshape URLs.

Check this module’s API documentation here: AmpOctoshape Reference

AmpVirtualReality (Beta)

Our player now supports 360 videos and VR functionality thanks to this module, just by instantiating and registering it, you get to play 360 videos, and with a few extra parameters, you can full VR capabilities.

This module is a work in progress. AmpVirtualReality Reference

AmpNielsenDCR

Our certified Nielsen module eases the integration with our media player, eliminating most of the boilerplate code and event bindings. AmpNielsenDCR Reference

AmpComScore (Beta)

This module is a work in progress. AmpComScore Reference

AmpGoogleAnalytics (Beta)

This module is a work in progress. AmpGoogleAnalytics Reference

AmpAdobeHeartbeat (Beta)

This module is a work in progress. AmpAdobeHeartbeat Reference

 AmpMediaAcceleration (Beta)

This module is a work in progress. AmpMediaAcceleration Reference

 

tvOS

The modules available for tvOS are: AmpCoreTV, AmpMediaAnalyticsTV, AmpOctoshapeTV, AmpStatisticsTV. For these modules, the documentation for their equivalents modules in iOS are completely valid.

Attachments

    Outcomes