İzole edilmiş çalışan

public interface IsolatedWorker

android.adservices.ondevicepersonalization.IsolatedWorker

İşletim sisteminden IsolatedService öğesine gelen isteklerin ele alınması için uygulanması gereken yöntemlerle arayüz sağlar. IsolatedService, her istek için bir IsolatedWorker örneği oluşturur ve isteğin türüne bağlı olarak aşağıdaki yöntemlerden birini çağırır. IsolatedService, bir Bağlayıcı iş parçacığındaki yöntemi çağırır ve IsolatedWorker, uzun süren işlemleri bir çalışan iş parçacığına boşaltmalıdır. Sonuçları döndürmek için her yöntemin tüketici parametresi kullanılır.

Özet

Herkese açık yöntemler

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

Tamamlanmış bir indirme işlemini işlemesi.

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

onRender(android.adservices.ondevicepersonalization.RenderInput, java.util.function.Consumer) tarafından döndürülen HTML çıkışına yerleştirilmiş, platform tarafından sağlanan bir izleme URL'sine (EventUrlProvider) yapılan istek tarafından tetiklenen bir etkinliği işler.

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

Bir uygulamadan gelen isteği ele alır.

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

onExecute(android.adservices.ondevicepersonalization.ExecuteInput, java.util.function.Consumer) işlevinin sonucu olarak döndürülen sonuçlar için HTML oluşturur.

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

Birleşik hesaplama işi için kullanılan tek bir eğitim örneği oluşturun.

Herkese açık yöntemler

İndirme Tamamlandı

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

Tamamlanmış bir indirme işlemini işlemesi. Platform, IsolatedService paket manifestinde tanımlanan parametreleri kullanarak içerik indirir, indirme işlemi tamamlandıktan sonra bu işlevi çağırır ve bu yöntemin sonucuyla IsolatedService#getRemoteData(RequestToken) öğesinden REMOTE_DATA tablosunu günceller.

Parametreler
input DownloadCompletedInput: İşleyici parametrelerini indir. Bu değer null olamaz.
consumer Consumer: Sonucu alan geri arama. Hata durumunda null ile çağrılmalıdır. null ile çağrılırsa REMOTE_DATA tablosunda herhangi bir güncelleme yapılmaz.

Bu yöntem bir RuntimeException hatası verirse REMOTE_DATA tablosunda herhangi bir güncelleme yapılmaz.

onEvent

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

onRender(android.adservices.ondevicepersonalization.RenderInput, java.util.function.Consumer) tarafından döndürülen HTML çıkışına yerleştirilmiş, platform tarafından sağlanan bir izleme URL'sine (EventUrlProvider) yapılan istek tarafından tetiklenen bir etkinliği işler. Platform, EVENTS tablosunu EventOutput#getEventLogRecord() ile günceller.

Parametreler
input EventInput: Etkinlik verilerini hesaplamak için gereken parametreler. Bu değer null olamaz.
consumer Consumer: Sonucu alan geri arama. Hata durumunda null ile çağrılmalıdır. null ile çağrılırsa EVENTS tablosuna veri yazılmaz.

Bu yöntem bir RuntimeException döndürürse EVENTS tablosuna veri yazılmaz.

onYürüt

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

Bir uygulamadan gelen isteği işler. Bu yöntem, bir uygulama, IsolatedService adına referansta bulunan OnDevicePersonalizationManager#execute(ComponentName, PersistableBundle, java.util.concurrent.Executor, OutcomeReceiver) yöntemini çağırdığında çağrılır.

Parametreler
input ExecuteInput: Çağrı uygulamasından İstek Parametreleri. Bu değer null olamaz.
consumer Consumer: ExecuteOutput sonucunu alan geri arama. Hata vererek null ile çağrılmalıdır. Hata, çağrı yapan uygulamaya OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED hata koduna sahip bir OnDevicePersonalizationException olarak iletilir. Gizli verilerin arama uygulamasına sızdırılmasını önlemek için daha ayrıntılı hata raporları kullanılamaz. IsolatedService cihazının, hata istatistiklerini arka ucuna bildirmesi gerekiyorsa günlük kaydı için ExecuteOutput hata verilerini hata verileriyle doldurmalı ve hata raporlarını toplamak için Federated Analytics'i kullanmalıdır.

Bu yöntem bir RuntimeException atarsa bu, uygulamaların OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED hata koduna sahip OnDevicePersonalizationException olarak çağrılmasına da bildirilir.

onOluştur

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

onExecute(android.adservices.ondevicepersonalization.ExecuteInput, java.util.function.Consumer) işlevinin sonucu olarak döndürülen sonuçlar için HTML oluşturur. Bir istemci uygulaması OnDevicePersonalizationManager#requestSurfacePackage(SurfacePackageToken, IBinder, int, int, int, java.util.concurrent.Executor, OutcomeReceiver) araması yaptığında çağrılır. Platform, bu HTML'yi sınırlı bir çerçeve içinde WebView içinde oluşturacaktır.

Parametreler
input RenderInput: Oluşturma isteği için parametreler. Bu değer null olamaz.
consumer Consumer: Sonucu alan geri arama. Hata durumunda null ile çağrılmalıdır. Hata, çağrı yapan uygulamaya OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED hata koduna sahip bir OnDevicePersonalizationException olarak iletilir.

Bu yöntem bir RuntimeException atarsa bu, uygulamaların OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED hata koduna sahip OnDevicePersonalizationException olarak çağrılmasına da bildirilir.

onEğitimÖrneği

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

Birleşik hesaplama işi için kullanılan tek bir eğitim örneği oluşturun.

Parametreler
input TrainingExampleInput: Eğitim örneğini oluşturmak için gereken parametreler. Bu değer null olamaz.
consumer Consumer: Tamamlandığında çağrılacak geri arama. Bu değer null olamaz.