Se agregó en el nivel de API 34
También en Extensiones de servicios de anuncios 5

Resumen: Constantes | Métodos | Métodos heredados

SdkSandboxController

public class SdkSandboxController
extends Object

java.lang.Object
↳	android.app.sdksandbox.sdkprovider.SdkSandboxController

---

Controlador que usa el SDK cargado en la zona de pruebas para acceder a la información que proporciona el SDK en la zona de pruebas.

Permite que el SDK se comunique con otros SDK en la zona de pruebas del SDK y conozca el estado. de los SDKs cargados en ese momento.

Se puede obtener una instancia de SdkSandboxController con Context.getSystemService(Class) y class. A su vez, Context puede obtenerse usando SandboxedSdkProvider.getContext().

Resumen

Constantes
String	SDK_SANDBOX_CONTROLLER_SERVICE

Métodos públicos
List<AppOwnedSdkSandboxInterface>	getAppOwnedSdkSandboxInterfaces() Recupera todos los AppOwnedSdkSandboxInterface que registró la app.
String	getClientPackageName() Muestra el nombre del paquete de la app cliente.
SharedPreferences	getClientSharedPreferences() Muestra un objeto SharedPreferences que contiene datos sincronizados desde la app cliente.
List<SandboxedSdk>	getSandboxedSdks() Recupera información sobre los SDKs que se cargan en la zona de pruebas.
void	loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver) Carga el SDK en un proceso de Java de la zona de pruebas del SDK.
IBinder	registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler) Muestra un identificador para un SdkSandboxActivityHandler después de registrarlo.
void	unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler) Cancela el registro de un SdkSandboxActivityHandler ya registrado.

Métodos heredados

Desde la clase java.lang.Object Object clone() Crea y muestra una copia de este objeto. boolean equals(Object obj) Indica si algún otro objeto es "igual a" este. void finalize() Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección determina que no hay más referencias al objeto. final Class<?> getClass() Muestra la clase del entorno de ejecución de este Object. int hashCode() Muestra un valor de código hash para el objeto. final void notify() Activa un solo subproceso que está esperando la supervisión de este objeto. final void notifyAll() Activa todos los subprocesos que están esperando la supervisión de este objeto. String toString() Devuelve una representación de cadena del objeto. final void wait(long timeoutMillis, int nanos) Hace que el subproceso actual espere hasta que se active (por lo general, se notifica o se interrumpe) o hasta que haya transcurrido un período determinado en tiempo real. final void wait(long timeoutMillis) Hace que el subproceso actual espere hasta que se active (por lo general, se notifica o se interrumpe) o hasta que haya transcurrido un período determinado en tiempo real. final void wait() Hace que el subproceso actual espere hasta que se active (por lo general, se notifica o se interrumpe).

Constantes

SERVICIO_SANDBOX_CONTROLLER_SDK

Se agregó en el nivel de API 34
También en Extensiones de servicios de anuncios 5

public static final String SDK_SANDBOX_CONTROLLER_SERVICE

Valor constante: “sdk_sandbox_controller_service”

Métodos públicos

getAppOwnedSdkSandboxInterfaces

Se agregó en UpsideDownCakePrivacySandbox de Android

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

Recupera todos los AppOwnedSdkSandboxInterface que registró la app.

Muestra
List<AppOwnedSdkSandboxInterface>	Lista de AppOwnedSdkSandboxInterface con todos los activos registrados actualmente AppOwnedSdkSandboxInterface. Este valor no puede ser null.

Arroja
UnsupportedOperationException	si el controlador se obtiene de una respuesta adicional. Usa SandboxedSdkProvider#getContext() para obtener el contexto adecuado

getClientPackageName

Se agregó en UpsideDownCakePrivacySandbox de Android

public String getClientPackageName ()

Muestra el nombre del paquete de la app cliente.

Muestra
String	Este valor no puede ser null.

Arroja
UnsupportedOperationException	si el controlador se obtiene de una respuesta adicional. Usa SandboxedSdkProvider#getContext() para obtener el contexto adecuado.

getClientSharedPreferences

Se agregó en el nivel de API 34
También en Extensiones de servicios de anuncios 5

public SharedPreferences getClientSharedPreferences ()

