OemSystemUpdateHandler

public interface OemSystemUpdateHandler

واجهة يجب أن ينفّذها عميل OTA الخاص بالشركة المصنّعة للمعدات الأصلية.

تطلب واجهة برمجة التطبيقات لإدارة Android من المكوّن الموجود على الجهاز فقط استدعاء الطرق ضِمن هذه الواجهة إلى برنامج تحديث البرامج عبر الأثير (OTA) الخاص بالمصنّع الأصلي للجهاز.

يمكنك الاطّلاع أيضًا على com.google.android.managementapi.notification.NotificationReceiverService.getOemSystemUpdateHandler.

ملخّص

الإجراءات العامة
abstract @NonNull UpdateControlState

يتم استدعاء هذه الطريقة من خلال AMAPI لاسترداد حالة التحكّم الحالية في تحديث النظام من عميل OTA.
abstract @NonNull ListPendingSystemUpdatesResponse
listPendingSystemUpdates(
    @NonNull ListPendingSystemUpdatesRequest listPendingSystemUpdatesRequest
)

يتم استدعاؤها من خلال AMAPI لطلب القائمة الحالية لتحديثات النظام المعلّقة من عميل OTA.
abstract @NonNull NotifySystemUpdatesChangedResponse
onSystemUpdatesChanged(
    @NonNull NotifySystemUpdatesChangedRequest notifySystemUpdatesChangedRequest
)

يتم استدعاء هذه الطريقة من خلال AMAPI عندما تتغير التعليمات الخاصة بتحديث واحد أو أكثر من تحديثات النظام المعلقة.

الإجراءات العامة

getUpdateControlState

abstract @NonNull UpdateControlState getUpdateControlState(@NonNull GetUpdateControlStateRequest request)

يتم استدعاء هذه الطريقة من خلال AMAPI لاسترداد حالة التحكّم الحالية في تحديث النظام من عميل OTA. يجب أن تعرض عملية تنفيذ برنامج OTA الحالي حالة التحكّم الحالية في تحديث النظام

المَعلمات
@NonNull GetUpdateControlStateRequest request

GetUpdateControlStateRequest فارغة
المرتجعات
@NonNull UpdateControlState

UpdateControlState الحالي لعميل OTA

listPendingSystemUpdates

abstract @NonNull ListPendingSystemUpdatesResponse listPendingSystemUpdates(
    @NonNull ListPendingSystemUpdatesRequest listPendingSystemUpdatesRequest
)

يتم استدعاؤها من خلال AMAPI لطلب القائمة الحالية لتحديثات النظام المعلّقة من عميل OTA.

يجب أن يعرض عميل OTA جميع تحديثات النظام المعلّقة التي يعرفها حاليًا. يُعدّ تحديث النظام معلّقًا إذا كان في حالة يمكن فيها تطبيقه (أي AVAILABLE أو DOWNLOADING أو DOWNLOADED أو DOWNLOAD_PREVENTED أو APPLY_PREVENTED) ولم يتم تطبيقه أو إلغاؤه بنجاح بعد. يجب أن تحتوي عناصر SystemUpdate التي يتم عرضها في ListPendingSystemUpdatesResponse.getSystemUpdates على الحقول التي يملكها المصنّع الأصلي للجهاز فقط (مثل id وtype وapi_level وname وdescription وstate وما إلى ذلك).

على وجه التحديد، يتم تجاهل الحقول التي يتم ضبطها من خلال AMAPI، مثل download_instruction وapply_instruction، ولا يُتوقّع أن يتم ملؤها في الردّ. تتطابق البيانات المعروضة مع تمثيل SYSTEM_UPDATE_VIEW_BASIC.

المَعلمات
@NonNull ListPendingSystemUpdatesRequest listPendingSystemUpdatesRequest

ListPendingSystemUpdatesRequest فارغة
المرتجعات
@NonNull ListPendingSystemUpdatesResponse

ListPendingSystemUpdatesResponse: يحتوي على قائمة بتحديثات النظام المعلّقة كما يعرفها برنامج OTA.

onSystemUpdatesChanged

abstract @NonNull NotifySystemUpdatesChangedResponse onSystemUpdatesChanged(
    @NonNull NotifySystemUpdatesChangedRequest notifySystemUpdatesChangedRequest
)

يتم استدعاء هذه الطريقة من خلال AMAPI عندما تتغير التعليمات الخاصة بتحديث واحد أو أكثر من تحديثات النظام المعلقة.

على عميل الشركة المصنّعة للمعدّات الأصلية معالجة المعلومات الواردة في طلب تحديثات النظام المشار إليها.

المَعلمات
@NonNull NotifySystemUpdatesChangedRequest notifySystemUpdatesChangedRequest

NotifySystemUpdatesChangedRequest من AMAPI يحتوي على قائمة بتحديثات النظام التي تم تغييرها.
المرتجعات
@NonNull NotifySystemUpdatesChangedResponse

اضغط على NotifySystemUpdatesChangedResponse للإقرار باستلام الرسالة.