Ditambahkan di level API 33
Juga di Ekstensi Layanan Iklan 3

Ringkasan: Class Bertingkat | Konstanta | Metode | Metode Turunan

SdkSandboxManager

public final class SdkSandboxManager
extends Object

java.lang.Object
↳	android.app.sdksandbox.SdkSandboxManager

---

Menyediakan API untuk memuat SDKs ke dalam proses sandbox SDK, lalu berinteraksi dengannya.

Sandbox SDK adalah proses java yang berjalan dalam rentang uid terpisah. Setiap aplikasi mungkin memiliki SDK-nya sendiri dalam proses sandbox{i> <i}ini.

Aplikasi harus terlebih dahulu mendeklarasikan SDK yang menjadi dependensinya dalam manifesnya menggunakan tag <uses-sdk-library>. Aplikasi hanya dapat memuat SDK yang diandalkan ke sandbox SDK.

Lihat juga:

• SharedLibraryInfo.TYPE_SDK_PACKAGE
• Desain Runtime SDK proposal

Ringkasan

Class bertingkat
interface	SdkSandboxManager.SdkSandboxProcessDeathCallback Callback untuk melacak peristiwa pelacakan penghentian sandbox SDK.

Konstanta
String	EXTRA_DISPLAY_ID Nama kunci yang akan digunakan di kolom Paket requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver), nilainya harus menentukan ID bilangan bulat logika untuk menampilkan SurfacePackage.
String	EXTRA_HEIGHT_IN_PIXELS Nama kunci yang akan digunakan di kolom Paket requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver), nilainya harus menentukan tinggi bilangan bulat SurfacePackage dalam piksel.
String	EXTRA_HOST_TOKEN Nama kunci yang akan digunakan di kolom Paket requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver), nilainya harus menampilkan token yang ditampilkan oleh SurfaceView.getHostToken() setelah SurfaceView ditambahkan ke hierarki tampilan.
String	EXTRA_SURFACE_PACKAGE Nama kunci dalam Paket yang diteruskan ke fungsi onResult dari OutcomeReceiver yang merupakan kolom requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver), nilainya menampilkan SurfacePackage yang diminta.
String	EXTRA_WIDTH_IN_PIXELS Nama kunci yang akan digunakan di kolom Paket requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver), nilainya harus menentukan lebar bilangan bulat SurfacePackage dalam piksel.
int	LOAD_SDK_ALREADY_LOADED SDK sudah dimuat.
int	LOAD_SDK_INTERNAL_ERROR Terjadi error internal saat memuat SDK.
int	LOAD_SDK_NOT_FOUND SDK tidak ditemukan.
int	LOAD_SDK_SDK_DEFINED_ERROR Error SDK setelah dimuat.
int	LOAD_SDK_SDK_SANDBOX_DISABLED Sandbox SDK dinonaktifkan.
int	REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR Terjadi error internal saat meminta SurfacePackage.
int	REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED SDK tidak dimuat saat meminta SurfacePackage.
int	SDK_SANDBOX_PROCESS_NOT_AVAILABLE Proses sandbox SDK tidak tersedia.
String	SDK_SANDBOX_SERVICE Gunakan dengan Context#getSystemService(String) untuk mengambil SdkSandboxManager untuk berinteraksi dengan SDK milik aplikasi klien ini.
int	SDK_SANDBOX_STATE_DISABLED Sandbox SDK dinonaktifkan.
int	SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION Sandbox SDK diaktifkan.

