Akamai Adaptive Media Player

We are preparing a new upgrade, We will keep you tuned when we ready for the next launch.

Contact us!

Adaptive Media Player (AMP) for Devices - Standard : iOS/tvOS

subscribe via RSS

Version 4 for Swift 3.0 and above no longer developed nor supported

Developer Guide

Latest build:

Build 4.3.123 - 04/04/2019 - Package

  • Updated the Freewheel library / framework
  • Added the reporting of specific HTTP error response codes for iOS and tvOS
  • Fixed the issue that caused a crash when enabling Closed Captions
  • Improved the Closed Captions ovelay appearance
  • Updated IMA framework to support the IMA SDK version 3.9.0

Previous builds:

Build 4.3.119 - 02/08/2019 - Package

  • Added specific 503 error detection for the onAmpError callback
  • Fixed the bug that caused a double audio when an IMA preroll plays with a DAI enabled stream

Build 4.3.118 - 01/25/2019 - Package

  • Updated the deployment target for Media Analytics to 10.0 for iOS and tvOS
  • Improvements on freewheel plugin and compatibility

Build 4.3.117 - 01/11/2019 - Package

  • Enhanced the onAmpError callback to retrieve the specific error received for 400-499 response status codes when requesting DAI variant playlists or ts segments
  • Optimized the Freewheel library / plug-in

Build 4.3.116 - 12/28/2018 - Package

  • Fixed the bug that caused a crash when isStreamAutoRecoveryEnabled is set to true
  • Fixed the bug that caused onIMASetup not to be called
  • Fixed memory issues on AMP iOS Plugins
  • Added AVPlayerItemErrorLog error type to onAmpError callback when DAI requests for child playlists or ts segments result in 400-499 response status codes

Build 4.3.115 - 12/14/2018 - Package

  • Added support for custom headers in DRM requests
  • Improved error detection and handling for DRM
  • Improved error detection and handling for client/server error responses
  • New callback to support errors on YoSpace manager
  • General bug fixes

Build 4.3.114 - 11/30/2018 - Package

  • General Bug Fixes

Build 4.3.113 - 11/16/2018 - Package

  • New schema for modules versioning
  • General Bug Fixes

Build 4.3.112 - 11/02/2018 - Package

  • New UI to set captions and audio tracks
  • New API to set the max bitrate for IMA ads
  • New callback function to detect bitrates changes
  • General Bug Fixing

Build 4.3.111 - 10/17/2018 - Package

  • New default UI and Components
  • Improvements in YoSpace library
  • Improvements in the Akamai Media Analytics library
  • General Bug Fixes

Build 4.3.110 - 10/11/2018 - Package

  • Add support for full screen video on iPhone X, XS, XS Max, XR
  • Fixed error on Akamai Media Analytics and Live Streams
  • Fixed error using poster images and MP4 videos
  • Expose timeout API on IMA

Build 4.3.109 - 09/26/2018 - Package

  • New API to set load timeout on IMA
  • Improved poster image property
  • Improved autoplay property
  • General bug fixes

Build 4.3.108 - 09/14/2018 - Package

  • Support Xcode 10 and Swift 4.2
  • AmpVirtualReality renamed to Amp360
  • Improved API for tvOS version
  • Improved Freewheel plugin
  • Improved IMA plugin

Version 15 49 15 -

—\ntitle: Build 4.2.108\npublished: 09/07/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.108.zip\n—\n - Add support for https origin for Cocoapods \n

Version 14 29 31 -

—\ntitle: Build 4.2.107\npublished: 08/29/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.107.zip\n—\n - Improved Freewheel Plugin \n - Bug Fixing \n

Version 13 42 06 -

—\ntitle: Build 4.2.106\npublished: 08/10/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.106.zip\n—\n - Updated YoSpace Library \n - Improved Freewheel plugin \n - Stability improvements \n

Version 16 59 12 -

—\ntitle: Build 4.2.105\npublished: 07/27/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.105.zip\n—\n - Fix Nielsen Plugin for tvOS and some Analytics providers \n - Update ComScore Library for tvOS \n - Improvements in the Freewheel plugin \n - General improvements and bug fixes \n

Version 11 02 00 -

—\ntitle: Build 4.2.104\npublished: 07/13/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.104.zip\n—\n - Improved Adobe Heartbeat Plugin \n - Improved ComScore Plugin \n - Add support old Webvtt standard \n - Fix crashes \n

