SdkSandboxController

public class SdkSandboxController
extends Object

java.lang.Object
   ↳ android.app.sdksandbox.sdkprovider.SdkSandboxController

Pengontrol yang digunakan oleh SDK yang dimuat di sandbox untuk mengakses informasi yang diberikan oleh sdk sandbox.

Hal ini memungkinkan SDK untuk berkomunikasi dengan SDK lain di sandbox SDK dan mengetahui statusnya SDK yang saat ini dimuat di dalamnya.

Instance SdkSandboxController dapat diperoleh menggunakan Context.getSystemService(Class) dan class. Context kemudian dapat diperoleh menggunakan SandboxedSdkProvider.getContext().

Ringkasan

Konstanta

String SDK_SANDBOX_CONTROLLER_SERVICE

Metode publik

List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces()

Mengambil semua AppOwnedSdkSandboxInterface yang didaftarkan oleh aplikasi.

String getClientPackageName()

Menampilkan nama paket aplikasi klien.

SharedPreferences getClientSharedPreferences()

Menampilkan SharedPreferences berisi data yang disinkronkan dari aplikasi klien.

List<SandboxedSdk> getSandboxedSdks()

Mengambil informasi tentang Sdk yang dimuat di sandbox.

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

Memuat SDK dalam proses java sandbox SDK.

IBinder registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

Menampilkan ID untuk SdkSandboxActivityHandler setelah mendaftarkannya.

void unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)

Membatalkan pendaftaran SdkSandboxActivityHandler yang sudah terdaftar.

Metode turunan

Konstanta

SDK_SANDBOX_CONTROLLER_SERVICE

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 5 
public static final String SDK_SANDBOX_CONTROLLER_SERVICE

Nilai Konstanta: "sdk_sandbox_controller_service"

Metode publik

getAppOwnedSdkSandboxInterfaces

public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()

Mengambil semua AppOwnedSdkSandboxInterface yang didaftarkan oleh aplikasi.

Hasil
List<AppOwnedSdkSandboxInterface> Daftar AppOwnedSdkSandboxInterface yang berisi semua yang saat ini terdaftar AppOwnedSdkSandboxInterfaces. Nilai ini tidak boleh null.
Menampilkan
UnsupportedOperationException jika {i>controller<i} diperoleh dari konteks tambahan. Gunakan SandboxedSdkProvider#getContext() untuk konteks yang tepat

getClientPackageName

public String getClientPackageName ()

Menampilkan nama paket aplikasi klien.

Hasil
String Nilai ini tidak boleh null.
Menampilkan
UnsupportedOperationException jika {i>controller<i} diperoleh dari konteks tambahan. Gunakan SandboxedSdkProvider#getContext() untuk konteks yang tepat.

getClientSharedPreferences

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 5 
public SharedPreferences getClientSharedPreferences ()

Menampilkan SharedPreferences berisi data yang disinkronkan dari aplikasi klien.

Kunci yang telah disinkronkan oleh aplikasi klien menggunakan SdkSandboxManager.addSyncedSharedPreferencesKeys(Set) dapat ditemukan di SharedPreferences ini.

SharedPreferences yang ditampilkan hanya boleh dibaca. Menulis ke sana bukanlah didukung.

Hasil
SharedPreferences SharedPreferences berisi data yang disinkronkan dari aplikasi klien. Nilai ini tidak boleh null.
Menampilkan
UnsupportedOperationException jika {i>controller<i} diperoleh dari konteks tambahan. Gunakan SandboxedSdkProvider#getContext() untuk konteks yang tepat

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.
Menampilkan
UnsupportedOperationException jika {i>controller<i} diperoleh dari konteks tambahan. Gunakan SandboxedSdkProvider#getContext() untuk konteks yang tepat

loadSdk

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 hanya dapat memuat SDKs yang diandalkan aplikasi klien ke dalam sandbox SDK.

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.
Menampilkan
UnsupportedOperationException jika {i>controller<i} diperoleh dari konteks tambahan. Gunakan SandboxedSdkProvider#getContext() untuk konteks yang tepat

registerSdkSandboxActivityHandler

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 7 
public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Menampilkan ID untuk SdkSandboxActivityHandler setelah mendaftarkannya.

Fungsi ini mendaftarkan implementasi SdkSandboxActivityHandler yang dibuat oleh SDK dan menampilkan IBinder yang secara unik mengidentifikasi objek SdkSandboxActivityHandler yang diteruskan.

Jika SdkSandboxActivityHandler yang sama didaftarkan beberapa kali tanpa membatalkan pendaftaran, token IBinder yang sama akan ditampilkan.

Parameter
sdkSandboxActivityHandler SdkSandboxActivityHandler: adalah SdkSandboxActivityHandler yang akan didaftarkan. Nilai ini tidak boleh null.
Hasil
IBinder IBinder secara unik mengidentifikasi SdkSandboxActivityHandler yang diteruskan. Nilai ini tidak boleh null.

unregisterSdkSandboxActivityHandler

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 7 
public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)

Membatalkan pendaftaran SdkSandboxActivityHandler yang sudah terdaftar.

Jika SdkSandboxActivityHandler yang diteruskan terdaftar, pendaftaran tersebut akan dibatalkan. Jika tidak, CPU tidak akan melakukan apa pun.

Setelah membatalkan pendaftaran, SDK dapat mendaftarkan objek pengendali yang sama lagi atau membuat yang baru di jika ingin Activity baru.

Jika token IBinder dari pengendali yang tidak terdaftar digunakan untuk memulai Activity, Activity akan gagal dimulai.

Parameter
sdkSandboxActivityHandler SdkSandboxActivityHandler: adalah SdkSandboxActivityHandler yang akan dibatalkan pendaftarannya. Nilai ini tidak boleh null.
Hasil
void Nilai ini tidak boleh null.