É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 |
String
|
getClientPackageName()
Renvoie le nom de package de l'application cliente. |
SharedPreferences
|
getClientSharedPreferences()
Renvoie |
List<SandboxedSdk>
|
getSandboxedSdks()
Extrait des informations sur les SDK chargés dans le bac à sable. |
void
|
loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)
Charge le SDK dans un processus Java du bac à sable du SDK. |
IBinder
|
registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)
Renvoie un identifiant pour un |
void
|
unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)
Annuler l'enregistrement d'un |
Méthodes héritées | |
---|---|
Constantes
SDK_SANDBOX_CONTROLLER_SERVICE
É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
É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
É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<SandboxedSdk, LoadSdkException> 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
É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
É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 . |