Version 15 53 41 -

—\ntitle: Build 4.2.103\npublished: 07/03/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.103.zip\n—\n - Fix on autorecovery for live events \n - Fix on heartbeat logging \n - Update on Nielsen logging \n

Version 09 54 27 -

—\ntitle: Build 4.2.102\npublished: 06/18/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.102.zip\n—\n - Fixes on Heartbeat plugin \n - Fixes on ComScore Plugin \n - Fixes on Nielsen Plugin \n - Revert Support to iOS 9 \n

Version 20 49 56 -

—\ntitle: Build 4.2.101\npublished: 06/13/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.101.zip\n—\n - Migrate YoSpace Plugin to Swift Base Code \n - Fix Nielsen Problems when report ads on tvOS \n - Bug Fixes \n

Version 09 01 42 -

—\ntitle: Build 4.2.100\npublished: 06/01/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.100.zip\n—\n - Fix autohide controls feature \n - Improve Chromecast Module \n - Minimal Bug Fixing \n

Version 16 19 17 -

—\ntitle: Build 4.2.99\npublished: 05/25/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.99.zip\n—\n - Fixed Adobe Heartbeat issues on tracking with Freewheel Ads \n - Fixed fullscreen variable on change to fullscreen mode \n - Improved YoSpace Plugin on iOS and tvOS \n - Create new feature stream autorecovery mode \n - Some Crashes fixed \n

Version 11 41 43 -

—\ntitle: Build 4.2.98\npublished: 05/07/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.98.zip\n—\n - New YoSpace plugin tvOS \n - Add Support DRM streams with JSON responses \n - Improve Poster Image API \n - Fix tvOS callbacks \n

Version 00 19 55 -

—\ntitle: Build 4.2.97\npublished: 04/24/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.97.zip\n—\n - New YoSpace Plugin for tvOS \n - Fix DRM problems on some streams \n - Bug Fixes \n

Version 16 48 52 -

—\ntitle: Build 4.2.96.1\npublished: 04/02/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.96.1.zip\n—\n - Added Support Swift 4.1 and Xcode 9.3 \n

Version 18 12 00 -

—\ntitle: Build 4.2.96\npublished: 03/27/2018\npackageUrl: http://projects.mediadev.edgesuite.net/customers/akamai/devices_sdk/ios/v3/Amp-Standard-4.2.96.zip\n—\n - Expose API to control the visibility of poster image \n - Improve Chromecast Module, now migrated to Cast version 3 \n - Fix issue Heartbeat not sending correctly play events \n - Fix AVAudioSession Observer Crash \n

Build 4.2.95 - 03/19/2018 - Package

  • Bug Fixing
  • Adding new api to set ComScore Labels

Build 4.2.94 - 03/05/2018 - Package

  • Propagate ad error message in onAdError() callback
  • Video player - Airplay UI button always displays
  • “Skip 10” buttons do not move the scrubber in 10 second increments (live stream)
  • iOS: Video player - ad time added to duration in player UI
  • iOS: IMA: Can scrub back to preroll ad
  • iOS: Video player - cannot view Airplay dialog on iPad Air 2
  • iOS: Video player - sound button does not respond to hardware volume changes
  • iOS: Video Player - Loading indicator displays behind Play button when entering into video playback view
  • Improve Error Callbacks
  • Fix KVO Observer not released
  • Remove Third Party Libraries

Build 4.2.93 - 02/15/2018 - Package

  • Fix Crash when changing font size
  • Play/pause button shows wrong state when video is paused on foregrounding/backgrounding
  • Added Player Accessibility
  • Adding IMA Ads Accessibility

Build 4.2.92 - 01/31/2018 - Package

  • Rename the API setPlayingInfo to setMediaInfo.
  • Rename the API playbackStateModeOnBackground to playbackStateOnAppDidBecomeActive.
  • Added new Chromecast delegates onSessionManager.
  • Added new flag to access UI Controls during Ads supported for DAI ads - enableAdUI: Bool.
  • Fix selection CC on Unknown Stream tags in IOS.
  • Fix IMA DAI request ads crashes with empty asset key.
  • Fix app crashes when trying to Airplay a VOD stream.
  • Fix Comscore - ns_st_cl value incorrect when playing long VOD.
  • Fix closing a video does not create a heartbeats call w/ s:event:type = complete
  • Fix custom UI controls goes to hide when performing action back & forth continuously on slider(seekBar).
  • Fix bypassing mid-roll dai ads are not playing on the player in iOS.
  • Fix AdobeHeartbeat captured post-roll DAI ads as type: mid-roll in iOS.
  • Fix when the CC is ON, user has to tap the “On” button again to make CC appears.
  • Fix iOS: Backgrounding app while video is loading continues to play the video audio.

