Usługa izolowana

public abstract class IsolatedService
extends Service

java.lang.Object
android.content.Context
  android.content.ContextWrapper
    android.app.Service
      android.adservices.ondevicepersonalization.IsolatedService


Klasa podstawowa dla usług uruchamianych przez ODP podczas wywołania OnDevicePersonalizationManager#execute(ComponentName, PersistableBundle, java.util.concurrent.Executor, OutcomeReceiver) które działają osobno . Usługa może tworzyć treści do wyświetlania SurfaceView w aplikacji do połączeń i zapisuj trwałe wyniki na urządzeniu które może wykorzystać Federated Analytics do analizy statystyk na różnych urządzeniach lub sfederowane uczenie się do trenowania modeli. Aplikacje klienckie używają OnDevicePersonalizationManager do interakcji z IsolatedService.

Podsumowanie

Stałe odziedziczone

Konstruktory publiczne

IsolatedService()

Metody publiczne

final EventUrlProvider getEventUrlProvider(RequestToken requestToken)

Zwraca EventUrlProvider dla bieżącego żądania.

final FederatedComputeScheduler getFederatedComputeScheduler(RequestToken requestToken)

Zwraca FederatedComputeScheduler dla bieżącego żądania.

final MutableKeyValueStore getLocalData(RequestToken requestToken)

Zwraca obiekt dostępu do danych dla tabeli LOCAL_DATA.

final LogReader getLogReader(RequestToken requestToken)

Zwraca DAO dla tabel REQUESTS i EVENTS, które zawierają dostęp do wierszy, które są odczytywane przez usługę IsolatedService.

final KeyValueStore getRemoteData(RequestToken requestToken)

Zwraca obiekt dostępu do danych dla tabeli REMOTE_DATA.

final UserData getUserData(RequestToken requestToken)

Zwraca UserData udostępniony przez platformę dla bieżącego żądania.

IBinder onBind(Intent intent)

Obsługuje powiązanie z zasobem IsolatedService.

void onCreate()

Tworzy powiązanie dla obiektu IsolatedService.

abstract IsolatedWorker onRequest(RequestToken requestToken)

Zwraca instancję instancji IsolatedWorker, która obsługuje żądania klientów.

Metody dziedziczone

Konstruktory publiczne

Usługa izolowana

public IsolatedService ()

Metody publiczne

getEventUrlProvider,

public final EventUrlProvider getEventUrlProvider (RequestToken requestToken)

Zwraca EventUrlProvider dla bieżącego żądania. EventUrlProvider udostępnia adresy URL, które można umieścić w kodzie HTML. Podczas renderowania kodu HTML w WebView, platforma przechwytuje żądania wysyłane do tych adresów URL i wywołuje IsolatedWorker#onEvent(EventInput, Consumer)

Parametry
requestToken RequestToken: nieprzejrzysty token identyfikujący bieżące żądanie skierowane do usługi. Ta wartość nie może być typu null.

Zwroty
EventUrlProvider EventUrlProvider, który zwraca linki monitorujące zdarzenia. Ta wartość nie może być typu null.

getFederatedComputeScheduler

public final FederatedComputeScheduler getFederatedComputeScheduler (RequestToken requestToken)

Zwraca FederatedComputeScheduler dla bieżącego żądania. Za pomocą FederatedComputeScheduler można planować i anulować sfederowane zadania obliczeniowe. Sfederowane obliczenia obliczeniowe obejmują sfederowane uczenie się i zadania analizy sfederowanej.

Parametry
requestToken RequestToken: nieprzejrzysty token identyfikujący bieżące żądanie skierowane do usługi. Ta wartość nie może być typu null.

Zwroty
FederatedComputeScheduler FederatedComputeScheduler, który zwraca sfederowane zadanie obliczeniowe algorytm szeregowania. Ta wartość nie może być typu null.

getLocalData

public final MutableKeyValueStore getLocalData (RequestToken requestToken)

Zwraca obiekt dostępu do danych dla tabeli LOCAL_DATA. Tabela LOCAL_DATA jest obiektem trwałym klucz-wartość, w której usługa może przechowywać dowolne dane. Zawartość tej tabeli to widoczne tylko dla usługi uruchomionej w izolowanym procesie i nie można jej wysłać poza urządzenia.

