عامل معزول
public
interface
IsolatedWorker
android.adservices.ondevicepersonalization.IsolatedWorker |
واجهة بالطرق التي يلزم تنفيذها للتعامل مع الطلبات من نظام التشغيل إلى IsolatedService
. تنشئ IsolatedService
مثيلاً من IsolatedWorker
على كل طلب وتستدعي إحدى الطرق التالية، بناءً على نوع الطلب. تستدعي السمة IsolatedService
الطريقة في سلسلة Binder، ومن المفترض أن تُزيل IsolatedWorker
عمليات التشغيل التي تستغرق وقتًا طويلاً إلى سلسلة محادثات عاملة. ويتم استخدام معلَمة المستهلك لكل طريقة
لعرض النتائج.
ملخّص
الطرق المتاحة للجميع | |
---|---|
default
void
|
onDownloadCompleted(DownloadCompletedInput input, Consumer<DownloadCompletedOutput> consumer)
معالجة عملية تنزيل مكتملة |
default
void
|
onEvent(EventInput input, Consumer<EventOutput> consumer)
تعالج هذه السمة حدثًا تم تشغيله من خلال طلب مُرسَل إلى عنوان URL للتتبُّع |
default
void
|
onExecute(ExecuteInput input, Consumer<ExecuteOutput> consumer)
معالجة طلب من أحد التطبيقات. |
default
void
|
onRender(RenderInput input, Consumer<RenderOutput> consumer)
تنشئ هذه السمة تنسيق HTML للنتائج التي تم عرضها كنتيجة |
default
void
|
onTrainingExample(TrainingExampleInput input, Consumer<TrainingExampleOutput> consumer)
إنشاء مثال تدريب واحد يُستخدم لوظيفة الحوسبة الموحدة. |
الطرق المتاحة للجميع
تاريخ التنزيل المكتمل
public void onDownloadCompleted (DownloadCompletedInput input, Consumer<DownloadCompletedOutput> consumer)
معالجة عملية تنزيل مكتملة ينزّل النظام الأساسي المحتوى باستخدام المَعلمات المحددة في
بيان الحزمة الخاص بـ IsolatedService
، ثم يستدعي هذه الوظيفة بعد اكتمال
عملية التنزيل، ثم يعدّل الجدول REMOTE_DATA من
IsolatedService#getRemoteData(RequestToken)
بنتيجة هذه الطريقة.
المعلّمات | |
---|---|
input |
DownloadCompletedInput : تنزيل معلَمات المعالج
لا يمكن أن تكون هذه القيمة null . |
consumer |
Consumer : معاودة الاتصال التي تتلقّى النتيجة يجب استدعاء الدالة null مع ظهور خطأ. إذا تم الاتصال باستخدام null ، لن يتم إجراء أي تعديلات على الجدول REMOTE_DATA.
إذا عرضت هذه الطريقة خطأ |
onEvent
public void onEvent (EventInput input, Consumer<EventOutput> consumer)
تعالج هذه السمة حدثًا تم تشغيله من خلال طلب مُرسَل إلى عنوان URL للتتبُّع EventUrlProvider
المقدَّم من النظام الأساسي والذي تم تضمينه في مخرجات HTML التي يعرضها
onRender(android.adservices.ondevicepersonalization.RenderInput, java.util.function.Consumer)
. يعدّل النظام الأساسي جدول الأحداث باستخدام
EventOutput#getEventLogRecord()
.
المعلّمات | |
---|---|
input |
EventInput : المَعلمات اللازمة لحساب بيانات الأحداث
لا يمكن أن تكون هذه القيمة null . |
consumer |
Consumer : معاودة الاتصال التي تتلقّى النتيجة يجب استدعاء الدالة null مع ظهور خطأ. في حال الاتصال باستخدام null ، لن تتم كتابة أي بيانات في جدول "الأحداث".
إذا عرضت هذه الطريقة الخطأ |
onExecute
public void onExecute (ExecuteInput input, Consumer<ExecuteOutput> consumer)
تعالج هذه الطريقة طلبًا من تطبيق. يتم استدعاء هذه الطريقة عندما يطلب أحد التطبيقات OnDevicePersonalizationManager#execute(ComponentName, PersistableBundle,
java.util.concurrent.Executor, OutcomeReceiver)
الذي يشير إلى IsolatedService
باسم.
المعلّمات | |
---|---|
input |
ExecuteInput : معلَمات الطلب من تطبيق الاتصال.
لا يمكن أن تكون هذه القيمة null . |
consumer |
Consumer : معاودة الاتصال التي تتلقّى النتيجة ExecuteOutput يجب طلب البيانات
مع عرض null عند الخطأ. تم نشر الخطأ في تطبيق الاتصال كـ OnDevicePersonalizationException مع رمز الخطأ OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED . لتجنُّب تسريب البيانات الخاصة
إلى تطبيق الاتصال، لا تتوفّر ميزة الإبلاغ الأكثر تفصيلاً عن الأخطاء. إذا كانت IsolatedService بحاجة إلى الإبلاغ عن إحصاءات الأخطاء في الخلفية، يجب أن تملأ ExecuteOutput ببيانات الخطأ لتسجيل الدخول، والاعتماد على Federated Analytics لتجميع تقارير الأخطاء.
إذا عرضت هذه الطريقة خطأ |
onRender
public void onRender (RenderInput input, Consumer<RenderOutput> consumer)
تنشئ هذه السمة تنسيق HTML للنتائج التي تم عرضها كنتيجة onExecute(android.adservices.ondevicepersonalization.ExecuteInput, java.util.function.Consumer)
. يتم استدعاؤه عند اتصال تطبيق عميل بـ
OnDevicePersonalizationManager#requestSurfacePackage(SurfacePackageToken, IBinder, int, int, int, java.util.concurrent.Executor, OutcomeReceiver)
.
وسيعرض النظام الأساسي رمز HTML هذا في WebView
داخل إطار مضمّن مستقل.
المعلّمات | |
---|---|
input |
RenderInput : معلَمات طلب العرض
لا يمكن أن تكون هذه القيمة null . |
consumer |
Consumer : معاودة الاتصال التي تتلقّى النتيجة يجب استدعاء الدالة null مع ظهور خطأ. تم نشر الخطأ في تطبيق الاتصال كـ OnDevicePersonalizationException مع رمز الخطأ OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED .
إذا عرضت هذه الطريقة خطأ |
مثال على التدريب
public void onTrainingExample (TrainingExampleInput input, Consumer<TrainingExampleOutput> consumer)
إنشاء مثال تدريب واحد يُستخدم لوظيفة الحوسبة الموحدة.
المعلّمات | |
---|---|
input |
TrainingExampleInput : المعلَمات اللازمة لإنشاء مثال التدريب
لا يمكن أن تكون هذه القيمة null . |
consumer |
Consumer : معاودة الاتصال المطلوب استدعاؤها عند الانتهاء.
لا يمكن أن تكون هذه القيمة null . |