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 |
String
|
getClientPackageName()
Muestra el nombre del paquete de la app cliente. |
SharedPreferences
|
getClientSharedPreferences()
Muestra un objeto |
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 |
void
|
unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)
Cancela el registro de un |
Métodos heredados | |
|---|---|
Constantes
SERVICIO_SANDBOX_CONTROLLER_SDK
public static final String SDK_SANDBOX_CONTROLLER_SERVICE
Valor constante: “sdk_sandbox_controller_service”
Métodos públicos
getAppOwnedSdkSandboxInterfaces
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
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
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
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
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
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
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. |