Metode publik
void	addSdkSandboxProcessDeathCallback(Executor callbackExecutor, SdkSandboxManager.SdkSandboxProcessDeathCallback callback) Menambahkan callback yang terdaftar untuk peristiwa siklus proses sandbox SDK, seperti sandbox SDK kematian.
void	addSyncedSharedPreferencesKeys(Set<String> keys) Menambahkan kunci ke kumpulan kunci yang disinkronkan dari SharedPreferences default aplikasi ke SDK sandbox.
List<AppOwnedSdkSandboxInterface>	getAppOwnedSdkSandboxInterfaces() Mengambil daftar AppOwnedSdkSandboxInterface yang terdaftar untuk aplikasi
List<SandboxedSdk>	getSandboxedSdks() Mengambil informasi tentang SDK yang dimuat di sandbox.
static int	getSdkSandboxState() Menampilkan status ketersediaan fitur sandbox SDK saat ini.
Set<String>	getSyncedSharedPreferencesKeys() Menampilkan kumpulan kunci yang sedang disinkronkan dari SharedPreferences default aplikasi ke sandbox SDK.
void	loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver) Memuat SDK dalam proses java sandbox SDK.
void	registerAppOwnedSdkSandboxInterface(AppOwnedSdkSandboxInterface appOwnedSdkSandboxInterface) Mendaftarkan AppOwnedSdkSandboxInterface untuk proses aplikasi.
void	removeSdkSandboxProcessDeathCallback(SdkSandboxManager.SdkSandboxProcessDeathCallback callback) Menghapus SdkSandboxProcessDeathCallback yang sebelumnya ditambahkan menggunakan addSdkSandboxProcessDeathCallback(java.util.concurrent.Executor, android.app.sdksandbox.SdkSandboxManager.SdkSandboxProcessDeathCallback)
void	removeSyncedSharedPreferencesKeys(Set<String> keys) Menghapus kunci dari kumpulan kunci yang telah ditambahkan menggunakan addSyncedSharedPreferencesKeys(java.util.Set) Kunci yang dihapus akan dihapus dari sandbox SDK jika sudah disinkronkan.
void	requestSurfacePackage(String sdkName, Bundle params, Executor callbackExecutor, OutcomeReceiver<Bundle, RequestSurfacePackageException> receiver) Mengirim permintaan untuk paket platform ke SDK.
void	startSdkSandboxActivity(Activity fromActivity, IBinder sdkActivityToken) Memulai Activity di sandbox SDK.
void	unloadSdk(String sdkName) Menghapus muatan SDK yang sebelumnya telah dimuat oleh pemanggil.
void	unregisterAppOwnedSdkSandboxInterface(String name) Membatalkan pendaftaran ERROR(/AppOwnedSdkSandboxInterfaces) untuk proses aplikasi.

Metode turunan

Dari class java.lang.Object Object clone() Membuat dan menampilkan salinan objek ini. boolean equals(Object obj) Menunjukkan apakah beberapa objek lain "sama dengan" objek ini atau tidak. void finalize() Dipanggil oleh pembersih sampah memori pada sebuah objek saat pembersihan sampah memori menentukan bahwa tidak ada lagi referensi ke objek. final Class<?> getClass() Menampilkan class runtime dari Object ini. int hashCode() Menampilkan nilai kode hash untuk objek. final void notify() Mengaktifkan satu thread yang menunggu di monitor objek ini. final void notifyAll() Mengaktifkan semua thread yang menunggu di monitor objek ini. String toString() Menampilkan representasi string dari objek ini. final void wait(long timeoutMillis, int nanos) Menyebabkan thread saat ini menunggu hingga aktif, biasanya dengan menerima notifikasi atau terganggu, atau hingga sejumlah real time telah berlalu. final void wait(long timeoutMillis) Menyebabkan thread saat ini menunggu hingga aktif, biasanya dengan menerima notifikasi atau terganggu, atau hingga sejumlah real time telah berlalu. final void wait() Membuat thread saat ini menunggu hingga aktif, biasanya dengan menerima notifikasi atau terganggu.

Konstanta

ID_DISPLAY_TAMBAHAN

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final String EXTRA_DISPLAY_ID

Nama kunci yang akan digunakan di kolom Paket requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver), nilainya harus menentukan ID bilangan bulat logika untuk menampilkan SurfacePackage.

Nilai Konstanta: "android.app.sdksandbox.extra.DISPLAY_ID"

TAMBAHAN_TINGGI_IN_PIXELS

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final String EXTRA_HEIGHT_IN_PIXELS

Nama kunci yang akan digunakan di kolom Paket requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver), nilainya harus menentukan tinggi bilangan bulat SurfacePackage dalam piksel.

Nilai Konstanta: "android.app.sdksandbox.extra.HEIGHT_IN_PIXELS"

EXTRA_HOST_TOKEN

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final String EXTRA_HOST_TOKEN

Nama kunci yang akan digunakan di kolom Paket requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver), nilainya harus menampilkan token yang ditampilkan oleh SurfaceView.getHostToken() setelah SurfaceView ditambahkan ke hierarki tampilan. Hanya nilai non-null yang diterima untuk mengaktifkan pelaporan ANR.

Nilai Konstanta: "android.app.sdksandbox.extra.HOST_TOKEN"

