SdkSandboxController

public class SdkSandboxController
extends Object

java.lang.Объект
↳ android.app.sdksandbox.sdkprovider.SdkSandboxController

Контроллер, который используется SDK, загруженным в песочницу, для доступа к информации, предоставляемой песочницей SDK.

Это позволяет SDK взаимодействовать с другими SDKS в изолированной программной среде SDK и узнавать о состоянии SDK, которые в данный момент загружены в него.

Экземпляр SdkSandboxController можно получить с помощью Context.getSystemService(Class) и class . Context в свою очередь, можно получить с помощью SandboxedSdkProvider.getContext() .

Краткое содержание

Константы

String SDK_SANDBOX_CONTROLLER_SERVICE

Публичные методы

List < AppOwnedSdkSandboxInterface > getAppOwnedSdkSandboxInterfaces ()

Извлекает все AppOwnedSdkSandboxInterface , зарегистрированные приложением.

String getClientPackageName ()

Возвращает имя пакета клиентского приложения.

SharedPreferences getClientSharedPreferences ()

Возвращает SharedPreferences содержащий данные, синхронизированные из клиентского приложения.

List < SandboxedSdk > getSandboxedSdks ()

Получает информацию о SDK, загруженных в песочницу.

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

Загружает SDK в Java-процесс песочницы SDK.

IBinder registerSdkSandboxActivityHandler ( SdkSandboxActivityHandler sdkSandboxActivityHandler)

Возвращает идентификатор SdkSandboxActivityHandler после его регистрации.

void unregisterSdkSandboxActivityHandler ( SdkSandboxActivityHandler sdkSandboxActivityHandler)

Отмените регистрацию уже зарегистрированного SdkSandboxActivityHandler .

Унаследованные методы

Object clone ()

Создает и возвращает копию этого объекта.

boolean equals ( Object obj)

Указывает, «равен» ли какой-либо другой объект этому объекту.

void finalize ()

Вызывается сборщиком мусора для объекта, когда сборщик мусора определяет, что ссылок на объект больше нет.

final Class <?> getClass ()

Возвращает класс времени выполнения этого Object .

int hashCode ()

Возвращает значение хэш-кода для объекта.

final void notify ()

Пробуждает одиночный поток, ожидающий монитора этого объекта.

final void notifyAll ()

Пробуждает все потоки, ожидающие на мониторе этого объекта.

String toString ()

Возвращает строковое представление объекта.

final void wait (long timeoutMillis, int nanos)

Заставляет текущий поток ждать, пока он не будет пробужден, обычно путем получения уведомления или прерывания , или до тех пор, пока не истечет определенное количество реального времени.

final void wait (long timeoutMillis)

Заставляет текущий поток ждать, пока он не будет пробужден, обычно путем получения уведомления или прерывания , или до тех пор, пока не истечет определенное количество реального времени.

final void wait ()

Заставляет текущий поток ждать, пока он не будет пробужден, обычно путем получения уведомления или прерывания .

Константы

SDK_SANDBOX_CONTROLLER_SERVICE

Добавлено на уровне API 34.
Также в расширениях рекламных служб 5. 
public static final String SDK_SANDBOX_CONTROLLER_SERVICE

Постоянное значение: «sdk_sandbox_controller_service»

Публичные методы

getAppOwnedSdkSandboxInterfaces

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

Извлекает все AppOwnedSdkSandboxInterface , зарегистрированные приложением.

Возврат
List < AppOwnedSdkSandboxInterface > Список AppOwnedSdkSandboxInterface содержащий все зарегистрированные на данный момент AppOwnedSdkSandboxInterface. Это значение не может быть null .

Броски
UnsupportedOperationException если контроллер получен из неожиданного контекста. Используйте SandboxedSdkProvider#getContext() для правильного контекста.

getClientPackageName

public String getClientPackageName ()

Возвращает имя пакета клиентского приложения.

