الخدمة المعزولة

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 والأحداث التي تتيح الوصول إلى الصفوف التي يمكن قراءتها باستخدام 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.

يُرجى الاطّلاع أيضًا على:

getLogReader

public final LogReader getLogReader (RequestToken requestToken)

تعرض دالة DAO للجداول REQUESTS والأحداث التي تتيح الوصول إلى الصفوف التي يمكن قراءتها باستخدام IsolatedService.

المعلّمات
requestToken RequestToken: رمز مميّز مبهم يحدّد الطلب الحالي للخدمة. لا يمكن أن تكون هذه القيمة null.
الركلات المردودة
LogReader عنصر LogReader يوفّر إمكانية الوصول إلى جدولَي REQUESTS وevents. إنّ الطرق في سلسلة 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 التي يتم عرضها هي حظر العمليات، ويجب طلبها من سلسلة التعليمات وليس من سلسلة التعليمات الرئيسية أو سلسلة Binder. لا يمكن أن تكون هذه القيمة null.

يُرجى الاطّلاع أيضًا على:

الحصول على بيانات المستخدمين

public final UserData getUserData (RequestToken requestToken)

تعرض السمة UserData التي توفّرها المنصّة للطلب الحالي.

المعلّمات
requestToken RequestToken: رمز مميّز مبهم يحدّد الطلب الحالي للخدمة. لا يمكن أن تكون هذه القيمة null.
الركلات المردودة
UserData عنصر UserData: قد تكون هذه القيمة null.

يُرجى الاطّلاع أيضًا على:

تقرير onbound

public IBinder onBind (Intent intent)

أسماء الحسابات مرتبطة بـ IsolatedService

المعلّمات
intent Intent: الغرض الذي تم استخدامه للربط بهذه الخدمة على النحو المعطى لـ Context.bindService. وتجدر الإشارة إلى أنّ أيّ إضافات تم تضمينها في Intent في ذلك الوقت لن تظهر هنا. لا يمكن أن تكون هذه القيمة null.
الركلات المردودة
IBinder قد تكون هذه القيمة null.

onCreate

public void onCreate ()

لإنشاء مجلد لـ IsolatedService.

onRequest

public abstract IsolatedWorker onRequest (RequestToken requestToken)

عرض مثيل IsolatedWorker الذي يعالج طلبات العميل.

المعلّمات
requestToken RequestToken: رمز مميّز مبهم يحدّد الطلب الحالي للخدمة والذي يجب تمريره إلى طرق الخدمة التي تعتمد على حالة كل طلب. لا يمكن أن تكون هذه القيمة null.
الركلات المردودة
IsolatedWorker لا يمكن أن تكون هذه القيمة null.