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

Резюме: Константы | Методы | Унаследованные методы

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 .

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

Из класса java.lang.Object 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

Добавлено в Android UpsideDownCakePrivacySandbox.

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

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

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

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

getClientPackageName

Добавлено в Android UpsideDownCakePrivacySandbox.

public String getClientPackageName ()

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

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

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

getClientSharedPreferences

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

public SharedPreferences getClientSharedPreferences ()

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

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

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

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

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

getSandboxedSdks

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

public List<SandboxedSdk> getSandboxedSdks ()

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

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

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

loadSdk

Добавлено в Android UpsideDownCakePrivacySandbox.

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

Добавлено на уровне API 34.
Также в расширениях рекламных служб 7.

public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

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

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

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

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

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

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

Добавлено на уровне API 34.
Также в расширениях рекламных служб 7.

public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

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

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

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

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

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

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