Added in API level 34
Also in Ad Services Extensions 5

SdkSandboxController

Kotlin |Java

open class SdkSandboxController

kotlin.Any
↳	android.app.sdksandbox.sdkprovider.SdkSandboxController

Controller that is used by SDK loaded in the sandbox to access information provided by the sdk sandbox.

It enables the SDK to communicate with other SDKS in the SDK sandbox and know about the state of the sdks that are currently loaded in it.

An instance of SdkSandboxController can be obtained using android.content.Context#getSystemService and class. The Context can in turn be obtained using android.app.sdksandbox.SandboxedSdkProvider#getContext().

Summary

Constants
static String	`SDK_SANDBOX_CONTROLLER_SERVICE`

Public methods
open MutableList<AppOwnedSdkSandboxInterface!>	`getAppOwnedSdkSandboxInterfaces()` Fetches all `AppOwnedSdkSandboxInterface` that are registered by the app.
open String	`getClientPackageName()` Returns the package name of the client app.
open SharedPreferences	`getClientSharedPreferences()` Returns `SharedPreferences` containing data synced from the client app.
open MutableList<SandboxedSdk!>	`getSandboxedSdks()` Fetches information about Sdks that are loaded in the sandbox.
open Unit	`loadSdk(sdkName: String, params: Bundle, executor: Executor, receiver: OutcomeReceiver<SandboxedSdk!, LoadSdkException!>)` Loads SDK in an SDK sandbox java process.
open IBinder	`registerSdkSandboxActivityHandler(sdkSandboxActivityHandler: SdkSandboxActivityHandler)` Returns an identifier for a `SdkSandboxActivityHandler` after registering it.
open Unit	`registerSdkSandboxClientImportanceListener(executor: Executor, listener: SdkSandboxClientImportanceListener)` Registers a listener to be notified of changes in the client's `android.app.ActivityManager.RunningAppProcessInfo#importance`.
open Unit	`unregisterSdkSandboxActivityHandler(sdkSandboxActivityHandler: SdkSandboxActivityHandler)` Unregister an already registered `SdkSandboxActivityHandler`.
open Unit	`unregisterSdkSandboxClientImportanceListener(listener: SdkSandboxClientImportanceListener)` Unregisters a listener previously registered using `android.app.sdksandbox.sdkprovider.SdkSandboxController#registerSdkSandboxClientImportanceListener(java.util.concurrent.Executor,android.app.sdksandbox.sdkprovider.SdkSandboxClientImportanceListener)`

Constants

SDK_SANDBOX_CONTROLLER_SERVICE

Added in API level 34
Also in Ad Services Extensions 5

static val SDK_SANDBOX_CONTROLLER_SERVICE: String

Value: "sdk_sandbox_controller_service"

Public methods

getAppOwnedSdkSandboxInterfaces

Added in API level 35
Also in Ad Services Extensions 8

open fun getAppOwnedSdkSandboxInterfaces(): MutableList<AppOwnedSdkSandboxInterface!>

Fetches all AppOwnedSdkSandboxInterface that are registered by the app.

Return
`MutableList<AppOwnedSdkSandboxInterface!>`	List of `AppOwnedSdkSandboxInterface` containing all currently registered AppOwnedSdkSandboxInterface. This value cannot be `null`.

Exceptions
`java.lang.UnsupportedOperationException`	if the controller is obtained from an unexpected context. Use `SandboxedSdkProvider.getContext()` for the right context

getClientPackageName

Added in API level 35
Also in Ad Services Extensions 8

open fun getClientPackageName(): String

Returns the package name of the client app.

Return
`String`	This value cannot be `null`.

Exceptions
`java.lang.UnsupportedOperationException`	if the controller is obtained from an unexpected context. Use `SandboxedSdkProvider.getContext()` for the right context.

getClientSharedPreferences

Added in API level 34
Also in Ad Services Extensions 5

open fun getClientSharedPreferences(): SharedPreferences

Returns SharedPreferences containing data synced from the client app.

Keys that have been synced by the client app using android.app.sdksandbox.SdkSandboxManager#addSyncedSharedPreferencesKeys(Set) can be found in this SharedPreferences.

The returned SharedPreferences should only be read. Writing to it is not supported.

Return
`SharedPreferences`	`SharedPreferences` containing data synced from client app. This value cannot be `null`.

Exceptions
`java.lang.UnsupportedOperationException`	if the controller is obtained from an unexpected context. Use `SandboxedSdkProvider.getContext()` for the right context

getSandboxedSdks

Added in API level 34
Also in Ad Services Extensions 5

open fun getSandboxedSdks(): MutableList<SandboxedSdk!>

Fetches information about Sdks that are loaded in the sandbox.

Return
`MutableList<SandboxedSdk!>`	List of `SandboxedSdk` containing all currently loaded sdks This value cannot be `null`.

