Isolated Service

public abstract class IsolatedService
extends Service

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


کلاس پایه برای سرویس‌هایی که توسط ODP در تماس با OnDevicePersonalizationManager#execute(ComponentName, PersistableBundle, java.util.concurrent.Executor, OutcomeReceiver) شروع شده و در یک فرآیند مجزا اجرا می‌شوند. این سرویس می‌تواند محتوایی تولید کند که در یک SurfaceView در یک برنامه تماس نمایش داده شود و نتایج پایدار را در فضای ذخیره‌سازی روی دستگاه بنویسد، که می‌تواند توسط Federated Analytics برای تجزیه و تحلیل آماری بین دستگاهی یا توسط Federated Learning برای آموزش مدل مصرف شود. برنامه های سرویس گیرنده از OnDevicePersonalizationManager برای تعامل با IsolatedService استفاده می کنند.

خلاصه

ثابت های ارثی

سازندگان عمومی

IsolatedService ()

روش های عمومی

final EventUrlProvider getEventUrlProvider ( RequestToken requestToken)

یک EventUrlProvider را برای درخواست فعلی برمی گرداند.

final FederatedComputeScheduler getFederatedComputeScheduler ( RequestToken requestToken)

یک FederatedComputeScheduler را برای درخواست فعلی برمی‌گرداند.

final MutableKeyValueStore getLocalData ( RequestToken requestToken)

یک شیء دسترسی به داده را برای جدول LOCAL_DATA برمی‌گرداند.

final LogReader getLogReader ( RequestToken requestToken)

یک DAO برای جداول REQUESTS و EVENTS برمی‌گرداند که دسترسی به ردیف‌هایی را که توسط IsolatedService قابل خواندن هستند، فراهم می‌کند.

final KeyValueStore getRemoteData ( RequestToken requestToken)

یک شیء دسترسی به داده را برای جدول REMOTE_DATA برمی گرداند.

final UserData getUserData ( RequestToken requestToken)

UserData ارائه شده توسط پلتفرم را برای درخواست فعلی برمی گرداند.

IBinder onBind ( Intent intent)

اتصال به IsolatedService کنترل می کند.

void onCreate ()

یک کلاسور برای IsolatedService ایجاد می کند.

abstract IsolatedWorker onRequest ( RequestToken requestToken)

نمونه ای از یک IsolatedWorker را برگردانید که به درخواست های مشتری رسیدگی می کند.

روش های ارثی

سازندگان عمومی

سرویس جدا شده

public IsolatedService ()

روش های عمومی

GetEventurlProvider

public final EventUrlProvider getEventUrlProvider (RequestToken requestToken)

برای درخواست فعلی ، یک EventUrlProvider را برمی گرداند. EventUrlProvider URL هایی را فراهم می کند که می توانند در HTML تعبیه شوند. هنگامی که HTML در یک WebView ارائه می شود ، این پلتفرم درخواست این URL ها را رهگیری می کند و از IsolatedWorker#onEvent(EventInput, Consumer) استفاده می کند.

پارامترها
requestToken RequestToken : یک نشانه مات که درخواست فعلی را برای سرویس مشخص می کند. این مقدار نمی تواند null باشد.

برمی گرداند
EventUrlProvider یک EventUrlProvider که URL های ردیابی رویداد را برمی گرداند. این مقدار نمی تواند null باشد.

همچنین ببینید:

getFederatedComputescheduler

public final FederatedComputeScheduler getFederatedComputeScheduler (RequestToken requestToken)

برای درخواست فعلی ، یک FederatedComputeScheduler را برمی گرداند. FederatedComputeScheduler می تواند برای برنامه ریزی و لغو مشاغل محاسبات فدرال استفاده شود. محاسبات فدرال شامل یادگیری فدرال و مشاغل تحلیلی فدرال است.

پارامترها
requestToken RequestToken : یک نشانه مات که درخواست فعلی را برای سرویس مشخص می کند. این مقدار نمی تواند null باشد.

برمی گرداند
FederatedComputeScheduler یک FederatedComputeScheduler که یک برنامه ریز کار محاسبات فدرال را برمی گرداند. این مقدار نمی تواند null باشد.

همچنین ببینید:

گچکالداتا

public final MutableKeyValueStore getLocalData (RequestToken requestToken)