Возврат
String Это значение не может быть null .

Броски
UnsupportedOperationException если контроллер получен из неожиданного контекста. Используйте SandboxedSdkProvider#getContext() для правильного контекста.

getClientSharedPreferences

public SharedPreferences getClientSharedPreferences ()

Возвращает SharedPreferences содержащий данные, синхронизированные из клиентского приложения.

Ключи, синхронизированные клиентским приложением с помощью SdkSandboxManager.addSyncedSharedPreferencesKeys(Set) можно найти в этом SharedPreferences .

Возвращенные SharedPreferences следует только читать. Запись в него не поддерживается.

Возврат
SharedPreferences SharedPreferences содержащий данные, синхронизированные из клиентского приложения. Это значение не может быть null .

Броски
UnsupportedOperationException если контроллер получен из неожиданного контекста. Используйте SandboxedSdkProvider#getContext() для правильного контекста.

getSandboxedSdks

public List<SandboxedSdk> getSandboxedSdks ()

Получает информацию о SDK, загруженных в песочницу.

Возврат
List < SandboxedSdk > Список SandboxedSdk содержащий все загруженные в данный момент SDK. Это значение не может быть null .

Броски
UnsupportedOperationException если контроллер получен из неожиданного контекста. Используйте SandboxedSdkProvider#getContext() для правильного контекста.

loadSdk

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

Загружает SDK в Java-процесс песочницы SDK.

Асинхронно загружает библиотеку SDK с sdkName в процесс песочницы SDK. Вызывающий абонент будет уведомлен через receiver .

Вызывающий может загружать в изолированную программную среду SDK только SDKs , от которых зависит клиентское приложение.

Параметры
sdkName String : имя загружаемого SDK. Это значение не может быть null .

params Bundle : дополнительные параметры, которые будут переданы в SDK в форме Bundle по соглашению между клиентом и SDK. Это значение не может быть null .

executor Executor : Executor , к которому вызывается получатель. Это значение не может быть null . События обратного вызова и прослушивателя отправляются через этот Executor , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать Context.getMainExecutor() . В противном случае предоставьте Executor , который отправляет данные в соответствующий поток.

receiver OutcomeReceiver : он либо получает SandboxedSdk при успешном запуске, либо LoadSdkException . Это значение не может быть null .

Броски
UnsupportedOperationException если контроллер получен из неожиданного контекста. Используйте SandboxedSdkProvider#getContext() для правильного контекста.

зарегистрироватьSdkSandboxActivityHandler

public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Возвращает идентификатор SdkSandboxActivityHandler после его регистрации.

Эта функция регистрирует реализацию SdkSandboxActivityHandler , созданную SDK, и возвращает IBinder , который однозначно идентифицирует переданный объект SdkSandboxActivityHandler .

Если один и тот же SdkSandboxActivityHandler зарегистрирован несколько раз без отмены регистрации, будет возвращен один и тот же токен IBinder .

Параметры
sdkSandboxActivityHandler SdkSandboxActivityHandler : SdkSandboxActivityHandler для регистрации. Это значение не может быть null .

Возврат
IBinder IBinder однозначно идентифицирует переданный SdkSandboxActivityHandler . Это значение не может быть null .

отменить регистрациюSdkSandboxActivityHandler

public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Отмените регистрацию уже зарегистрированного SdkSandboxActivityHandler .

Если переданный SdkSandboxActivityHandler зарегистрирован, он будет отменен. В противном случае это ничего не даст.

После отмены регистрации SDK может снова зарегистрировать тот же объект-обработчик или создать новый, если ему понадобится новое Activity .

Если токен IBinder незарегистрированного обработчика используется для запуска Activity , Activity не запустится.

Параметры
sdkSandboxActivityHandler SdkSandboxActivityHandler : SdkSandboxActivityHandler для отмены регистрации. Это значение не может быть null .

Возврат
void Это значение не может быть null .