PAKET_SURFACE_EXTRA_SURFACE

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final String EXTRA_SURFACE_PACKAGE

Nama kunci dalam Paket yang diteruskan ke fungsi onResult dari OutcomeReceiver yang merupakan kolom requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver), nilainya menampilkan SurfacePackage yang diminta.

Nilai Konstanta: "android.app.sdksandbox.extra.SURFACE_PACKAGE"

EXTRA_WIDTH_IN_PIXELS

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final String EXTRA_WIDTH_IN_PIXELS

Nama kunci yang akan digunakan di kolom Paket requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver), nilainya harus menentukan lebar bilangan bulat SurfacePackage dalam piksel.

Nilai Konstanta: "android.app.sdksandbox.extra.WIDTH_IN_PIXELS"

LOAD_SDK_ALREADY_LOADED

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final int LOAD_SDK_ALREADY_LOADED

SDK sudah dimuat.

Hal ini menunjukkan bahwa aplikasi klien mencoba memuat ulang SDK yang sama dengan memanggil loadSdk(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver) setelah berhasil dimuat.

Nilai Konstanta: 101 (0x00000065)

LOAD_SDK_INTERNAL_ERROR

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final int LOAD_SDK_INTERNAL_ERROR

Terjadi error internal saat memuat SDK.

Hal ini menunjukkan error internal umum yang terjadi saat menerapkan panggilan dari klien aplikasi.

Nilai Konstanta: 500 (0x000001f4)

LOAD_SDK_NOT_FOUND

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final int LOAD_SDK_NOT_FOUND

SDK tidak ditemukan.

Hal ini menunjukkan bahwa aplikasi klien mencoba memuat SDK yang tidak ada dengan memanggil loadSdk(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver).

Nilai Konstanta: 100 (0x00000064)

LOAD_SDK_SDK_DEFINED_ERROR

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final int LOAD_SDK_SDK_DEFINED_ERROR

Error SDK setelah dimuat.

Hal ini menunjukkan bahwa SDK mengalami error selama inisialisasi pasca-pemuatan. Tujuan detail informasi ini dapat diperoleh dari Paket yang ditampilkan di LoadSdkException melalui OutcomeReceiver yang diteruskan ke SdkSandboxManager#loadSdk.

Nilai Konstanta: 102 (0x00000066)

LOAD_SDK_SDK_SANDBOX_DISABLED

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final int LOAD_SDK_SDK_SANDBOX_DISABLED

Sandbox SDK dinonaktifkan.

Hal ini menunjukkan bahwa sandbox SDK dinonaktifkan. Setiap upaya selanjutnya untuk memuat SDK di proses {i>booting<i} ini juga akan gagal.

Nilai Konstanta: 103 (0x00000067)

REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final int REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR

Terjadi error internal saat meminta SurfacePackage.

Hal ini menunjukkan error internal generik yang terjadi saat meminta SurfacePackage.

Nilai Konstanta: 700 (0x000002bc)

REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 5

public static final int REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED

SDK tidak dimuat saat meminta SurfacePackage.

Hal ini menunjukkan bahwa SDK yang meminta SurfacePackage tidak dimuat, baik karena {i>sandbox<i} mati atau karena tidak dimuat sejak awal.

Nilai Konstanta: 701 (0x000002bd)

SDK_SANDBOX_PROGRESS_NOT_AVAILABLE

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final int SDK_SANDBOX_PROCESS_NOT_AVAILABLE

Proses sandbox SDK tidak tersedia.

Ini menunjukkan bahwa proses {i>sandbox<i} SDK tidak tersedia, baik karena proses {i>sandbox<i} SDK telah dihentikan, terputus atau tidak dibuat sejak awal.

Nilai Konstanta: 503 (0x000001f7)

SDK_SANDBOX_SERVICE

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public static final String SDK_SANDBOX_SERVICE

Gunakan dengan Context#getSystemService(String) untuk mengambil SdkSandboxManager untuk berinteraksi dengan SDK milik aplikasi klien ini.

Nilai Konstanta: "sdk_sandbox"

SDK_SANDBOX_STATE_DISABLED

Ditambahkan di level API 33
Juga di Ekstensi Layanan Iklan 3

public static final int SDK_SANDBOX_STATE_DISABLED

Sandbox SDK dinonaktifkan.