Build 4.2.91 - 01/12/2018 - Package

  • Fix the loading spinner position changed to top corner in custom view fullscreen.
  • Fix - No loading spinner indicator on mini player.
  • Updated AmpIMAManager initialize should accept optional imaContentID.
  • Fix App crashed when dismissing the CC popover and tap again on CC button in custom programmatical view.

Build 4.2.90 - 01/05/2018 - Package

  • Fix App crashes when passed an empty IMA Content ID.
  • Fix Comscore: DAI adunit (pre/mid/post) logic should be moved to IMA and the right index must be set in adInfo.
  • Added new flag to control resuming playback on entering foreground - ampPlayer.playbackStateModeOnBackground.
  • Fix the Player closed captions overlay buttons are too small.
  • Added support for MP3 Files.
  • Fix the issue onEnterFullscreen called on rotation.

Build 4.2.89 - 12/20/2017 - Package

  • Fix onAdError callback issue when Freewheel ads failed to play.
  • Fix Comscore: iOS: comScore: Clip length (ns_st_cl) is not an integer value.
  • Fix memory issues on Amp Freewheel library.
  • Implement prevention of user bypassing midrolls by seek for Freewheel (tvOS / iOS).
  • Fix AmpAdobeHeartbeat conflicts with ADBMobile Library.
  • Fix iOS:Point of play progress bounces backwards/forwards when scrubbing.
  • Fix App crashes when DVR enabled for live video without DVR window & seeking on timeline.
  • Create API Function to Load Available Bitrates on HLS - getQualityLevels().
  • Create API to set max quality level - setMaxQualityLevel(level:QualityLevel).
  • Fix user cannot play and pause from attached headphones.
  • Fix Play overlay is not removed if Freewheel/IMA preroll is blocked.
  • Create API to allow videos on background - allowBackgroundPlayback:Bool.
  • Fix Live Stream stops to play completely on navigation back to player for custom UI.
  • Fix Live video timestamp changes when leaving and returning to video for custom UI.

Build 4.2.88 - 12/04/2017 - Package

  • Fix Chromecast controls play/pause/seek from player are not working on TV.
  • Fix when Chromecast is disconnected then video is not resumed on the player.
  • Fix Freewheel Midrolls are not displayed on the player.
  • Fix the player background does not have transparency when using the custom UI.
  • Fix the crash issue on observeValueForKeyPath keyPath:Optional(“tracks”)
  • Fix App gets crashed for freewheel & Comscore configuration.
  • Fix After post-roll ads, Comscore events are keep on sending to server.
  • Fix App crashes intermittently when deallocating the player with Nielsen configuration.
  • Fix webVTT menu option ‘OFF’ is not turning off the closed captions on the player.
  • Add The new constructor for the AmpMediaAnalytics manager class. - public init(ampPlayer: AmpCore.AmpPlayer, configurationUrl: String, dimensions: [String : String] = default, viewerId: String = default).
  • Fix onAdStarted and onAdEnded not Working Correctly in Freewheel.
  • Add support for Handle Freewheel Errors.

Build 4.2.87 - 11/21/2017 - Package

  • Fix crash issue when doing Chromecast using custom UI.
  • Fix captions menu when the player rotate.
  • Update ComScore libraries to avoid problems with main thread checker in iOS.
  • Add observers to Freewheel Ads.
  • Fix issue with close captions using webvtt.
  • Fix spinner & playoverlay is not turn off on player during the casting on TV.
  • Fix freewheel webview not closing and disappearing on rotation.

Build 4.2.86 - 11/06/2017 - Package

  • Fix Heartbeat parameter s:stream:type value for both VOD & Live streams.
  • Fix handle url on DAI fallback tvOS.
  • Fix Comscore problem with DAI postroll ads.
  • Fix UI problems on using DAI.
  • Fix comScore - correct values are not appearing in the call.
  • Add support for captions in the custom UI.
  • Fix issue on call handle url from fallback url that breaks comscore.
  • Fix heartbeats ‘play’ events are being sent as ‘buffer’ for initial VOD if IMA call is unsuccessful.