Exceptions
`java.lang.UnsupportedOperationException`	if the controller is obtained from an unexpected context. Use `SandboxedSdkProvider.getContext()` for the right context

loadSdk

Added in API level 35
Also in Ad Services Extensions 10

open fun loadSdk(
    sdkName: String, 
    params: Bundle, 
    executor: Executor, 
    receiver: OutcomeReceiver<SandboxedSdk!, LoadSdkException!>
): Unit

Loads SDK in an SDK sandbox java process.

Loads SDK library with sdkName to an SDK sandbox process asynchronously. The caller will be notified through the receiver.

The caller may only load SDKs the client app depends on into the SDK sandbox.

Parameters
`sdkName`	String: name of the SDK to be loaded. This value cannot be `null`.
`params`	Bundle: additional parameters to be passed to the SDK in the form of a `Bundle` as agreed between the client and the SDK. This value cannot be `null`.
`executor`	Executor: the `Executor` on which to invoke the receiver. This value cannot be `null`. Callback and listener events are dispatched through this `Executor`, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use `Context.getMainExecutor()`. Otherwise, provide an `Executor` that dispatches to an appropriate thread.
`receiver`	OutcomeReceiver<SandboxedSdk!, LoadSdkException!>: This either receives a `SandboxedSdk` on a successful run, or `LoadSdkException`. This value cannot be `null`.

Exceptions
`java.lang.UnsupportedOperationException`	if the controller is obtained from an unexpected context. Use `SandboxedSdkProvider.getContext()` for the right context

registerSdkSandboxActivityHandler

Added in API level 34
Also in Ad Services Extensions 7

open fun registerSdkSandboxActivityHandler(sdkSandboxActivityHandler: SdkSandboxActivityHandler): IBinder

Returns an identifier for a SdkSandboxActivityHandler after registering it.

This function registers an implementation of SdkSandboxActivityHandler created by an SDK and returns an IBinder which uniquely identifies the passed SdkSandboxActivityHandler object.

If the same SdkSandboxActivityHandler registered multiple times without unregistering, the same IBinder token will be returned.

Parameters
`sdkSandboxActivityHandler`	SdkSandboxActivityHandler: is the `SdkSandboxActivityHandler` to register. This value cannot be `null`.

Return
`IBinder`	`IBinder` uniquely identify the passed `SdkSandboxActivityHandler`. This value cannot be `null`.

registerSdkSandboxClientImportanceListener

Added in Ad Services Extensions 14

open fun registerSdkSandboxClientImportanceListener(
    executor: Executor, 
    listener: SdkSandboxClientImportanceListener
): Unit

Registers a listener to be notified of changes in the client's android.app.ActivityManager.RunningAppProcessInfo#importance.

Parameters
`listener`	SdkSandboxClientImportanceListener: an implementation of `SdkSandboxClientImportanceListener` to register. This value cannot be `null`.
`executor`	Executor: This value cannot be `null`. Callback and listener events are dispatched through this `Executor`, providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use `Context.getMainExecutor()`. Otherwise, provide an `Executor` that dispatches to an appropriate thread.

Exceptions
`java.lang.UnsupportedOperationException`	if the controller is obtained from an unexpected context. Use `SandboxedSdkProvider.getContext()` for the right context.

unregisterSdkSandboxActivityHandler

Added in API level 34
Also in Ad Services Extensions 7

open fun unregisterSdkSandboxActivityHandler(sdkSandboxActivityHandler: SdkSandboxActivityHandler): Unit

Unregister an already registered SdkSandboxActivityHandler.

If the passed SdkSandboxActivityHandler is registered, it will be unregistered. Otherwise, it will do nothing.

After unregistering, SDK can register the same handler object again or create a new one in case it wants a new Activity.

If the IBinder token of the unregistered handler used to start a Activity, the Activity will fail to start.

Parameters
`sdkSandboxActivityHandler`	SdkSandboxActivityHandler: is the `SdkSandboxActivityHandler` to unregister. This value cannot be `null`.

Return
`Unit`	This value cannot be `null`.

unregisterSdkSandboxClientImportanceListener

Added in Ad Services Extensions 14

open fun unregisterSdkSandboxClientImportanceListener(listener: SdkSandboxClientImportanceListener): Unit

Unregisters a listener previously registered using android.app.sdksandbox.sdkprovider.SdkSandboxController#registerSdkSandboxClientImportanceListener(java.util.concurrent.Executor,android.app.sdksandbox.sdkprovider.SdkSandboxClientImportanceListener)

Parameters
`listener`	SdkSandboxClientImportanceListener: an implementation of `SdkSandboxClientImportanceListener` to unregister. This value cannot be `null`.

Exceptions
`java.lang.UnsupportedOperationException`	if the controller is obtained from an unexpected context. Use `SandboxedSdkProvider.getContext()` for the right context.