SdkSandboxManager API disembunyikan. Upaya untuk memanggilnya akan menghasilkan UnsupportedOperationException.

Nilai Konstanta: 0 (0x00000000)

SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION

Ditambahkan di level API 33
Juga di Ekstensi Layanan Iklan 3

public static final int SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION

Sandbox SDK diaktifkan.

Aplikasi dapat menggunakan SdkSandboxManager API untuk memuat SDKs yang menjadi dependensinya ke dalam proses sandbox SDK yang sesuai.

Nilai Konstanta: 2 (0x00000002)

Metode publik

addSdkSandboxProcessDeathCallback

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public void addSdkSandboxProcessDeathCallback (Executor callbackExecutor, 
                SdkSandboxManager.SdkSandboxProcessDeathCallback callback)

Menambahkan callback yang terdaftar untuk peristiwa siklus proses sandbox SDK, seperti sandbox SDK kematian. Jika {i>sandbox<i} belum dibuat ketika dipanggil, permintaan akan disimpan sampai {i>sandbox<i} dibuat, dan pada saat itu {i>sandbox<i} diaktifkan untuk {i>sandbox<i} tersebut. Beberapa callback bisa ditambahkan untuk mendeteksi kematian dan tidak akan dihapus ketika sandbox berhenti.

Parameter
callbackExecutor	Executor: Executor yang akan memanggil callback Nilai ini tidak boleh null. Peristiwa callback dan pemroses dikirim melalui Executor ini , yang menyediakan cara mudah untuk mengontrol thread yang digunakan. Untuk mengirim peristiwa melalui thread utama aplikasi, Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.
callback	SdkSandboxManager.SdkSandboxProcessDeathCallback: SdkSandboxProcessDeathCallback yang akan menerima sandbox SDK peristiwa siklus proses. Nilai ini tidak boleh null.

addSyncedSharedPreferencesKeys

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 5

public void addSyncedSharedPreferencesKeys (Set<String> keys)

Menambahkan kunci ke kumpulan kunci yang disinkronkan dari SharedPreferences default aplikasi ke SDK sandbox.

Data yang disinkronkan akan tersedia untuk dibaca oleh SDK menggunakan SdkSandboxController.getClientSharedPreferences() API.

Untuk berhenti menyinkronkan kunci apa pun yang telah ditambahkan menggunakan API ini, gunakan removeSyncedSharedPreferencesKeys(java.util.Set).

Sinkronisasi akan berhenti jika aplikasi dimulai ulang dan pengguna harus memanggil API ini lagi untuk membangun ulang kumpulan untuk sinkronisasi.

Catatan: Class ini tidak mendukung penggunaan pada beberapa proses.

Parameter
keys	Set: kumpulan kunci yang akan disinkronkan ke Sandbox. Nilai ini tidak boleh null.

getAppOwnedSdkSandboxInterfaces

Ditambahkan di Android UpsideDownCakePrivacySandbox

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

Mengambil daftar AppOwnedSdkSandboxInterface yang terdaftar untuk aplikasi

Hasil
List<AppOwnedSdkSandboxInterface>	daftar kosong jika callInfo tidak ditemukan di peta. Jika tidak, daftar AppOwnedSdkSandboxInterface Nilai ini tidak boleh null.

getSandboxedSdks

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 5

public List<SandboxedSdk> getSandboxedSdks ()

Mengambil informasi tentang SDK yang dimuat di sandbox.

Hasil
List<SandboxedSdk>	Daftar SandboxedSdk yang berisi semua SDK yang saat ini dimuat. Nilai ini tidak boleh null.

getSdkSandboxState

Ditambahkan di level API 33
Juga di Ekstensi Layanan Iklan 3

public static int getSdkSandboxState ()

Menampilkan status ketersediaan fitur sandbox SDK saat ini.

Hasil
int	Nilai adalah SDK_SANDBOX_STATE_DISABLED, atau SDK_SANDBOX_STATE_ENABLED_PROCESS_ISOLATION

getSyncedSharedPreferencesKeys

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 5

public Set<String> getSyncedSharedPreferencesKeys ()

Menampilkan kumpulan kunci yang sedang disinkronkan dari SharedPreferences default aplikasi ke sandbox SDK.

Hasil
Set<String>	Nilai ini tidak boleh null.

loadSdk

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

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

Memuat SDK dalam proses java sandbox SDK.

Memuat library SDK dengan sdkName ke proses sandbox SDK secara asinkron. Tujuan penelepon akan diberi tahu melalui receiver.

