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 |
|