com.unity3d.ads

Class UnityAds

java.lang.Object

com.unity3d.ads.UnityAds

public final class UnityAds
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UnityAds.FinishState An enumeration for the completion state of an ad.
static class	UnityAds.PlacementState Describes state of Unity Ads placements.
static class	UnityAds.UnityAdsError

Constructor Summary

Constructors

Constructor and Description
UnityAds()

Method Summary

Modifier and Type	Method and Description
static void	addListener(IUnityAdsListener listener) Add listener for IUnityAdsListener callbacks.
static boolean	getDebugMode() Get current debug mode status
static IUnityAdsListener	getListener() Deprecated. this method is deprecated in favor of addListener(IUnityAdsListener) and removeListener(IUnityAdsListener)
static UnityAds.PlacementState	getPlacementState() Get current state of default placement
static UnityAds.PlacementState	getPlacementState(java.lang.String placementId) Get current state of a placement
static java.lang.String	getVersion() Get current SDK version
static void	initialize(android.app.Activity activity, java.lang.String gameId, IUnityAdsListener listener) Initializes Unity Ads.
static void	initialize(android.app.Activity activity, java.lang.String gameId, IUnityAdsListener listener, boolean testMode) Initializes Unity Ads.
static void	initialize(android.app.Activity activity, java.lang.String gameId, IUnityAdsListener listener, boolean testMode, boolean enablePerPlacementLoad) Initializes Unity Ads.
static boolean	isInitialized() Checks if Unity Ads has been initialized.
static boolean	isReady() Check if default placement is ready to show ads
static boolean	isReady(java.lang.String placementId) Check if placement is ready to show ads
static boolean	isSupported() Checks if current device supports running Unity Ads
static void	load(java.lang.String placementId) Request fill for a specific placement ID.
static void	removeListener(IUnityAdsListener listener) Remove listener for IUnityAdsListener callbacks
static void	setDebugMode(boolean debugMode) Toggles debug mode on/off
static void	setListener(IUnityAdsListener listener) Deprecated. this method is deprecated in favor of addListener(IUnityAdsListener)
static void	show(android.app.Activity activity) Show one advertisement using default placement.
static void	show(android.app.Activity activity, java.lang.String placementId) Show one advertisement with custom placement.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UnityAds

public UnityAds()

Method Detail

initialize

public static void initialize(android.app.Activity activity,
                              java.lang.String gameId,
                              IUnityAdsListener listener)

Initializes Unity Ads. Unity Ads should be initialized when app starts.

Parameters:

activity - Current Android activity of calling app

gameId - Unique identifier for a game, given by Unity Ads admin tools or Unity editor

listener - Listener for IUnityAdsListener callbacks

initialize

public static void initialize(android.app.Activity activity,
                              java.lang.String gameId,
                              IUnityAdsListener listener,
                              boolean testMode)

Initializes Unity Ads. Unity Ads should be initialized when app starts.

Parameters:

activity - Current Android activity of calling app

gameId - Unique identifier for a game, given by Unity Ads admin tools or Unity editor

listener - Listener for IUnityAdsListener callbacks

testMode - If true, only test ads are shown

initialize

public static void initialize(android.app.Activity activity,
                              java.lang.String gameId,
                              IUnityAdsListener listener,
                              boolean testMode,
                              boolean enablePerPlacementLoad)

Initializes Unity Ads. Unity Ads should be initialized when app starts. Note: The `load` API is in closed beta and available upon invite only. If you would like to be considered for the beta, please contact Unity Ads Support.

Parameters:

activity - Current Android activity of calling app

gameId - Unique identifier for a game, given by Unity Ads admin tools or Unity editor

listener - Listener for IUnityAdsListener callbacks

testMode - If true, only test ads are shown

enablePerPlacementLoad - Set this flag to `YES` to disable automatic placement caching. When this is enabled, developer must call `load` on placements before calling show

isInitialized

public static boolean isInitialized()

Checks if Unity Ads has been initialized. This might be useful for debugging initialization problems.

Returns:

If true, Unity Ads has been successfully initialized

setListener

public static void setListener(IUnityAdsListener listener)

Deprecated. this method is deprecated in favor of addListener(IUnityAdsListener)

Set listener for IUnityAdsListener callbacks. Use this if only ever using one listener

Parameters:

listener - New listener for IUnityAdsListener callbacks

addListener

public static void addListener(IUnityAdsListener listener)

Add listener for IUnityAdsListener callbacks. Use this if subscribing multiple listeners

Parameters:

listener - New listener for IUnityAdsListener callbacks

removeListener

public static void removeListener(IUnityAdsListener listener)

Remove listener for IUnityAdsListener callbacks

Parameters:

listener - New listener for IUnityAdsListener callbacks

getListener

public static IUnityAdsListener getListener()

Deprecated. this method is deprecated in favor of addListener(IUnityAdsListener) and removeListener(IUnityAdsListener)

Get current listener for IUnityAdsListener callbacks. Returns the first listener added

Returns:

First listener set for IUnityAdsListener callbacks

isSupported

public static boolean isSupported()

Checks if current device supports running Unity Ads

Returns:

If true, device supports Unity Ads. If false, device can't initialize or show Unity Ads.

getVersion

public static java.lang.String getVersion()

Get current SDK version

Returns:

Current SDK version name

isReady

public static boolean isReady()

Check if default placement is ready to show ads

Returns:

If true, default placement is ready to show ads

isReady

public static boolean isReady(java.lang.String placementId)

Check if placement is ready to show ads

Parameters:

placementId - Placement, as defined in Unity Ads admin tools

Returns:

If true, placement is ready to show ads

getPlacementState

public static UnityAds.PlacementState getPlacementState()

Get current state of default placement

Returns:

If PlacementState.READY, default placement is ready to show ads. Other states give detailed reasons why placement is not ready.

getPlacementState

public static UnityAds.PlacementState getPlacementState(java.lang.String placementId)

Get current state of a placement

Parameters:

placementId - Placement, as defined in Unity Ads admin tools

Returns:

If PlacementState.READY, placement is ready to show ads. Other states give detailed reasons why placement is not ready.

show

public static void show(android.app.Activity activity)

Show one advertisement using default placement.

Parameters:

activity - Current Android activity of calling app

show

public static void show(android.app.Activity activity,
                        java.lang.String placementId)

Show one advertisement with custom placement.

Parameters:

activity - Current Android activity of calling app

placementId - Placement, as defined in Unity Ads admin tools

setDebugMode

public static void setDebugMode(boolean debugMode)

Toggles debug mode on/off

Parameters:

debugMode - If true, debug mode is on and there will be lots of debug output from Unity Ads. If false, there will be only some short log messages from Unity Ads.

getDebugMode

public static boolean getDebugMode()

Get current debug mode status

Returns:

If true, debug mode is on. If false, debug mode is off.

load

public static void load(java.lang.String placementId)

Request fill for a specific placement ID. This functionality is enabled through the `enablePerPlacementLoad` in initialize. Note: The `load` API is in closed beta and available upon invite only. If you would like to be considered for the beta, please contact Unity Ads Support.

Parameters:

placementId - The placement ID to be loaded.