العامل المعزول

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 للتتبّع المقدَّم من النظام الأساسي EventUrlProvider والذي تم تضمينه في ناتج HTML الذي يعرضه onRender(android.adservices.ondevicepersonalization.RenderInput, java.util.function.Consumer)

default void onExecute(ExecuteInput input, Consumer<ExecuteOutput> consumer)

لمعالجة طلب من تطبيق

default void onRender(RenderInput input, Consumer<RenderOutput> consumer)

تنشئ HTML للنتائج التي تم عرضها نتيجة onExecute(android.adservices.ondevicepersonalization.ExecuteInput, java.util.function.Consumer)

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.

إذا عرضت هذه الطريقة RuntimeException، لن يتم إجراء أي تعديلات على جدول 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، لن تتم كتابة أي بيانات في جدول الأحداث.

إذا طرحت هذه الطريقة RuntimeException، فلن تتم كتابة أي بيانات في حدث EVENT المؤقت.

قيد التنفيذ

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 لتجميعها. تقارير الأخطاء.

إذا طرحت هذه الطريقة RuntimeException، سيتم الإبلاغ عن ذلك أيضًا. الاتصال بالتطبيقات على أنّها OnDevicePersonalizationException مع رمز الخطأ OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED

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.

إذا عرضت هذه الطريقة RuntimeException، فسيتم إبلاغ استدعاء ذلك أيضًا. التطبيقات مثل OnDevicePersonalizationException برمز الخطأ OnDevicePersonalizationException.ERROR_ISOLATED_SERVICE_FAILED.

onTrainingExample

public void onTrainingExample (TrainingExampleInput input, 
                Consumer<TrainingExampleOutput> consumer)

إنشاء مثال تدريب واحد يُستخدم في مهمة الحوسبة الموحّدة.

المعلمات
input TrainingExampleInput: المَعلمات اللازمة لإنشاء مثال التدريب لا يمكن أن تكون هذه القيمة null.
consumer Consumer: سيتم استدعاء معاودة الاتصال عند الانتهاء. لا يمكن أن تكون هذه القيمة null.