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 |
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 |
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
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<SandboxedSdk, LoadSdkException> 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 . |