Muestra un objeto SharedPreferences que contiene datos sincronizados desde la app cliente.

Las claves que la app cliente sincronizó con SdkSandboxManager.addSyncedSharedPreferencesKeys(Set) se pueden encontrar en este SharedPreferences.

El SharedPreferences que se muestra solo debe leerse. Escribir en él no es no es compatible.

Muestra
SharedPreferences	SharedPreferences, que contiene datos sincronizados desde la app cliente. Este valor no puede ser null.

Arroja
UnsupportedOperationException	si el controlador se obtiene de una respuesta adicional. Usa SandboxedSdkProvider#getContext() para obtener el contexto adecuado

getSandboxedSdks

Se agregó en el nivel de API 34
También en Extensiones de servicios de anuncios 5

public List<SandboxedSdk> getSandboxedSdks ()

Recupera información sobre los SDKs que se cargan en la zona de pruebas.

Muestra
List<SandboxedSdk>	Lista de SandboxedSdk que contiene todos los SDKs cargados actualmente Este valor no puede ser null.

Arroja
UnsupportedOperationException	si el controlador se obtiene de una respuesta adicional. Usa SandboxedSdkProvider#getContext() para obtener el contexto adecuado

loadSdk

Se agregó en UpsideDownCakePrivacySandbox de Android

public void loadSdk (String sdkName, 
                Bundle params, 
                Executor executor, 
                OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)

Carga el SDK en un proceso de Java de la zona de pruebas del SDK.

Carga la biblioteca del SDK con sdkName en un proceso de zona de pruebas del SDK de forma asíncrona. El el emisor recibirá una notificación a través del receiver.

El llamador solo puede cargar SDKs de la que depende la app cliente en la zona de pruebas del SDK.

Parámetros
sdkName	String: Es el nombre del SDK que se cargará. Este valor no puede ser null.
params	Bundle: Son parámetros adicionales que se pasarán al SDK en forma de Bundle. según lo acordado entre el cliente y el SDK. Este valor no puede ser null.
executor	Executor: Es el Executor en el que se invoca al receptor. Este valor no puede ser null. Los eventos de devolución de llamada y de objetos de escucha se envían a través de este Executor, lo que proporciona una manera fácil de controlar el subproceso que se usa. Para enviar eventos a través del subproceso principal de tu aplicación, puedes usar Context.getMainExecutor(). De lo contrario, proporciona un Executor que se envíe a un subproceso adecuado.
receiver	OutcomeReceiver: Recibe un SandboxedSdk en una ejecución correcta o LoadSdkException. Este valor no puede ser null.

Arroja
UnsupportedOperationException	si el controlador se obtiene de una respuesta adicional. Usa SandboxedSdkProvider#getContext() para obtener el contexto adecuado

registerSdkSandboxActivityHandler

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 7.

public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Muestra un identificador para un SdkSandboxActivityHandler después de registrarlo.

Esta función registra una implementación de SdkSandboxActivityHandler creada por Un SDK y muestra un IBinder que identifica de forma única el objeto SdkSandboxActivityHandler pasado.

Si el mismo SdkSandboxActivityHandler se registró varias veces sin anulando el registro, se devolverá el mismo token de IBinder.

Parámetros
sdkSandboxActivityHandler	SdkSandboxActivityHandler: es el SdkSandboxActivityHandler que se registrará. Este valor no puede ser null.

Muestra
IBinder	IBinder identifica de forma exclusiva el SdkSandboxActivityHandler pasado. Este valor no puede ser null.

unregisterSdkSandboxActivityHandler

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 7.

public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Cancela el registro de un SdkSandboxActivityHandler ya registrado.

Si se registra el SdkSandboxActivityHandler pasado, se cancelará el registro. De lo contrario, no hará nada.

Después de cancelar el registro, el SDK puede volver a registrar el mismo objeto de controlador o crear uno nuevo en en caso de que quiera un Activity nuevo.

Si el token IBinder del controlador no registrado se usó para iniciar una Activity, No se iniciará Activity.

Parámetros
sdkSandboxActivityHandler	SdkSandboxActivityHandler: es el SdkSandboxActivityHandler que se debe cancelar. Este valor no puede ser null.

Resultado que se muestra
void	Este valor no puede ser null.