SdkSandboxController
public
class
SdkSandboxController
extends Object
java.lang.Object | |
↳ | android.app.sdksandbox.sdkprovider.SdkSandboxController |
Controlador usado pelo SDK carregado no sandbox para acessar informações fornecidas pelo SDK sandbox
Permite que o SDK se comunique com outros SDKs no sandbox do SDK e conheça o estado dos SDKs carregados atualmente nela.
Uma instância de SdkSandboxController
pode ser recebida usando Context.getSystemService(Class)
e class
. O Context
pode, por sua vez,
ser obtidos usando SandboxedSdkProvider.getContext()
.
Resumo
Constantes | |
---|---|
String |
SDK_SANDBOX_CONTROLLER_SERVICE
|
Métodos públicos | |
---|---|
List<AppOwnedSdkSandboxInterface>
|
getAppOwnedSdkSandboxInterfaces()
Busca todos os |
String
|
getClientPackageName()
Retorna o nome do pacote do app cliente. |
SharedPreferences
|
getClientSharedPreferences()
Retorna |
List<SandboxedSdk>
|
getSandboxedSdks()
Busca informações sobre SDKs carregados no sandbox. |
void
|
loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)
Carrega o SDK em um processo Java do sandbox do SDK. |
IBinder
|
registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)
Retorna um identificador para uma |
void
|
unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)
Cancelar o registro de um |
Métodos herdados | |
---|---|
Constantes
SDK_SANDBOX_CONTROLLER_SERVICE
public static final String SDK_SANDBOX_CONTROLLER_SERVICE
Valor constante: "sdk_sandbox_controller_service"
Métodos públicos
getAppOwnedSdkSandboxInterfaces
public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()
Busca todos os AppOwnedSdkSandboxInterface
registrados pelo app.
Retorna | |
---|---|
List<AppOwnedSdkSandboxInterface> |
Lista de AppOwnedSdkSandboxInterface contendo todos os registros atualmente registrados
AppOwnedSdkSandboxInterface.
Esse valor não pode ser null . |
Gera | |
---|---|
UnsupportedOperationException |
se o controlador for recebido de uma origem
contexto. Use SandboxedSdkProvider#getContext() para o contexto certo |
getClientPackageName
public String getClientPackageName ()
Retorna o nome do pacote do app cliente.
Retorna | |
---|---|
String |
Esse valor não pode ser null . |
Gera | |
---|---|
UnsupportedOperationException |
se o controlador for recebido de uma origem
contexto. Use SandboxedSdkProvider#getContext() para o contexto certo. |
getClientSharedPreferences
public SharedPreferences getClientSharedPreferences ()
Retorna SharedPreferences
contendo dados sincronizados do app cliente.
As chaves que foram sincronizadas pelo app cliente usando SdkSandboxManager.addSyncedSharedPreferencesKeys(Set)
podem ser encontradas neste SharedPreferences
.
O SharedPreferences
retornado só pode ser lido. Escrever nele não é
suporte.
Retorna | |
---|---|
SharedPreferences |
SharedPreferences contendo dados sincronizados do app cliente.
Esse valor não pode ser null . |
Gera | |
---|---|
UnsupportedOperationException |
se o controlador for recebido de uma origem
contexto. Use SandboxedSdkProvider#getContext() para o contexto certo |
getSandboxedSdks
public List<SandboxedSdk> getSandboxedSdks ()
Busca informações sobre SDKs carregados no sandbox.
Retorna | |
---|---|
List<SandboxedSdk> |
Lista de SandboxedSdk contendo todos os SDKs carregados no momento
Esse valor não pode ser null . |
Gera | |
---|---|
UnsupportedOperationException |
se o controlador for recebido de uma origem
contexto. Use SandboxedSdkProvider#getContext() para o contexto certo |
loadSdk
public void loadSdk (String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)
Carrega o SDK em um processo Java do sandbox do SDK.
Carrega a biblioteca do SDK com sdkName
para um processo de sandbox do SDK de forma assíncrona. A
autor da chamada será notificado por receiver
.
O autor da chamada só pode carregar os SDKs
de que o app cliente depende no sandbox do SDK.
Parâmetros | |
---|---|
sdkName |
String : nome do SDK a ser carregado.
Esse valor não pode ser null . |
params |
Bundle : outros parâmetros que vão ser transmitidos ao SDK na forma de um Bundle .
conforme acordado entre o cliente e o SDK.
Esse valor não pode ser null . |
executor |
Executor : o Executor em que o receptor será invocado.
Esse valor não pode ser null .
Eventos de callback e listener são enviados com esse
Executor , fornecendo uma maneira fácil de controlar qual linha de execução vai ser
usada. Para enviar eventos com a linha de execução principal do
aplicativo, use
Context.getMainExecutor() .
Caso contrário, forneça um Executor que seja enviado para uma linha de execução adequada. |
receiver |
OutcomeReceiver : recebe um SandboxedSdk em uma execução bem-sucedida ou LoadSdkException .
Esse valor não pode ser null . |
Gera | |
---|---|
UnsupportedOperationException |
se o controlador for recebido de uma origem
contexto. Use SandboxedSdkProvider#getContext() para o contexto certo |
registerSdkSandboxActivityHandler
public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)
Retorna um identificador para uma SdkSandboxActivityHandler
depois de registrá-la.
Essa função registra uma implementação de SdkSandboxActivityHandler
criada pelo
um SDK e retorna um IBinder
que identifica exclusivamente o objeto SdkSandboxActivityHandler
transmitido.
Se o mesmo SdkSandboxActivityHandler
for registrado várias vezes sem
cancelar o registro, o mesmo token IBinder
será retornado.
Parâmetros | |
---|---|
sdkSandboxActivityHandler |
SdkSandboxActivityHandler : é o SdkSandboxActivityHandler a ser registrado.
Esse valor não pode ser null . |
Retorna | |
---|---|
IBinder |
IBinder identifica exclusivamente o SdkSandboxActivityHandler transmitido.
Esse valor não pode ser null . |
cancelar o registroSdkSandboxActivityHandler
public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)
Cancelar o registro de um SdkSandboxActivityHandler
já registrado.
Se o SdkSandboxActivityHandler
transmitido estiver registrado, o registro será cancelado.
Caso contrário, ele não vai fazer nada.
Após o cancelamento do registro, o SDK pode registrar o mesmo objeto gerenciador novamente ou criar um novo em
caso, ele quer um novo Activity
.
Se o token IBinder
do gerenciador não registrado usado para iniciar um Activity
,
o Activity
não vai ser iniciado.
Parâmetros | |
---|---|
sdkSandboxActivityHandler |
SdkSandboxActivityHandler : é o SdkSandboxActivityHandler para cancelar o registro.
Esse valor não pode ser null . |
Retorna | |
---|---|
void |
Esse valor não pode ser null . |