SdkSandboxController
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 dalla sandbox dell'SDK.
Consente all'SDK di comunicare con altri SDK nella sandbox dell'SDK e di conoscere lo stato degli SDK attualmente caricati.
Un'istanza di SdkSandboxController
può essere ottenuta utilizzando Context.getSystemService(Class)
e class
. A sua volta, Context
può essere ottenuto utilizzando SandboxedSdkProvider.getContext()
.
Riepilogo
Costanti | |
---|---|
String |
SDK_SANDBOX_CONTROLLER_SERVICE
|
Metodi pubblici | |
---|---|
List<AppOwnedSdkSandboxInterface>
|
getAppOwnedSdkSandboxInterfaces()
Recupera tutti i |
String
|
getClientPackageName()
Restituisce il nome del pacchetto dell'app client. |
SharedPreferences
|
getClientSharedPreferences()
Restituisce |
List<SandboxedSdk>
|
getSandboxedSdks()
Recupera le informazioni sugli SDK caricati nella sandbox. |
void
|
loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)
Carica l'SDK in un processo Java della sandbox dell'SDK. |
IBinder
|
registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)
Restituisce un identificatore per un elemento |
void
|
unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)
Annulla la registrazione di un |
Metodi ereditati | |
---|---|
Costanti
SDK_SANDBOX_CONTROLLER_SERVICE
public static final String SDK_SANDBOX_CONTROLLER_SERVICE
Valore costante: "sdk_sandbox_controller_service"
Metodi pubblici
getAppOwnedSdkSandboxInterfaces
public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()
Recupera tutti i AppOwnedSdkSandboxInterface
registrati dall'app.
Ritorni | |
---|---|
List<AppOwnedSdkSandboxInterface> |
Elenco di AppOwnedSdkSandboxInterface contenente tutti i contenuti AppOwnedSdkSandboxInterface attualmente registrati.
Questo valore non può essere null . |
Tiri | |
---|---|
UnsupportedOperationException |
se il controller è ottenuto da un contesto imprevisto. Usa SandboxedSdkProvider#getContext() per il contesto giusto |
getClientPackageName
public String getClientPackageName ()
Restituisce il nome del pacchetto dell'app client.
Ritorni | |
---|---|
String |
Questo valore non può essere null . |
Tiri | |
---|---|
UnsupportedOperationException |
se il controller è ottenuto da un contesto imprevisto. Usa SandboxedSdkProvider#getContext() per il contesto appropriato. |
getClientSharedPreferences
public SharedPreferences getClientSharedPreferences ()
Restituisce SharedPreferences
contenente dati sincronizzati dall'app client.
Le chiavi che sono state sincronizzate dall'app client utilizzando SdkSandboxManager.addSyncedSharedPreferencesKeys(Set)
sono disponibili in questa SharedPreferences
.
Il valore SharedPreferences
restituito deve essere solo letto. La scrittura non è supportata.
Ritorni | |
---|---|
SharedPreferences |
SharedPreferences contenente dati sincronizzati dall'app client.
Questo valore non può essere null . |
Tiri | |
---|---|
UnsupportedOperationException |
se il controller è ottenuto da un contesto imprevisto. Usa SandboxedSdkProvider#getContext() per il contesto giusto |
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 . |
Tiri | |
---|---|
UnsupportedOperationException |
se il controller è ottenuto da un contesto imprevisto. Usa SandboxedSdkProvider#getContext() per il contesto giusto |
LoadSdk
public void loadSdk (String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)
Carica l'SDK in un processo Java della sandbox dell'SDK.
Carica la libreria SDK con sdkName
in un processo sandbox dell'SDK in modo asincrono. Il chiamante riceverà una notifica tramite receiver
.
Il chiamante può caricare solo SDKs
elementi da cui dipende l'app client nella sandbox dell'SDK.
Parametri | |
---|---|
sdkName |
String : nome dell'SDK da caricare.
Questo valore non può essere null . |
params |
Bundle : parametri aggiuntivi da trasmettere all'SDK sotto forma di Bundle , come concordato tra il client e l'SDK.
Questo valore non può essere null . |
executor |
Executor : l'elemento Executor su cui richiamare il destinatario.
Questo valore non può essere null .
Gli eventi di callback e di listener vengono inviati tramite questo
Executor , offrendo un modo semplice per controllare quale thread viene
utilizzato. Per inviare eventi tramite il thread principale della tua
applicazione, puoi utilizzare
Context.getMainExecutor() .
In caso contrario, specifica un Executor che verrà inviato al thread appropriato. |
receiver |
OutcomeReceiver : riceve un SandboxedSdk se l'esecuzione è andata a buon fine oppure LoadSdkException .
Questo valore non può essere null . |
Tiri | |
---|---|
UnsupportedOperationException |
se il controller è ottenuto da un contesto imprevisto. Usa SandboxedSdkProvider#getContext() per il contesto giusto |
registrySdkSandboxActivityHandler
public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)
Restituisce un identificatore per un elemento 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
è stato registrato più volte senza
annullare la 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 trasmesso.
Questo valore non può essere null . |
unregisterSdkSandboxActivityHandler
public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)
Annulla la registrazione di un SdkSandboxActivityHandler
già registrato.
Se il SdkSandboxActivityHandler
superato è stato registrato, la registrazione verrà annullata.
In caso contrario, l'operazione non avrà alcun effetto.
Dopo l'annullamento della registrazione, l'SDK può registrare di nuovo lo stesso oggetto gestore o crearne uno nuovo nel caso voglia un nuovo Activity
.
Se il token IBinder
del gestore non registrato utilizzato per avviare un Activity
, l'Activity
non si avvia.
Parametri | |
---|---|
sdkSandboxActivityHandler |
SdkSandboxActivityHandler : è il SdkSandboxActivityHandler per annullare la registrazione.
Questo valore non può essere null . |
Ritorni | |
---|---|
void |
Questo valore non può essere null . |