com.unity3d.services.ads

Class UnityAdsImplementation

java.lang.Object

com.unity3d.services.ads.UnityAdsImplementation

public final class UnityAdsImplementation
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
UnityAdsImplementation()

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.
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	getToken()
static java.lang.String	getVersion() Get current SDK version
static void	initialize(android.content.Context context, java.lang.String gameId, IUnityAdsListener listener) Initializes Unity Ads.
static void	initialize(android.content.Context context, java.lang.String gameId, IUnityAdsListener listener, boolean testMode) Initializes Unity Ads.
static void	initialize(android.content.Context context, java.lang.String gameId, IUnityAdsListener listener, boolean testMode, boolean enablePerPlacementLoad, IUnityAdsInitializationListener initializationListener) 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, UnityAdsLoadOptions loadOptions, IUnityAdsLoadListener listener)
static void	removeListener(IUnityAdsListener listener) Remove listener for IUnityAdsListener callbacks
static void	setConfiguration(Configuration configuration)
static void	setDebugMode(boolean debugMode) Toggles debug mode on/off
static void	setListener(IUnityAdsListener listener) Deprecated.
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.
static void	show(android.app.Activity activity, java.lang.String placementId, IUnityAdsShowListener showListener) Show one advertisement with custom placement.
static void	show(android.app.Activity activity, java.lang.String placementId, UnityAdsShowOptions showOptions, IUnityAdsShowListener showListener) Show one advertisement with custom placement and custom options.

Methods inherited from class java.lang.Object

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

Constructor Detail

UnityAdsImplementation

public UnityAdsImplementation()

Method Detail

initialize

public static void initialize(android.content.Context context,
                              java.lang.String gameId,
                              IUnityAdsListener listener)

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

Parameters:

context - Current Android application context 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.content.Context context,
                              java.lang.String gameId,
                              IUnityAdsListener listener,
                              boolean testMode)

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

Parameters:

context - Current Android application context 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.content.Context context,
                              java.lang.String gameId,
                              IUnityAdsListener listener,
                              boolean testMode,
                              boolean enablePerPlacementLoad,
                              IUnityAdsInitializationListener initializationListener)

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

Parameters:

context - Current Android application context 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

initializationListener - Listener for IUnityAdsInitializationListener callbacks

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

@Deprecated
public static void setListener(IUnityAdsListener listener)

Deprecated.

Set listener for IUnityAdsListener callbacks

Parameters:

listener - New listener for IUnityAdsListener callbacks

getListener

@Deprecated
public static IUnityAdsListener getListener()

Deprecated.

Get current listener for IUnityAdsListener callbacks. Returns the most recent listener set through setListener or the listener from the first initialize

Returns:

Return IUnityAdsListener that was set from setListener

addListener

public static void addListener(IUnityAdsListener listener)

Add listener for IUnityAdsListener callbacks

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

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

show

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

Show one advertisement with custom placement.

Parameters:

activity - Current Android activity of calling app

placementId - Placement, as defined in Unity Ads admin tools

showListener - Listener for IUnityAdsShowListener callbacks

show

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

Show one advertisement with custom placement and custom options.

Parameters:

activity - Current Android activity of calling app

placementId - Placement, as defined in Unity Ads admin tools

showOptions - Custom options

showListener - Listener for IUnityAdsShowListener callbacks

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,
                        UnityAdsLoadOptions loadOptions,
                        IUnityAdsLoadListener listener)

getToken

public static java.lang.String getToken()

setConfiguration

public static void setConfiguration(Configuration configuration)