Build 4.2.85 - 10/30/2017 - Package

  • Updated call back sequence for ad load.
  • Add Comscore Load event call.
  • Add Heartbeat analytics support for ads.
  • Add Comscore analytics support for ads.
  • Fix DAI streams are not playing continuously & automatically paused multiple times during the playback.
  • Fix Comscore Custom attributes are not captured in beacons.
  • Fix Comscore Content type(ns_st_ct) attribute is captured wrong value.
  • Fix Comscore beacons are missing with Pre - Mid - Post roll.
  • Fix IMA Ad started call back is triggered twice.
  • Fix Comscore - Events & metadata are not triggered for the content playback with DAI.
  • Fix Parameter “ns_st_cl” value is captured as 0(zero) during the content & ads playback.
  • Fix Heartbeat - Start + AA_start call, then all calls are start calls (no play calls).
  • Fix Heartbeats - No Buffer call when video playback is paused due to attempting to load more video.

Build 4.2.84 - 10/07/2017 - Package

  • Fix issue on play overlay icon size is same for both normal and fullscreen view.
  • Fix issue on title is not set automatically when using feed method.
  • Add support for poster image with only audio streams.
  • Fix crash issue when deallocating the player on iOS.
  • Fix crash when app moves to background and return to foreground on tvOS.
  • Fix crash when user scrub on feed stream or hls in iOS.
  • Add new module AmpUI to support for custom UI.

Build 4.2.83 - 09/25/2017 - Package

  • Fix crash issue on iOS and tvOS observer.
  • Add support for VideoMetadata configuration in the Heartbeat plugin.
  • Fix Heartbeat beacons are not called on tvOS.
  • Fix Heartbeat sourceError issue for Live content on both iOS & tvOS.
  • Fix issue never disappear spinner on buffer.

Build 4.1.75 - 06/02/2017 - Package

  • Adding support to DRM on AMP iOS and tvOS.
  • Fix issue on mp4 streams playback startup time.

Build 4.1.74 - 05/19/2017 - Package

  • Integrate Chromecast Module on Core.
  • Fixes Samples
  • Integrate new plugins on Standar version

Build 4.1.71 - 05/05/2017 - Package

  • Bug Fixing
  • Samples Update to Support Swift 3.1

Build 4.1 - 04/24/2017 - Package

  • Support new Xocde and Swift version

Build 4.0 - 04/08/2017 - Package

  • Swift 3 support
  • Support WebVTT captions files
  • New Integrated UI you don’t need anymore a UICore Module
  • New YoSpace Ads Plugin
  • Adding support to Freewheel on tvOS

Build 3.65 - 12/28/2016 - Package

  • Fix issue on some live streams
  • Adding device target on tvOS

Build 3.64 - 12/12/2016 - Package

  • Fix error on tvOS when send app to revision at App Store

Build 3.63 - 12/07/2016 - Package

  • Create extra initializer for Nielsen.
  • Fix crash issues related to NielsenDCR.

Build 3.62 - 11/29/2016 - Package

  • Fix wrong behavior of poster image on tvOS
  • Adding methods to set the playerview on tvOS

Build 3.61 - 11/22/2016 - Package

  • Adding fully support to poster image on iOS and tvOS
  • Improve the way of how to release delegates and callbacks

Build 3.60 - 11/21/2016 - Package

  • Adding Support to Akamai MAE
  • Adding support to Akamai Event Manager
  • Bug Fixes

Build 3.59 - 10/25/2016 - Package

  • Fix Player went off after 2 secs of playback
  • Fix Player disappear for secs when moving the play head position on timeline for HLS streams
  • Fix Chromecast issues
  • Fix Media analytics beacons( a=s,a=p ) are triggered automatically without playback begins.
  • Create custom logging logic

Build 3.58 - 10/07/2016 - Package

  • Create Comscore sample
  • Prepare Sample for Google Analytics
  • Update Nielsen Library to support iOS 10
  • Create Lincense System

Build 3.57 - 09/27/2016 - Package

  • Remove dependency third party libraries dependency
  • Update tvOS version
  • Update Nielsen Plugin for iOS 10 support

Build 3.56 - 09/14/2016 - Package

  • Adding support for iOS 10 and Swift 2.3

Build 3.55 - 08/26/2016 - Package

  • New Nielsen DCR Plugin
  • New Comscore Plugin
  • New Adobe Heartbeat Plugin
  • Improve performace and Crash fixes