Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 5

SdkSandboxController

public class SdkSandboxController
extends Object

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


Contrôleur utilisé par le SDK chargé dans le bac à sable pour accéder aux informations fournies par celui-ci dans l'environnement de bac à sable.

Il permet au SDK de communiquer avec d'autres SDK dans le bac à sable du SDK et de connaître l'état des SDK qui y sont actuellement chargés.

Vous pouvez obtenir une instance de SdkSandboxController à l'aide de Context.getSystemService(Class) et de class. Le Context peut à son tour être obtenu à l'aide de SandboxedSdkProvider.getContext().

Résumé

Constantes

String SDK_SANDBOX_CONTROLLER_SERVICE

Méthodes publiques

List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces()

Récupère tous les AppOwnedSdkSandboxInterface enregistrés par l'application.

String getClientPackageName()

Renvoie le nom de package de l'application cliente.

SharedPreferences getClientSharedPreferences()

Renvoie SharedPreferences contenant les données synchronisées à partir de l'application cliente.

List<SandboxedSdk> getSandboxedSdks()

Extrait des informations sur les SDK chargés dans le bac à sable.

void loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdkLoadSdkException> receiver)

Charge le SDK dans un processus Java du bac à sable du SDK.

IBinder registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

Renvoie un identifiant pour un SdkSandboxActivityHandler après l'avoir enregistré.

void unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

Annuler l'enregistrement d'un SdkSandboxActivityHandler déjà enregistré

Méthodes héritées

Constantes

SDK_SANDBOX_CONTROLLER_SERVICE

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 5
public static final String SDK_SANDBOX_CONTROLLER_SERVICE

Valeur constante: "sdk_sandbox_controller_service"

Méthodes publiques

getAppOwnedSdkSandboxInterfaces

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

Récupère tous les AppOwnedSdkSandboxInterface enregistrés par l'application.

Renvoie
List<AppOwnedSdkSandboxInterface> Liste de AppOwnedSdkSandboxInterface contenant tous les enregistrements actuellement enregistrés AppOwnedSdkSandboxInterface. Cette valeur ne peut pas être null.

Génère
UnsupportedOperationException si le contrôleur est obtenu à partir d'une le contexte. Utiliser SandboxedSdkProvider#getContext() pour le contexte approprié

getClientPackageName

public String getClientPackageName ()

Renvoie le nom de package de l'application cliente.

Renvoie
String Cette valeur ne peut pas être null.

Génère
UnsupportedOperationException si le contrôleur est obtenu à partir d'une le contexte. Utilisez SandboxedSdkProvider#getContext() pour le bon contexte.

getClientSharedPreferences

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 5
public SharedPreferences getClientSharedPreferences ()

Renvoie SharedPreferences contenant les données synchronisées à partir de l'application cliente.

Les clés qui ont été synchronisées par l'application cliente à l'aide de SdkSandboxManager.addSyncedSharedPreferencesKeys(Set) se trouvent dans ce SharedPreferences.

Le SharedPreferences renvoyé ne doit être lu que. Écrire dans cette table n'est pas compatibles.

Renvoie
SharedPreferences SharedPreferences contenant des données synchronisées à partir de l'application cliente. Cette valeur ne peut pas être null.

Génère
UnsupportedOperationException si le contrôleur est obtenu à partir d'une le contexte. Utiliser SandboxedSdkProvider#getContext() pour le contexte approprié

getSandboxedSdks

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 5
public List<SandboxedSdk> getSandboxedSdks ()

Extrait des informations sur les SDK chargés dans le bac à sable.

Renvoie
List<SandboxedSdk> Liste de SandboxedSdk contenant tous les SDK actuellement chargés Cette valeur ne peut pas être null.

Génère
UnsupportedOperationException si le contrôleur est obtenu à partir d'une le contexte. Utiliser SandboxedSdkProvider#getContext() pour le contexte approprié

chargeSdk

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

Charge le SDK dans un processus Java du bac à sable du SDK.

Charge de manière asynchrone la bibliothèque du SDK avec sdkName dans un processus de bac à sable du SDK. La l'appelant sera averti via le receiver.

L'appelant ne peut charger que les SDKs dont dépend l'application cliente dans le bac à sable du SDK.

Paramètres
sdkName String: nom du SDK à charger. Cette valeur ne peut pas être null.

params Bundle: paramètres supplémentaires à transmettre au SDK sous la forme d'un Bundle. comme convenu entre le client et le SDK. Cette valeur ne peut pas être null.

executor Executor: Executor sur lequel appeler le récepteur. Cette valeur ne peut pas être null. Les événements de rappel et d'écouteur sont envoyés via Executor, ce qui permet de contrôler facilement le thread qui est utilisé. Pour envoyer des événements via le thread principal de votre vous pouvez utiliser Context.getMainExecutor() Sinon, fournissez un Executor qui sera envoyé à un thread approprié.

receiver OutcomeReceiver: reçoit soit une SandboxedSdk lors d'une exécution réussie, soit une LoadSdkException. Cette valeur ne peut pas être null.

Génère
UnsupportedOperationException si le contrôleur est obtenu à partir d'une le contexte. Utiliser SandboxedSdkProvider#getContext() pour le contexte approprié

RegisterSdkSandboxActivityHandler

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 7
public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Renvoie un identifiant pour un SdkSandboxActivityHandler après l'avoir enregistré.

Cette fonction enregistre une implémentation de SdkSandboxActivityHandler créée par un SDK et renvoie un IBinder qui identifie de manière unique l'objet SdkSandboxActivityHandler transmis.

Si le même SdkSandboxActivityHandler s'est enregistré plusieurs fois sans l'annulation de l'enregistrement, le même jeton IBinder est renvoyé.

Paramètres
sdkSandboxActivityHandler SdkSandboxActivityHandler: est le SdkSandboxActivityHandler à enregistrer. Cette valeur ne peut pas être null.

Renvoie
IBinder IBinder identifie de manière unique le SdkSandboxActivityHandler transmis. Cette valeur ne peut pas être null.

unregisterSdkSandboxActivityHandler

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 7
public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Annuler l'enregistrement d'un SdkSandboxActivityHandler déjà enregistré.

Si le SdkSandboxActivityHandler transmis est enregistré, il sera annulé. Sinon, il n'a aucun effet.

Après l'annulation de l'enregistrement, le SDK peut enregistrer à nouveau le même objet de gestionnaire ou en créer un nouveau dans il veut un nouveau Activity.

Si le jeton IBinder du gestionnaire non enregistré a été utilisé pour démarrer une Activity, Activity ne démarrera pas.

Paramètres
sdkSandboxActivityHandler SdkSandboxActivityHandler: est l'élément SdkSandboxActivityHandler dont l'enregistrement doit être annulé. Cette valeur ne peut pas être null.

Valeur affichée
void Cette valeur ne peut pas être null.