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.
Getting the extension
The easiest way to use the extension is to add it as a gradle dependency:
compile 'com.google.android.exoplayer:extension-ima:rX.X.X'
where rX.X.X is the version, which must match the version of the ExoPlayer
library being used.
Alternatively, you can clone the ExoPlayer repository and depend on the module locally. Instructions for doing this can be found in ExoPlayer's top level README.
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. You can find IMA test content in the "IMA sample ad tags"
section of the app.
Known issues
This is a preview version with some known issues:
- 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.
- Ad loading timeouts are currently propagated as player errors, rather than being silently handled by resuming content.