این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

مدیریت به‌روزرسانی سیستم Oem

public interface OemSystemUpdateHandler

رابط کاربری برای پیاده‌سازی کلاینت OTA تولیدکننده اصلی تجهیزات (OEM).

متدهای درون این رابط توسط کامپوننت درون دستگاهی API مدیریت اندروید برای کلاینت OTA تولیدکننده اصلی (OEM) فراخوانی می‌شوند.

همچنین به com.google.android.managementapi.notification.NotificationReceiverService.getOemSystemUpdateHandler مراجعه کنید.

خلاصه

روش‌های عمومی
`abstract @ NonNull UpdateControlState`	`getUpdateControlState (@ NonNull GetUpdateControlStateRequest request)` توسط AMAPI فراخوانی می‌شود تا وضعیت کنترل به‌روزرسانی سیستم فعلی را از کلاینت OTA بازیابی کند.
`abstract @ NonNull ListPendingSystemUpdatesResponse`	`listPendingSystemUpdates ( @ NonNull ListPendingSystemUpdatesRequest listPendingSystemUpdatesRequest )` توسط AMAPI فراخوانی می‌شود تا لیست فعلی به‌روزرسانی‌های سیستم در انتظار را از کلاینت OTA درخواست کند.
`abstract @ NonNull NotifySystemUpdatesChangedResponse`	`onSystemUpdatesChanged ( @ NonNull NotifySystemUpdatesChangedRequest notifySystemUpdatesChangedRequest )` وقتی دستورالعمل‌های مربوط به یک یا چند به‌روزرسانی سیستم در حال انتظار تغییر کرده باشد، توسط AMAPI فراخوانی می‌شود.

روش‌های عمومی

دریافت وضعیت کنترل

abstract @NonNull UpdateControlState getUpdateControlState(@NonNull GetUpdateControlStateRequest request)

توسط AMAPI فراخوانی می‌شود تا وضعیت کنترل به‌روزرسانی سیستم فعلی را از کلاینت OTA بازیابی کند. پیاده‌سازی کلاینت OTA باید وضعیت کنترل به‌روزرسانی سیستم فعلی را برگرداند.

پارامترها
`@ NonNull GetUpdateControlStateRequest request`	یک `GetUpdateControlStateRequest` خالی.

بازگشت‌ها
`@ NonNull UpdateControlState`	`UpdateControlState` فعلی کلاینت OTA.

لیست در انتظار به‌روزرسانی‌های سیستم

abstract @NonNull ListPendingSystemUpdatesResponse listPendingSystemUpdates(
    @NonNull ListPendingSystemUpdatesRequest listPendingSystemUpdatesRequest
)

توسط AMAPI فراخوانی می‌شود تا لیست فعلی به‌روزرسانی‌های سیستم در انتظار را از کلاینت OTA درخواست کند.

کلاینت OTA باید تمام به‌روزرسانی‌های سیستم در حال انتظاری را که در حال حاضر از آنها آگاه است، برگرداند. یک به‌روزرسانی سیستم در صورتی در حال انتظار در نظر گرفته می‌شود که در وضعیتی باشد که به طور بالقوه می‌تواند اعمال شود (یعنی AVAILABLE، DOWNLOADING، DOWNLOADED، DOWNLOAD_PREVENTED یا APPLY_PREVENTED) و هنوز با موفقیت اعمال نشده یا لغو نشده باشد. اشیاء SystemUpdate که در ListPendingSystemUpdatesResponse.getSystemUpdates برگردانده می‌شوند، فقط باید شامل فیلدهای متعلق به OEM (مثلاً 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 فراخوانی می‌شود.

مشتری OEM باید اطلاعات موجود در درخواست به‌روزرسانی‌های سیستم ارجاع‌شده را پردازش کند.

پارامترها
`@ NonNull NotifySystemUpdatesChangedRequest notifySystemUpdatesChangedRequest`	درخواست `NotifySystemUpdatesChangedRequest` از AMAPI که شامل فهرست به‌روزرسانی‌های تغییر یافته سیستم است.

بازگشت‌ها
`@ NonNull NotifySystemUpdatesChangedResponse`	یک `NotifySystemUpdatesChangedResponse` برای تأیید دریافت.