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 - Premier : 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

Build 4.2.108 - 09/07/2018 - Package

  • Add support for https origin for Cocoapods

Build 4.2.107 - 08/29/2018 - Package

  • Improved Freewheel Plugin
  • Bug Fixing

Build 4.2.106 - 08/10/2018 - Package

  • Updated YoSpace Library
  • Improved Freewheel plugin
  • Stability improvements

Build 4.2.105 - 07/27/2018 - Package

  • Fix Nielsen Plugin for tvOS and some Analytics providers
  • Update ComScore Library for tvOS
  • Improvements in the Freewheel plugin
  • General improvements and bug fixes

Build 4.2.104 - 07/13/2018 - Package

  • Improved Adobe Heartbeat Plugin
  • Improved ComScore Plugin
  • Add support old Webvtt standard
  • Fix crashes

Build 4.2.103 - 07/03/2018 - Package

  • Fix on autorecovery for live events
  • Fix on heartbeat logging
  • Update on Nielsen logging

Build 4.2.102 - 06/18/2018 - Package

  • Fixes on Heartbeat plugin
  • Fixes on ComScore Plugin
  • Fixes on Nielsen Plugin
  • Revert Support to iOS 9

Build 4.2.101 - 06/13/2018 - Package

  • Migrate YoSpace Plugin to Swift Base Code
  • Fix Nielsen Problems when report ads on tvOS
  • Bug Fixes

Build 4.2.100 - 06/01/2018 - Package

  • Fix autohide controls feature
  • Improve Chromecast Module
  • Minimal Bug Fixing

Build 4.2.99 - 05/25/2018 - Package

  • Fixed Adobe Heartbeat issues on tracking with Freewheel Ads
  • Fixed fullscreen variable on change to fullscreen mode
  • Improved YoSpace Plugin on iOS and tvOS
  • Create new feature stream autorecovery mode
  • Some Crashes fixed

Build 4.2.98 - 05/07/2018 - Package

  • New YoSpace plugin tvOS
  • Add Support DRM streams with JSON responses
  • Improve Poster Image API
  • Fix tvOS callbacks

Build 4.2.97 - 04/24/2018 - Package

  • New YoSpace Plugin for tvOS
  • Fix DRM problems on some streams
  • Bug Fixes

Build 4.2.96.1 - 04/02/2018 - Package

  • Added Support Swift 4.1 and Xcode 9.3

Build 4.2.96 - 03/27/2018 - Package

  • Expose API to control the visibility of poster image
  • Improve Chromecast Module, now migrated to Cast version 3
  • Fix issue Heartbeat not sending correctly play events
  • Fix AVAudioSession Observer Crash

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

Build 3.53 - 07/29/2016 - Package

  • Do not use ‘unowned’ in closures to reference ‘self’, use ‘weak’ and use if lets or guards to ensure that a ‘strongSelf’ version of ‘self’ exists
  • Avoid unwrapping optionals and check it’s state instead
  • Playhead jumps to different position when second time scrub forward the playhead on the playback
  • Scrub backward the playhead is not working on the playback

Build 3.52 - 07/18/2016 - Package

  • Override Parent View’s Constraints to Handle Fullscreen Ourselves
  • Use New Logging Logic in All Modules
  • Standardize the AMP release package and implement it with automation in AMP iOS
  • Update the Samples with our Latest SDK
  • Adobe Heartbeat Plugin Support (Alpha)
  • NielsenDCR Plugin Support(Alpha, on Certification)

Build 3.0.47 BETA - 04/19/2016 - Package

  • New tvOS framework support
  • Update plugin Octoshape
  • Bitcode support
  • New plugin architecture

Build 2.44 - 04/18/2016 - Package

  • Skip preroll button behind controls in full screen
  • iOS SDK leaks AVPlayers
  • iOS video intermittently fails to play
  • Fullscreen during preroll breaks player
  • Scrolling video on/off screen repeatedly prevents any future video playback
  • SDK crash in AMPFeed parseJSON / addAnalyticsPlugin:TrackingId: (Akamai SDK 2.43)
  • SDK crash involving AkaMA_MediaMetrics (Akamai SDK 2.43)
  • Pre-roll audio plays after dismissing player, backgrounding and foregrounding
  • AirPlay stops when device sleeps - IOSSDK-85
  • Airplay scrubbing on device causes slow/jerky scrubbing over AirPlay - IOSSDK-86