loliball/media3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
media3/extensions/ima/README.md
ojw28 d496621e4b Update README.md
2017-05-17 13:52:19 -07:00

1.8 KiB
Raw Blame History

ExoPlayer IMA extension

Description

The IMA extension is a MediaSource implementation wrapping the Interactive Media Ads SDK for Android. You can use it to insert ads alongside content.

Using the extension

Pass a single-window content MediaSource to ImaAdsMediaSource's constructor, along with a ViewGroup that is on top of the player and the ad tag URI to show. The IMA documentation includes some sample ad tags for testing. Then pass the ImaAdsMediaSource to ExoPlayer.prepare.

You can try the IMA extension in the ExoPlayer demo app. To do this you must select and build one of the withExtensions build variants of the demo app in Android Studio. In the app you can find IMA test content in the "IMA sample ad tags" section.

Known issues

This is a preview version with some known issues:

  • Seeking is not yet ad aware. This means that it's possible to seek back into ads that have already been played, and also seek past midroll ads without them being played. Seeking will be made ad aware for the first stable release.
  • Midroll ads are not yet fully supported. playAd and AD_STARTED events are sometimes delayed, meaning that midroll ads take a long time to start and the ad overlay does not show immediately.
  • Tapping the 'More info' button on an ad in the demo app will pause the activity, which destroys the ImaAdsMediaSource. Played ad breaks will be shown to the user again if the demo app returns to the foreground.