OnDevicePersonalizationManager

public class OnDevicePersonalizationManager
extends Object

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

OnDevicePersonalizationManager menyediakan API bagi aplikasi untuk memuat IsolatedService dalam proses terpisah dan berinteraksi dengannya. Aplikasi dapat meminta IsolatedService untuk membuat 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 dengan Federated Learning untuk pelatihan model. 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

jalankan

Ditambahkan di Android UpsideDownCakePrivacySandbox

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

Menjalankan IsolatedService di sandbox OnDevicePersonalization. Tujuan platform mengikat ke IsolatedService yang ditentukan dalam proses yang terisolasi dan memanggil IsolatedWorker#onExecute(ExecuteInput, java.util.function.Consumer) dengan parameter yang disediakan pemanggil. Saat IsolatedService selesai dieksekusi, platform menampilkan token yang mengacu pada hasil layanan ke pemanggil. Token ini selanjutnya 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, sediakan `Executor` yang melakukan pengiriman ke thread yang sesuai.
`receiver`	`OutcomeReceiver`: Metode ini menampilkan daftar objek `SurfacePackageToken`, yang masing-masing adalah referensi buram ke `RenderingConfig` yang ditampilkan oleh `IsolatedService`, atau `Exception` jika gagal. URL yang dikembalikan Objek `SurfacePackageToken` dapat digunakan dalam Panggilan `requestSurfacePackage(android.adservices.ondevicepersonalization.SurfacePackageToken, android.os.IBinder, int, int, int, java.util.concurrent.Executor, android.os.OutcomeReceiver)` untuk menampilkan hasil dalam tampilan. Aplikasi panggilan dan `IsolatedService` harus menyetujui ukuran yang diharapkan dari daftar ini. Entri dalam daftar objek `SurfacePackageToken` yang ditampilkan mungkin bernilai null untuk menunjukkan bahwa layanan tidak memiliki output untuk platform spesifik tersebut. Jika terjadi error, penerima akan menampilkan salah satu pengecualian berikut: Menampilkan `PackageManager.NameNotFoundException` jika pengendali paket 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) berlari dalam sandbox OnDevicePersonalization.

Parameter
`surfacePackageToken`	`SurfacePackageToken`: referensi ke `SurfacePackageToken` yang ditampilkan oleh referensi sebelumnya panggilan ke `#execute(ComponentName, PersistableBundle, Executor, OutcomeReceiver)`. Nilai ini tidak boleh `null`.
`surfaceViewHostToken`	`IBinder`: hostToken `SurfaceView`, yang merupakan ditampilkan oleh `SurfaceView.getHostToken()` setelah `SurfaceView` telah ditambahkan ke hierarki tampilan. Nilai ini tidak boleh `null`.
`displayId`	`int`: ID bilangan bulat tampilan logis untuk menampilkan `SurfaceControlViewHost.SurfacePackage`, 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, sediakan `Executor` yang melakukan pengiriman ke thread yang sesuai.
`receiver`	`OutcomeReceiver`: Tindakan ini akan menampilkan `SurfaceControlViewHost.SurfacePackage` saat berhasil, atau `Exception` jika gagal. Jenis pengecualiannya adalah `OnDevicePersonalizationException` jika eksekusi pengendali gagal. Nilai ini tidak boleh `null`.