Method signature

The method is meant to display banner advertisements found earlier with the FAPI.UI.requestBannerAds method.

FAPI.invokeUIMethod("showBannerAds")

The method makes the banner block with banner advertisements displayed on it visible. The position of the banner block is regulated by the “position” parameter. For example, bar format supports following position options:

• bottom: the banner is displayed at the bottom of the device screen (default value);
• top: the banner is displayed at the top of the device screen.

Complete list of supported formats is available with FAPI.UI.getBannerFormats method.

To set a format FAPI.UI.setBannerFormat method should be used.

Banner size

The size of the banner displayed upon the call of the method depends on following parameters:

• current platform;
• android OK app version;
• current mobile device layout.

For each platform, the banner size for each state of the user’s device screen is predetermined.

Showing multiple banners at once

If you’ve chosen to show multiple banners at once with FAPI.UI.setBannersCount method be aware that in additional to multiple banners there will be a 16px margin between them.

Call example

function showBannerAds() {
FAPI.invokeUIMethod("showBannerAds", "top")
}

Callback example

As a result of a call, a callback with a notification on an event that happened will be returned to the game. Possible callbacks are described below.

A callback for a case when the advertisement block was displayed

A callback for a case when the advertisement block did not start displaying