Controller SdkSandbox

public class SdkSandboxController
extends Object

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


Controller utilizzato dall'SDK caricato nella sandbox per accedere alle informazioni fornite dall'SDK sandbox.

Consente all'SDK di comunicare con altri SDK nella sandbox dell'SDK e di conoscere lo stato SDK attualmente caricati al suo interno.

È possibile ottenere un'istanza di SdkSandboxController utilizzando Context.getSystemService(Class) e class. Context può a sua volta ottenibile utilizzando SandboxedSdkProvider.getContext().

Riepilogo

Costanti

String SDK_SANDBOX_CONTROLLER_SERVICE

Metodi pubblici

List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces()

Recupera tutti i AppOwnedSdkSandboxInterface registrati dall'app.

String getClientPackageName()

Restituisce il nome del pacchetto dell'app client.

SharedPreferences getClientSharedPreferences()

Restituisce SharedPreferences contenente i dati sincronizzati dall'app client.

List<SandboxedSdk> getSandboxedSdks()

Recupera le informazioni sugli SDK caricati nella sandbox.

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

Carica l'SDK in un processo Java della sandbox dell'SDK.

IBinder registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

Restituisce un identificatore per un SdkSandboxActivityHandler dopo averlo registrato.

void unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

Annulla la registrazione di un SdkSandboxActivityHandler già registrato.

Metodi ereditati

Costanti

SDK_SANDBOX_CONTROLLER_SERVICE

public static final String SDK_SANDBOX_CONTROLLER_SERVICE

Valore costante: "sdk_sandbox_controller_service"

Metodi pubblici

Interfacce getAppOwnedSdkSandbox

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

Recupera tutti i AppOwnedSdkSandboxInterface registrati dall'app.

Ritorni
List<AppOwnedSdkSandboxInterface> Elenco di AppOwnedSdkSandboxInterface contenente tutti gli elementi attualmente registrati InterfacciaAppDi proprietàSdkSandbox. Questo valore non può essere null.

Lanci
UnsupportedOperationException se il controller viene ottenuto da un contesto. Usa SandboxedSdkProvider#getContext() per il contesto corretto

getClientPackageName

public String getClientPackageName ()

Restituisce il nome del pacchetto dell'app client.

Ritorni
String Questo valore non può essere null.

Lanci
UnsupportedOperationException se il controller viene ottenuto da un contesto. Usa SandboxedSdkProvider#getContext() per il contesto giusto.

getClientSharedPreferences

public SharedPreferences getClientSharedPreferences ()

Restituisce SharedPreferences contenente i dati sincronizzati dall'app client.

In questo SharedPreferences sono disponibili le chiavi che sono state sincronizzate dall'app client utilizzando SdkSandboxManager.addSyncedSharedPreferencesKeys(Set).

L'elemento SharedPreferences restituito deve essere letto. Scrivirle non significa supportati.

Ritorni
SharedPreferences SharedPreferences con dati sincronizzati dall'app client. Questo valore non può essere null.

Lanci
UnsupportedOperationException se il controller viene ottenuto da un contesto. Usa SandboxedSdkProvider#getContext() per il contesto corretto

getSandboxedSdks

public List<SandboxedSdk> getSandboxedSdks ()

Recupera le informazioni sugli SDK caricati nella sandbox.

Ritorni
List<SandboxedSdk> Elenco di SandboxedSdk contenente tutti gli SDK attualmente caricati Questo valore non può essere null.

Lanci
UnsupportedOperationException se il controller viene ottenuto da un contesto. Usa SandboxedSdkProvider#getContext() per il contesto corretto

caricamentoSdk

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

Carica l'SDK in un processo Java della sandbox dell'SDK.

Carica la libreria SDK con sdkName in un processo sandbox SDK in modo asincrono. La il chiamante riceverà una notifica tramite il receiver.

Il chiamante può caricare nella sandbox dell'SDK solo SDKs da cui dipende l'app client.

Parametri
sdkName String: nome dell'SDK da caricare. Questo valore non può essere null.

params Bundle: parametri aggiuntivi da passare all'SDK sotto forma di Bundle. come concordato tra il client e l'SDK. Questo valore non può essere null.

executor Executor: il Executor su cui richiamare il ricevitore. Questo valore non può essere null. Gli eventi di callback e listener vengono inviati tramite questo Executor, che consente di controllare facilmente quale thread in uso. Per inviare eventi tramite il thread principale del tuo puoi utilizzare Context.getMainExecutor(). In caso contrario, specifica un valore Executor che effettui l'invio a un thread appropriato.

receiver OutcomeReceiver: questo riceve un SandboxedSdk in un'esecuzione corretta, oppure LoadSdkException. Questo valore non può essere null.

Lanci
UnsupportedOperationException se il controller viene ottenuto da un contesto. Usa SandboxedSdkProvider#getContext() per il contesto corretto

registrySdkSandboxActivityGestori

public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Restituisce un identificatore per un SdkSandboxActivityHandler dopo averlo registrato.

Questa funzione registra un'implementazione di SdkSandboxActivityHandler creata da un SDK e restituisce un IBinder che identifica in modo univoco l'oggetto SdkSandboxActivityHandler passato.

Se lo stesso SdkSandboxActivityHandler si è registrato più volte senza l'annullamento della registrazione, verrà restituito lo stesso token IBinder.

Parametri
sdkSandboxActivityHandler SdkSandboxActivityHandler: è il SdkSandboxActivityHandler da registrare. Questo valore non può essere null.

Ritorni
IBinder IBinder identifica in modo univoco il SdkSandboxActivityHandler superato. Questo valore non può essere null.

annullare la registrazioneSdkSandboxActivityGestori

public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Annulla la registrazione di un SdkSandboxActivityHandler già registrato.

Se l'oggetto SdkSandboxActivityHandler superato è registrato, la registrazione verrà annullata. In caso contrario, l'operazione non produce alcun effetto.

Dopo l'annullamento della registrazione, l'SDK può registrare di nuovo lo stesso oggetto gestore o crearne uno nuovo in caso desidera un nuovo Activity.

Se il token IBinder del gestore non registrato utilizzato per avviare Activity, il dispositivo Activity non si avvia.

Parametri
sdkSandboxActivityHandler SdkSandboxActivityHandler: è il SdkSandboxActivityHandler che deve annullare la registrazione. Questo valore non può essere null.

Ritorni
void Questo valore non può essere null.