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 AppOwnedSdkSandboxInterface registrados pelo app.

String getClientPackageName()

Retorna o nome do pacote do app cliente.

SharedPreferences getClientSharedPreferences()

Retorna SharedPreferences contendo dados sincronizados do app cliente.

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 SdkSandboxActivityHandler depois de registrá-la.

void unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

Cancelar o registro de um SdkSandboxActivityHandler já registrado.

Métodos herdados

Object clone()

Cria e retorna uma cópia desse objeto.

boolean equals(Object obj)

Indica se algum outro objeto é "igual a" esse.

void finalize()

Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto.

final Class<?> getClass()

Retorna a classe de execução desse Object.

int hashCode()

Retorna um valor de código hash para o objeto.

final void notify()

Ativa uma única linha de execução que está em espera no monitor desse objeto.

final void notifyAll()

Ativa todos os threads que estão aguardando no monitor desse objeto.

String toString()

Retorna uma representação em string do objeto.

final void wait(long timeoutMillis, int nanos)

Faz com que a linha de execução atual espere até ser ativada, normalmente sendo notificada ou interrompida, ou até que um determinado período de tempo real tenha passado.

final void wait(long timeoutMillis)

Faz com que a linha de execução atual espere até ser ativada, normalmente sendo notificada ou interrompida, ou até que um determinado período de tempo real tenha passado.

final void wait()

Faz com que a linha de execução atual espere até ser ativada, normalmente sendo notificada ou interrompida.

Constantes

SDK_SANDBOX_CONTROLLER_SERVICE

Adicionado no nível 34 da API
Também está nas Extensões de serviços de publicidade 5 
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 obtido de uma 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 obtido 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.