Pekerja Terisolasi

public interface IsolatedWorker

android.adservices.ondevicepersonalization.IsolatedWorker

Antarmuka dengan metode yang perlu diimplementasikan untuk menangani permintaan dari OS ke IsolatedService. IsolatedService membuat instance IsolatedWorker pada setiap permintaan dan memanggil salah satu metode di bawah ini, bergantung pada jenis permintaannya. IsolatedService memanggil metode di thread Binder dan IsolatedWorker harus mengalihkan operasi yang berjalan lama ke thread pekerja. Parameter konsumen dari setiap metode digunakan untuk menampilkan hasil.

Ringkasan

Metode publik

default void onDownloadCompleted(DownloadCompletedInput input, Consumer<DownloadCompletedOutput> consumer)

Menangani download yang telah selesai.

default void onEvent(EventInput input, Consumer<EventOutput> consumer)

Menangani peristiwa yang dipicu oleh permintaan ke URL pelacakan yang disediakan platform EventUrlProvider yang disematkan dalam output HTML yang ditampilkan oleh onRender(android.adservices.ondevicepersonalization.RenderInput, java.util.function.Consumer).

default void onExecute(ExecuteInput input, Consumer<ExecuteOutput> consumer)

Menangani permintaan dari aplikasi.

default void onRender(RenderInput input, Consumer<RenderOutput> consumer)

Menghasilkan HTML untuk hasil yang ditampilkan sebagai hasil dari onExecute(android.adservices.ondevicepersonalization.ExecuteInput, java.util.function.Consumer).

default void onTrainingExample(TrainingExampleInput input, Consumer<TrainingExampleOutput> consumer)

Membuat satu contoh pelatihan yang digunakan untuk tugas komputasi gabungan.

Metode publik

onDownloadSelesai

public void onDownloadCompleted (DownloadCompletedInput input, 
                Consumer<DownloadCompletedOutput> consumer)

Menangani download yang telah selesai. Platform mendownload konten menggunakan parameter yang ditentukan dalam manifes paket IsolatedService, memanggil fungsi ini setelah download selesai, dan memperbarui tabel REMOTE_DATA dari IsolatedService#getRemoteData(RequestToken) dengan hasil metode ini.

Parameter
input DownloadCompletedInput: Mendownload parameter pengendali. Nilai ini tidak boleh null.
consumer Consumer: Callback yang menerima hasil. Harus dipanggil dengan null saat terjadi error. Jika dipanggil dengan null, tidak ada pembaruan yang dilakukan pada tabel REMOTE_DATA.

Jika metode ini menampilkan RuntimeException, tidak ada pembaruan yang dilakukan pada tabel REMOTE_DATA.

saat Acara

public void onEvent (EventInput input, 
                Consumer<EventOutput> consumer)

Menangani peristiwa yang dipicu oleh permintaan ke URL pelacakan yang disediakan platform EventUrlProvider yang disematkan dalam output HTML yang ditampilkan oleh onRender(android.adservices.ondevicepersonalization.RenderInput, java.util.function.Consumer). Platform ini memperbarui tabel EVENTS dengan EventOutput#getEventLogRecord().

Parameter
input EventInput: Parameter yang diperlukan untuk menghitung data peristiwa. Nilai ini tidak boleh null.
consumer Consumer: Callback yang menerima hasil. Harus dipanggil dengan null saat terjadi error. Jika dipanggil dengan null, tidak ada data yang ditulis ke tabel EVENTS.

Jika metode ini menampilkan RuntimeException, tidak ada data yang akan ditulis ke tabel PERISTIWA.

onExecute

public void onExecute (ExecuteInput input, 
                Consumer<ExecuteOutput> consumer)

Menangani permintaan dari aplikasi. Metode ini dipanggil saat aplikasi memanggil OnDevicePersonalizationManager#execute(ComponentName, PersistableBundle, java.util.concurrent.Executor, OutcomeReceiver) yang mengacu ke IsolatedService bernama.

Parameter
input ExecuteInput: Parameter Permintaan dari aplikasi pemanggil. Nilai ini tidak boleh null.
consumer Consumer: Callback yang menerima hasil ExecuteOutput. Harus dipanggil dengan null saat terjadi error. Error disebarkan ke aplikasi panggilan sebagai OnDevicePersonalizationException dengan kode error OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED. Untuk menghindari kebocoran data pribadi ke aplikasi panggilan, pelaporan error yang lebih mendetail tidak tersedia. Jika IsolatedService perlu melaporkan statistik error ke backend-nya, ExecuteOutput harus diisi dengan data error untuk logging, dan mengandalkan Federated Analytics untuk menggabungkan laporan error.

Jika metode ini menampilkan RuntimeException, hal itu juga dilaporkan ke memanggil aplikasi sebagai OnDevicePersonalizationException dengan kode error OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED.

Render

public void onRender (RenderInput input, 
                Consumer<RenderOutput> consumer)

Menghasilkan HTML untuk hasil yang ditampilkan sebagai hasil dari onExecute(android.adservices.ondevicepersonalization.ExecuteInput, java.util.function.Consumer). Dipanggil saat aplikasi klien memanggil OnDevicePersonalizationManager#requestSurfacePackage(SurfacePackageToken, IBinder, int, int, int, java.util.concurrent.Executor, OutcomeReceiver). Platform akan merender HTML ini dalam WebView di dalam frame dengan fence.

Parameter
input RenderInput: Parameter untuk permintaan render. Nilai ini tidak boleh null.
consumer Consumer: Callback yang menerima hasil. Harus dipanggil dengan null saat terjadi error. Error disebarkan ke aplikasi panggilan sebagai OnDevicePersonalizationException dengan kode error OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED.

Jika metode ini menampilkan RuntimeException, hal itu juga dilaporkan untuk memanggil aplikasi sebagai OnDevicePersonalizationException dengan kode error OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED.

onTrainingExample

public void onTrainingExample (TrainingExampleInput input, 
                Consumer<TrainingExampleOutput> consumer)

Membuat satu contoh pelatihan yang digunakan untuk tugas komputasi gabungan.

Parameter
input TrainingExampleInput: Parameter yang diperlukan untuk membuat contoh pelatihan. Nilai ini tidak boleh null.
consumer Consumer: Callback yang akan dipanggil saat proses selesai. Nilai ini tidak boleh null.