Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4

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 Context, qui peut ensuite être reçu à l'aide de getContext().

void beforeUnloadSdk()

Effectue le travail nécessaire pour que le SDK libère ses ressources avant le déchargement.

final Context getContext()

Affiche le Context précédemment défini via SandboxedSdkProvider#attachContext.

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

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

Méthodes publiques

attachContext

Ajouté au niveau d'API 34
É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

Ajouté au niveau d'API 34
É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

Ajouté au niveau d'API 34
É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

Ajouté au niveau d'API 34
É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

Ajouté au niveau d'API 34
É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