Pemanggil harus sudah mendeklarasikan SDKs yang menjadi dependensinya dalam manifesnya menggunakan tag <uses-sdk-library>. Pemanggil hanya dapat memuat SDKs yang bergantung pada SDK sandbox.

Saat aplikasi klien memuat SDK pertama, proses {i>sandbox<i} SDK yang baru akan dibuat. Jika sandbox sudah dibuat untuk aplikasi klien, SDK tambahan akan dimuat ke sandbox yang sama.

API ini hanya dapat dipanggil saat pemanggil berjalan di latar depan. Panggilan dari latar belakang akan menghasilkan LoadSdkException yang ditampilkan di receiver.

Parameter
sdkName	String: nama SDK yang akan dimuat. Nilai ini tidak boleh null.
params	Bundle: parameter tambahan yang akan diteruskan ke SDK dalam bentuk Bundle seperti yang disepakati antara klien dan SDK. Nilai ini tidak boleh null.
executor	Executor: Executor yang akan digunakan untuk memanggil penerima. Nilai ini tidak boleh null. Peristiwa callback dan pemroses dikirim melalui Executor ini , yang menyediakan cara mudah untuk mengontrol thread yang digunakan. Untuk mengirim peristiwa melalui thread utama aplikasi, Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.
receiver	OutcomeReceiver: Fungsi ini menerima SandboxedSdk jika berhasil dijalankan, atau LoadSdkException. Nilai ini tidak boleh null.

registerAppOwnedSdkSandboxInterfaces

Ditambahkan di Android UpsideDownCakePrivacySandbox

public void registerAppOwnedSdkSandboxInterface (AppOwnedSdkSandboxInterface appOwnedSdkSandboxInterface)

Mendaftarkan AppOwnedSdkSandboxInterface untuk proses aplikasi.

Mendaftarkan AppOwnedSdkSandboxInterface yang memiliki nama yang sama dengan nama sebelumnya antarmuka yang terdaftar akan menghasilkan IllegalStateException.

AppOwnedSdkSandboxInterface#getName() merujuk pada nama antarmuka.

Parameter
appOwnedSdkSandboxInterface	AppOwnedSdkSandboxInterface: AppOwnedSdkSandboxInterfaces yang akan didaftarkan Nilai ini tidak boleh null.

removeSdkSandboxProcessDeathCallback

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public void removeSdkSandboxProcessDeathCallback (SdkSandboxManager.SdkSandboxProcessDeathCallback callback)

Menghapus SdkSandboxProcessDeathCallback yang sebelumnya ditambahkan menggunakan addSdkSandboxProcessDeathCallback(java.util.concurrent.Executor, android.app.sdksandbox.SdkSandboxManager.SdkSandboxProcessDeathCallback)

Parameter
callback	SdkSandboxManager.SdkSandboxProcessDeathCallback: SdkSandboxProcessDeathCallback yang sebelumnya ditambahkan menggunakan SdkSandboxManager#addSdkSandboxProcessDeathCallback(Executor, SdkSandboxProcessDeathCallback) Nilai ini tidak boleh null.

removeSyncedSharedPreferencesKeys

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 5

public void removeSyncedSharedPreferencesKeys (Set<String> keys)

Menghapus kunci dari kumpulan kunci yang telah ditambahkan menggunakan addSyncedSharedPreferencesKeys(java.util.Set)

Kunci yang dihapus akan dihapus dari sandbox SDK jika sudah disinkronkan.

Parameter
keys	Set: kumpulan nama kunci yang seharusnya tidak lagi disinkronkan ke Sandbox. Nilai ini tidak boleh null.

requestSurfacePackage

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public void requestSurfacePackage (String sdkName, 
                Bundle params, 
                Executor callbackExecutor, 
                OutcomeReceiver<Bundle, RequestSurfacePackageException> receiver)

Mengirim permintaan untuk paket platform ke SDK.

Setelah aplikasi klien menerima sinyal tentang pemuatan SDK yang berhasil, dan memiliki menambahkan SurfaceView ke hierarki tampilan, elemen ini dapat meminta secara asinkron SurfacePackage untuk merender tampilan dari SDK.

Saat SurfacePackage sudah siap, callback OutcomeReceiver#onResult dari receiver yang diteruskan akan dipanggil. Callback ini akan berisi Bundle , yang akan berisi kunci SdkSandboxManager#EXTRA_SURFACE_PACKAGE yang nilai yang terkait adalah SurfacePackage yang diminta.