Parametry
requestToken RequestToken: nieprzejrzysty token identyfikujący bieżące żądanie skierowane do usługi. Ta wartość nie może być typu null.

Zwroty
MutableKeyValueStore Obiekt MutableKeyValueStore, który zapewnia dostęp do tabeli LOCAL_DATA. Metody w zwróconym obiekcie MutableKeyValueStore blokują operacje i powinna być wywoływana z wątku instancji roboczej, a nie z wątku głównego ani wątku powiązania. Ta wartość nie może być typu null.

getLogReader

public final LogReader getLogReader (RequestToken requestToken)

Zwraca DAO dla tabel REQUESTS i EVENTS, które zawierają dostęp do wierszy, które są odczytywane przez usługę IsolatedService.

Parametry
requestToken RequestToken: nieprzejrzysty token identyfikujący bieżące żądanie skierowane do usługi. Ta wartość nie może być typu null.

Zwroty
LogReader Obiekt LogReader, który zapewnia dostęp do tabeli ŻĄDANIA i ZDARZENIA. Metody w zwróconym obiekcie LogReader blokują operacje i powinna być wywoływana z wątku instancji roboczej, a nie z wątku głównego ani wątku powiązania. Ta wartość nie może być typu null.

getRemoteData

public final KeyValueStore getRemoteData (RequestToken requestToken)

Zwraca obiekt dostępu do danych dla tabeli REMOTE_DATA. Tabela REMOTE_DATA jest tylko do odczytu magazyn par klucz-wartość zawierający dane, które są okresowo pobierane z zadeklarowanego punktu końcowego w tagu w pliku manifestu ODP usługi, jak pokazano w poniższym przykładzie.

<!-- Contents of res/xml/OdpSettings.xml -->
 <on-device-personalization>
 <!-- Name of the service subclass -->
 <service "com.example.odpsample.SampleService">
   <!-- If this tag is present, ODP will periodically poll this URL and
    download content to populate REMOTE_DATA. Adopters that do not need to
    download content from their servers can skip this tag. -->
   <download-settings url="https://example.com/get" />
 </service>
 </on-device-personalization>
 

Parametry
requestToken RequestToken: nieprzejrzysty token identyfikujący bieżące żądanie skierowane do usługi. Ta wartość nie może być typu null.

Zwroty
KeyValueStore Obiekt KeyValueStore, który zapewnia dostęp do tabeli REMOTE_DATA. metody w zwróconych zasobach KeyValueStore blokują operacje i powinny być jest wywoływane z wątku instancji roboczej, a nie z wątku głównego ani wątku powiązania. Ta wartość nie może być typu null.

getUserData

public final UserData getUserData (RequestToken requestToken)

Zwraca UserData udostępniony przez platformę dla bieżącego żądania.

Parametry
requestToken RequestToken: nieprzejrzysty token identyfikujący bieżące żądanie skierowane do usługi. Ta wartość nie może być typu null.

Zwroty
UserData Obiekt UserData. Ta wartość może wynosić null.

onBind

public IBinder onBind (Intent intent)

Obsługuje powiązanie z zasobem IsolatedService.

Parametry
intent Intent: intencja, która została użyta do powiązania z tą usługą, podana w usłudze Context.bindService. Zwróć uwagę, że wszelkie dodatki, które zostały uwzględnione w intencji w tym momencie nie będzie tutaj widoczne. Ta wartość nie może być typu null.

Zwroty
IBinder Ta wartość może wynosić null.

onCreate

public void onCreate ()

Tworzy powiązanie dla obiektu IsolatedService.

onRequest

public abstract IsolatedWorker onRequest (RequestToken requestToken)

Zwraca instancję instancji IsolatedWorker, która obsługuje żądania klientów.

Parametry
requestToken RequestToken: nieprzejrzysty token identyfikujący bieżące żądanie skierowane do usługi, która musi być przekazywane do metod usługi, które zależą od stanu poszczególnych żądań. Ta wartość nie może być typu null.

Zwroty
IsolatedWorker Ta wartość nie może być typu null.