خدمة معزولة

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 للتحليل الإحصائي عبر الأجهزة أو بواسطة التعلّم التعاوني لتدريب النموذج. تستخدم تطبيقات العميل 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.

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

أمر getFederatedCompute Scheduler

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 يوفر إمكانية الوصول إلى جدول "الطلبات" و"الأحداث". الطريقتان في 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.

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

onBind

public IBinder onBind (Intent intent)

الأسماء المعرِّفة التي يتم ربطها بـ "IsolatedService"

المعلمات
intent 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.