OnDevicePersonalizationManager

public class OnDevicePersonalizationManager
extends Object

java.lang.Object
↳	android.adservices.ondevicepersonalization.OnDevicePersonalizationManager

OnDevicePersonalizationManager menyediakan API bagi aplikasi untuk memuat IsolatedService dalam proses terisolasi dan berinteraksi dengannya. Aplikasi dapat meminta IsolatedService agar menghasilkan konten untuk ditampilkan dalam SurfaceView dalam hierarki tampilan aplikasi, dan juga menulis hasil persisten ke penyimpanan di perangkat yang dapat digunakan oleh Federated Analytics untuk analisis statistik lintas perangkat atau oleh Federated Learning untuk pelatihan model. Konten yang ditampilkan dan output persisten tidak dapat diakses secara langsung oleh aplikasi panggilan.

Ringkasan

Metode publik
`void`	`execute(ComponentName handler, PersistableBundle params, Executor executor, OutcomeReceiver<List<SurfacePackageToken>, Exception> receiver)` Menjalankan `IsolatedService` di sandbox OnDevicePersonalization.
`void`	`requestSurfacePackage(SurfacePackageToken surfacePackageToken, IBinder surfaceViewHostToken, int displayId, int width, int height, Executor executor, OutcomeReceiver<SurfaceControlViewHost.SurfacePackage, Exception> receiver)` Meminta `SurfaceControlViewHost.SurfacePackage` untuk disisipkan ke dalam `SurfaceView` di dalam aplikasi panggilan.

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.

Metode publik

execute

Ditambahkan di Android UpsideDownCakePrivacySandbox

public void execute (ComponentName handler, 
                PersistableBundle params, 
                Executor executor, 
                OutcomeReceiver<List<SurfacePackageToken>, Exception> receiver)

Menjalankan IsolatedService di sandbox OnDevicePersonalization. Platform terikat ke IsolatedService yang ditentukan dalam proses terisolasi dan memanggil IsolatedWorker#onExecute(ExecuteInput, java.util.function.Consumer) dengan parameter yang disediakan pemanggil. Saat IsolatedService selesai dieksekusi, platform akan menampilkan token yang merujuk ke hasil dari layanan ke pemanggil. Token ini kemudian dapat digunakan untuk menampilkan hasil dalam SurfaceView dalam aplikasi panggilan.

Parameter
`handler`	`ComponentName`: `ComponentName` dari `IsolatedService`. Nilai ini tidak boleh `null`.
`params`	`PersistableBundle`: `PersistableBundle` yang diteruskan dari aplikasi panggilan ke `IsolatedService`. Konten yang diharapkan dari parameter ini ditentukan oleh `IsolatedService`. Platform tidak menafsirkan parameter ini. Nilai ini tidak boleh `null`.
`executor`	`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, berikan `Executor` yang dikirim ke thread yang sesuai.
`receiver`	`OutcomeReceiver`: Tindakan ini akan menampilkan daftar objek `SurfacePackageToken`, yang masing-masing merupakan referensi buram ke `RenderingConfig` yang ditampilkan oleh `IsolatedService`, atau `Exception` jika gagal. Objek `SurfacePackageToken` yang ditampilkan dapat digunakan dalam panggilan `requestSurfacePackage(android.adservices.ondevicepersonalization.SurfacePackageToken, android.os.IBinder, int, int, int, java.util.concurrent.Executor, android.os.OutcomeReceiver)` berikutnya untuk menampilkan hasilnya dalam tampilan. Aplikasi panggilan dan `IsolatedService` harus menyetujui ukuran daftar ini yang diharapkan. Entri dalam daftar objek `SurfacePackageToken` yang ditampilkan mungkin null untuk menunjukkan bahwa layanan tidak memiliki output untuk platform tertentu tersebut. Jika terjadi error, penerima akan menampilkan salah satu pengecualian berikut: Menampilkan `PackageManager.NameNotFoundException` jika paket pengendali tidak diinstal atau tidak memiliki manifes ODP yang valid. Menampilkan `ClassNotFoundException` jika class pengendali tidak ditemukan. Menampilkan `OnDevicePersonalizationException` jika eksekusi pengendali gagal.

requestSurfacePackage

Ditambahkan di Android UpsideDownCakePrivacySandbox

public void requestSurfacePackage (SurfacePackageToken surfacePackageToken, 
                IBinder surfaceViewHostToken, 
                int displayId, 
                int width, 
                int height, 
                Executor executor, 
                OutcomeReceiver<SurfaceControlViewHost.SurfacePackage, Exception> receiver)

Meminta SurfaceControlViewHost.SurfacePackage untuk disisipkan ke dalam SurfaceView di dalam aplikasi panggilan. Paket platform akan berisi View dengan konten dari hasil panggilan sebelumnya ke #execute(ComponentName, PersistableBundle, Executor, OutcomeReceiver) yang berjalan di sandbox OnDevicePersonalization.

Parameter
`surfacePackageToken`	`SurfacePackageToken`: referensi ke `SurfacePackageToken` yang ditampilkan oleh panggilan sebelumnya ke `#execute(ComponentName, PersistableBundle, Executor, OutcomeReceiver)`. Nilai ini tidak boleh `null`.
`surfaceViewHostToken`	`IBinder`: hostToken `SurfaceView`, yang ditampilkan oleh `SurfaceView.getHostToken()` setelah `SurfaceView` ditambahkan ke hierarki tampilan. Nilai ini tidak boleh `null`.
`displayId`	`int`: ID bilangan bulat dari tampilan logis tempat menampilkan `SurfaceControlViewHost.SurfacePackage`, yang ditampilkan oleh `Context.getDisplay().getDisplayId()`.
`width`	`int`: lebar `SurfaceControlViewHost.SurfacePackage` dalam piksel.
`height`	`int`: tinggi `SurfaceControlViewHost.SurfacePackage` dalam piksel.
`executor`	`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, berikan `Executor` yang dikirim ke thread yang sesuai.
`receiver`	`OutcomeReceiver`: Metode ini akan menampilkan `SurfaceControlViewHost.SurfacePackage` jika berhasil, atau `Exception` jika gagal. Jenis pengecualian adalah `OnDevicePersonalizationException` jika eksekusi pengendali gagal. Nilai ini tidak boleh `null`.