SandboxedSdkProvider
public
abstract
class
SandboxedSdkProvider
extends Object
java.lang.Object | |
↳ | android.app.sdksandbox.SandboxedSdkProvider |
Encapsule l'API permettant au bac à sable du SDK d'interagir avec les SDK qui y sont chargés.
Le SDK doit implémenter cette classe abstraite pour générer un point d'entrée permettant au bac à sable du SDK de l'appeler.
Résumé
Constructeurs publics | |
---|---|
SandboxedSdkProvider()
|
Méthodes publiques | |
---|---|
final
void
|
attachContext(Context context)
Définit le SDK |
void
|
beforeUnloadSdk()
Effectue le travail nécessaire pour que le SDK libère ses ressources avant le déchargement. |
final
Context
|
getContext()
Affiche le |
abstract
View
|
getView(Context windowContext, Bundle params, int width, int height)
Demande l'affichage d'une vue à distance au processus de l'application cliente. |
abstract
SandboxedSdk
|
onLoadSdk(Bundle params)
Effectue le travail nécessaire pour que le SDK commence à traiter les requêtes. |
Méthodes héritées | |
---|---|
Constructeurs publics
SandboxedSdkProvider
Également disponible dans la section Extensions de services publicitaires 4
public SandboxedSdkProvider ()
Méthodes publiques
attachContext
Également disponible dans la section Extensions de services publicitaires 4
public final void attachContext (Context context)
Définit le SDK Context
, qui peut ensuite être reçu à l'aide de getContext()
. Cet appel est effectué avant l'appel de onLoadSdk(Bundle)
. Aucune opération nécessitant l'objet Context
ne doit être effectuée avant cet appel, car SandboxedSdkProvider#getContext
renvoie la valeur "null" tant que cette méthode n'a pas été appelée.
Génère une exception IllegalStateException si un contexte de base a déjà été défini.
Paramètres | |
---|---|
context |
Context : nouveau contexte de base.
Cette valeur ne peut pas être null . |
beforeUnloadSdk
Également disponible dans la section Extensions de services publicitaires 4
public void beforeUnloadSdk ()
Effectue le travail nécessaire pour que le SDK libère ses ressources avant le déchargement.
Cette fonction est appelée par le gestionnaire du bac à sable du SDK avant de décharger le SDK. Le SDK devrait causer l'échec de tous les appels au niveau du binder précédemment renvoyé au client via SandboxedSdk.getInterface()
.
Le SDK ne doit pas effectuer ici de tâches de longue durée, comme des E/S et des appels réseau.
getContext
Également disponible dans la section Extensions de services publicitaires 4
public final Context getContext ()
Renvoie l'élément Context
précédemment défini via SandboxedSdkProvider#attachContext
.
La valeur renvoyée est "null" si aucun contexte n'a été précédemment défini.
Renvoie | |
---|---|
Context |
getView
Également disponible dans la section Extensions de services publicitaires 4
public abstract View getView (Context windowContext, Bundle params, int width, int height)
Demande l'affichage d'une vue à distance au processus de l'application cliente.
L'élément View
renvoyé est encapsulé dans SurfacePackage
. Le SurfacePackage
généré est renvoyé à l'application cliente.
Le SDK ne doit pas effectuer ici de tâches de longue durée, comme des E/S et des appels réseau. Cela peut l'empêcher de recevoir des requêtes du client.
Paramètres | |
---|---|
windowContext |
Context : élément Context de l'écran qui doit afficher la vue. Cette valeur ne peut pas être null . |
params |
Bundle : liste des paramètres transmis à partir de l'application cliente demandant la vue. Cette valeur ne peut pas être null . |
width |
int : la vue renvoyée est affichée comme dans une fenêtre de cette largeur, en pixels. |
height |
int : la vue renvoyée est affichée comme dans une fenêtre de cette hauteur, en pixels. |
Renvoie | |
---|---|
View |
Un élément View que le bac à sable du SDK transmet à l'application cliente demandant la vue
Cette valeur ne peut pas être null . |
onLoadSdk
Également disponible dans la section Extensions de services publicitaires 4
public abstract SandboxedSdk onLoadSdk (Bundle params)
Effectue le travail nécessaire pour que le SDK commence à traiter les requêtes.
Cette fonction est appelée par le bac à sable du SDK après le chargement du SDK.
Le SDK doit exécuter toutes les tâches nécessaires pour être prêt à traiter les requêtes à venir. Il ne doit pas effectuer de tâches de longue durée ici, comme les E/S et les appels réseau. Cela peut l'empêcher de recevoir des requêtes du client. En outre, il ne doit pas effectuer d'initialisation qui dépend du chargement d'autres SDK dans le bac à sable du SDK.
Le SDK ne doit effectuer aucune opération nécessitant un objet Context
avant que cette méthode ne soit appelée.
Paramètres | |
---|---|
params |
Bundle : liste des paramètres transmis par le client lors du chargement du SDK. Cette valeur n'est pas obligatoire.
Cette valeur ne peut pas être null . |
Renvoie | |
---|---|
SandboxedSdk |
Renvoie un élément SandboxedSdk , retransmis au client. L'IBinder utilisé pour créer l'objet SandboxedSdk est utilisé par le client pour appeler le SDK.
Cette valeur ne peut pas être null . |
Génère | |
---|---|
LoadSdkException |