Playback of companion adverts

You can add companion adverts if the screen layout of the application allows them. Multiple differently sized slots can be set aside for companion adverts. The dimensions selected depend on the style of companion adverts that you want to display. In the following examples, more than one configuration is shown and provided as a List of IMAWrapperCompanionAdContainer objects. An instance of one of these objects is created by providing a pair of integers for the dimensions and a reference to the ViewGroup.

There may be subtle differences in how the application is organised, so there are alternatives for how companion adverts are configured and enabled. Still, in both cases, you provide a List of IMAWrapperCompanionAdContainer objects, just at different points.

Generating companion advert list

    ViewGroup companionAdPlaceholder = (ViewGroup) findViewById(R.id.companionAdSlot);
    ViewGroup anotherCompanionAdPlaceholder = (ViewGroup) findViewById(R.id.anotherCompanionAdSlot);

    List<IMAWrapper.IMAWrapperCompanionAdContainer> companionList = new ArrayList<IMAWrapper.IMAWrapperCompanionAdContainer>();

    companionList.add(new IMAWrapper.IMAWrapperCompanionAdContainer(
        new Pair<Integer, Integer>(300, 250), companionAdPlaceholder));

    companionList.add(new IMAWrapper.IMAWrapperCompanionAdContainer(
        new Pair<Integer, Integer>(728, 90), anotherCompanionAdPlaceholder));

Editing the layout XML to support companion adverts

The following example provides a pair of companion advert slots with different dimensions to accommodate different companion advert sizes. The number and dimensions of slots provided will depend on the style of adverts required to be shown and the available screen space.

To enable companion adverts, references to these slots and their dimensions must be provided to the IMAWrapper .

    <LinearLayout
        android:id="@+id/companionAdSlot"
        android:layout_width="300px"
        android:layout_height="250px"
        android:background="@android:color/transparent"
        android:gravity="center"
        android:orientation="horizontal"
        android:visibility="gone"/>

    <LinearLayout
        android:id="@+id/anotherCompanionAdSlot"
        android:layout_width="728px"
        android:layout_height="90px"
        android:background="@android:color/transparent"
        android:gravity="center"
        android:orientation="horizontal"
        android:visibility="gone"/>

Setting up the companion adverts

Overlay

In a simple application, the activity layout could be the video view, and companion ad slots are configured together such that the video is overlaid with a companion advert when one is rendered.
In this case, the IMAWrapper allows for the linear advert overlay and companion adverts to be configured in one go. The List can be provided to the IMAWrapper at the same time as the linear adverts ViewGroup in the call to startAdsServices().

mIMAWrapper.startAdsServices(adUiContainerViewGroup, companionList);

Activity fragments

A more complex application may have activity fragments that are put together to form the overall user experience. Here, it may be more complicated to configure the companion advert placeholders and the main video advert overlay together, so the IMAWrapper allows for this to be enabled separately with a later call to setCompanionAdViews().

 mIMAWrapper.setCompanionAdViews(companionList);