یک شی دسترسی به داده را برای جدول local_data برمی گرداند. جدول local_data یک فروشگاه با ارزش کلیدی مداوم است که این سرویس می تواند برای ذخیره هرگونه داده از آن استفاده کند. محتوای این جدول فقط برای سرویس اجرا شده در یک فرآیند جدا شده قابل مشاهده است و نمی تواند در خارج از دستگاه ارسال شود.

پارامترها
requestToken RequestToken : یک نشانه مات که درخواست فعلی را برای سرویس مشخص می کند. این مقدار نمی تواند null باشد.

برمی گرداند
MutableKeyValueStore یک شیء MutableKeyValueStore که دسترسی به جدول local_data را فراهم می کند. روشهای موجود در MutableKeyValueStore برگشتی در حال مسدود کردن عملیات است و باید از یک موضوع کارگر فراخوانی شود و نه موضوع اصلی یا یک موضوع اتصال. این مقدار نمی تواند null باشد.

همچنین ببینید:

گله دار

public final LogReader getLogReader (RequestToken requestToken)

DAO را برای جداول درخواست ها و رویدادها که دسترسی به ردیف هایی را فراهم می کند که توسط IsolatedService قابل خواندن است ، باز می گرداند.

پارامترها
requestToken RequestToken : یک نشانه مات که درخواست فعلی را برای سرویس مشخص می کند. این مقدار نمی تواند null باشد.

برمی گرداند
LogReader یک شیء LogReader که دسترسی به جدول درخواست ها و رویدادها را فراهم می کند. روشهای موجود در LogReader برگشتی ، عملیات را مسدود می کند و باید از یک نخ کارگر فراخوانی شود و نه نخ اصلی یا یک موضوع اتصال. این مقدار نمی تواند null باشد.

همچنین ببینید:

گیتموتداتا

public final KeyValueStore getRemoteData (RequestToken requestToken)

یک شی دسترسی به داده را برای جدول remote_data برمی گرداند. جدول remote_data یک فروشگاه با ارزش کلیدی فقط خواندنی است که حاوی داده هایی است که بطور دوره ای از نقطه پایانی اعلام شده در آن بارگیری می شود همانطور که در مثال زیر نشان داده شده است ، در مانیفست ODP سرویس برچسب بزنید.

<!-- 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>
 

پارامترها
requestToken RequestToken : یک نشانه مات که درخواست فعلی را برای سرویس مشخص می کند. این مقدار نمی تواند null باشد.

برمی گرداند
KeyValueStore یک شیء KeyValueStore که دسترسی به جدول remote_data را فراهم می کند. روشهای موجود در KeyValueStore برگشتی در حال مسدود کردن عملیات است و باید از یک موضوع کارگر فراخوانی شود و نه موضوع اصلی یا یک موضوع اتصال. این مقدار نمی تواند null باشد.

همچنین ببینید:

جبهه

public final UserData getUserData (RequestToken requestToken)

UserData با ارائه شده توسط پلتفرم را برای درخواست فعلی برمی گرداند.

پارامترها
requestToken RequestToken : یک نشانه مات که درخواست فعلی را برای سرویس مشخص می کند. این مقدار نمی تواند null باشد.

برمی گرداند
UserData یک شیء UserData . این مقدار ممکن است null باشد.

همچنین ببینید:

در

public IBinder onBind (Intent intent)

دسته اتصال به IsolatedService .

پارامترها
intent Intent : نیتی که برای اتصال به این سرویس استفاده می شود ، همانطور که به Context.bindService داده شده است. توجه داشته باشید که هرگونه اضافی که با هدف در آن نقطه گنجانده شده باشد ، در اینجا دیده نمی شود. این مقدار نمی تواند null باشد.

برمی گرداند
IBinder این مقدار ممکن است null باشد.

در ایجاد

public void onCreate ()

یک اتصال دهنده برای یک IsolatedService ایجاد می کند.

در حال حاضر

public abstract IsolatedWorker onRequest (RequestToken requestToken)

نمونه ای از یک IsolatedWorker که درخواست های مشتری را بر عهده دارد ، برگردانید.

پارامترها
requestToken RequestToken : یک نشانه مات که درخواست فعلی را به سرویس مشخص می کند که باید به روشهای خدماتی که به حالت هرگونه درخواست بستگی دارد منتقل شود. این مقدار نمی تواند null باشد.

برمی گرداند
IsolatedWorker این مقدار نمی تواند null باشد.