params yang diteruskan harus berisi kunci berikut: EXTRA_WIDTH_IN_PIXELS, SdkSandboxManager#EXTRA_HEIGHT_IN_PIXELS, SdkSandboxManager#EXTRA_DISPLAY_ID dan SdkSandboxManager#EXTRA_HOST_TOKEN. Jika salah satu kunci ini hilang atau tidak valid, IllegalArgumentException akan ditampilkan.

API ini hanya dapat dipanggil saat pemanggil berjalan di latar depan. Panggilan dari latar belakang akan menyebabkan RequestSurfacePackageException di receiver.

Parameter
sdkName	String: nama SDK yang dimuat ke dalam sandbox SDK. Nilai ini tidak boleh null.
params	Bundle: parameter yang diteruskan aplikasi klien ke SDK. Nilai ini tidak boleh null.
callbackExecutor	Executor: Executor yang akan memanggil callback Nilai ini tidak boleh null. Peristiwa callback dan pemroses dikirim melalui Executor ini , yang menyediakan cara mudah untuk mengontrol thread yang digunakan. Untuk mengirim peristiwa melalui thread utama aplikasi, Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.
receiver	OutcomeReceiver: Metode ini akan menampilkan Bundle saat berhasil yang akan berisi kunci SdkSandboxManager#EXTRA_SURFACE_PACKAGE dengan nilai SurfacePackage, atau RequestSurfacePackageException jika gagal. Nilai ini tidak boleh null.

Menampilkan
IllegalArgumentException	jika params tidak berisi semua kunci yang diperlukan.

Lihat juga:

• EXTRA_WIDTH_IN_PIXELS
• EXTRA_HEIGHT_IN_PIXELS
• EXTRA_DISPLAY_ID
• EXTRA_HOST_TOKEN

startSdkSandboxActivity

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 7

public void startSdkSandboxActivity (Activity fromActivity, 
                IBinder sdkActivityToken)

Memulai Activity di sandbox SDK.

Fungsi ini akan memulai Activity baru dalam tugas yang sama dari fromActivity yang diteruskan dan meneruskannya ke SDK yang membagikan sdkActivityToken yang diteruskan yang mengidentifikasi permintaan dari SDK tersebut untuk menetapkan Activity ini.

Activity tidak akan dimulai dalam kasus berikut:

• Aplikasi yang memanggil API ini berada di latar belakang.
• sdkActivityToken yang diteruskan tidak dipetakan ke permintaan untuk Activity dari SDK yang membagikannya ke aplikasi pemanggil.
• SDK yang membagikan sdkActivityToken yang telah diteruskan menghapus permintaannya untuk teks ini Activity.
• Sandbox Activity sudah dibuat.

Parameter
fromActivity	Activity: Activity akan digunakan untuk memulai sandbox baru Activity dengan memanggil Activity#startActivity(Intent). Nilai ini tidak boleh null.
sdkActivityToken	IBinder: ID yang dibagikan oleh SDK yang meminta Activity. Nilai ini tidak boleh null.

unloadSdk

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

public void unloadSdk (String sdkName)

Menghapus muatan SDK yang sebelumnya telah dimuat oleh pemanggil.

Tidak ada jaminan bahwa memori yang dialokasikan untuk SDK ini akan segera dikosongkan. Semua panggilan berikutnya ke requestSurfacePackage(java.lang.String, android.os.Bundle, java.util.concurrent.Executor, android.os.OutcomeReceiver) untuk sdkName yang diberikan akan gagal.

API ini hanya dapat dipanggil saat pemanggil berjalan di latar depan. Panggilan dari latar belakang akan menyebabkan SecurityException ditampilkan.

Parameter
sdkName	String: nama SDK yang akan dihapus muatannya. Nilai ini tidak boleh null.

membatalkan pendaftaranAppOwnedSdkSandboxInterfaces

Ditambahkan di Android UpsideDownCakePrivacySandbox

public void unregisterAppOwnedSdkSandboxInterface (String name)

Membatalkan pendaftaran ERROR(/AppOwnedSdkSandboxInterfaces) untuk proses aplikasi.

Parameter
name	String: nama yang digunakan untuk mendaftarkan AppOwnedSdkSandboxInterfaces. Nilai ini tidak boleh null.