OemSystemUpdateClient
public interface OemSystemUpdateClient
برنامج يتيح لتطبيقات المصنّعين الأصليين للأجهزة التفاعل مع Android Management API بشأن تحديثات النظام عبر شبكة غير سلكية (OTA).
تتيح لبرامج OTA استرداد التعليمات التي تحدّدها السياسة والإبلاغ عن الحالة المرتبطة بتحديثات النظام.
يتم إجراء المكالمات باستخدام هذا البرنامج من برنامج OTA إلى المكوّن المثبَّت على الجهاز فقط في Android Management API.
ملخّص
الإجراءات العامة
createSystemUpdate
abstract @NonNull SystemUpdate createSystemUpdate(@NonNull CreateSystemUpdateRequest request)
توفّر هذه السمة لمكتبة AMAPI مورد SystemUpdate جديدًا.
يجب أن يحتوي العنصر SystemUpdate في request على الحقول التي يملكها عميل OTA فقط. يتم تجاهل الحقول التي تم وضع علامة عليها بأنّها مخصّصة للإخراج فقط ضمن SystemUpdate (مثل instruction) إذا تم توفيرها في الطلب.
تحتوي الاستجابة على كائن SystemUpdate، مع حقول مخصّصة للإخراج فقط، مثل instruction، يحدّدها AMAPI استنادًا إلى السياسة.
| المَعلمات | |
|---|---|
@NonNull CreateSystemUpdateRequest request |
تمثّل هذه السمة |
| المرتجعات | |
|---|---|
@NonNull SystemUpdate |
عنصر |
| عمليات الطرح | |
|---|---|
com.google.android.managementapi.oemsystemupdate.UpdateControlStateRequiredException |
إذا لم يكن |
|
|
|
|
|
|
|
|
|
|
|
|
java.lang.SecurityException |
|
|
|
|
|
TimeoutException |
|
|
|
createSystemUpdateFuture
abstract @NonNull ListenableFuture<@NonNull SystemUpdate> createSystemUpdateFuture(@NonNull CreateSystemUpdateRequest request)
توفّر هذه السمة لمكتبة AMAPI مورد SystemUpdate جديدًا. هذا الإجراء مماثل للإجراء createSystemUpdate، ولكنّه يعرض ListenableFuture بدلاً من التعليق.
| المَعلمات | |
|---|---|
@NonNull CreateSystemUpdateRequest request |
تمثّل هذه السمة |
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull SystemUpdate> |
تمثّل
|
getSystemUpdate
abstract @NonNull SystemUpdate getSystemUpdate(@NonNull GetSystemUpdateRequest request)
يستردّ هذا الحقل مورد SystemUpdate تم ضبطه سابقًا من قِبل عميل OTA.
تسمح هذه الطريقة لبرنامج OTA باسترداد الحالة الحالية للتحديث الذي تم إنشاؤه، بما في ذلك التعليمات المحدّدة في AMAPI.
| المَعلمات | |
|---|---|
@NonNull GetSystemUpdateRequest request |
الطلب الذي يحتوي على اسم المورد وطريقة العرض المطلوبة للمورد |
| المرتجعات | |
|---|---|
@NonNull SystemUpdate |
عنصر |
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
java.lang.SecurityException |
|
|
|
|
|
TimeoutException |
|
|
|
getSystemUpdateFuture
abstract @NonNull ListenableFuture<@NonNull SystemUpdate> getSystemUpdateFuture(@NonNull GetSystemUpdateRequest request)
يستردّ هذا الحقل مورد SystemUpdate تم ضبطه سابقًا من قِبل عميل OTA. هذا الإجراء مماثل للإجراء getSystemUpdate، ولكنّه يعرض ListenableFuture بدلاً من التعليق.
| المَعلمات | |
|---|---|
@NonNull GetSystemUpdateRequest request |
الطلب الذي يحتوي على اسم المورد وطريقة العرض المطلوبة للمورد |
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull SystemUpdate> |
|
getUpdateControlState
abstract @NonNull UpdateControlState getUpdateControlState(@NonNull GetUpdateControlStateRequest request)
تعرض هذه السمة حالة التحكّم الحالية في تحديث النظام. يستخدم برنامج OTA الخاص بالمصنّع الأصلي للجهاز هذه الطريقة لاسترداد الحالة الحالية لحلّ التحكّم في التحديث الذي تعرفه واجهة برمجة التطبيقات Android Management API.
| المَعلمات | |
|---|---|
@NonNull GetUpdateControlStateRequest request |
| المرتجعات | |
|---|---|
@NonNull UpdateControlState |
تمثّل هذه السمة |
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
getUpdateControlStateFuture
abstract @NonNull ListenableFuture<@NonNull UpdateControlState> getUpdateControlStateFuture(
@NonNull GetUpdateControlStateRequest request
)
تعرض هذه السمة حالة التحكّم الحالية في تحديث النظام. يستخدم برنامج OTA الخاص بالمصنّع الأصلي للجهاز هذه الطريقة لاسترداد الحالة الحالية لحلّ التحكّم في التحديث الذي تعرفه واجهة برمجة التطبيقات Android Management API.
| المَعلمات | |
|---|---|
@NonNull GetUpdateControlStateRequest request |
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull UpdateControlState> |
|
listSystemUpdates
abstract @NonNull ListSystemUpdatesResponse listSystemUpdates(@NonNull ListSystemUpdatesRequest request)
تعرض هذه الطريقة قائمة بجميع موارد SystemUpdate التي سبق أن ضبطها عميل OTA.
تسمح هذه الطريقة لبرنامج OTA باسترداد الحالة الحالية للتحديثات، بما في ذلك التعليمات المحدّدة في AMAPI، لجميع التحديثات التي أنشأها والتي يعرفها AMAPI.
| المَعلمات | |
|---|---|
@NonNull ListSystemUpdatesRequest request |
الطلب الذي يحتوي على طريقة العرض المطلوبة للموارد |
| المرتجعات | |
|---|---|
@NonNull ListSystemUpdatesResponse |
تمثّل هذه السمة |
| عمليات الطرح | |
|---|---|
com.google.android.managementapi.oemsystemupdate.UpdateControlStateRequiredException |
إذا لم يكن |
|
|
|
|
|
|
|
|
|
|
java.lang.SecurityException |
|
|
|
|
|
TimeoutException |
|
|
|
listSystemUpdatesFuture
abstract @NonNull ListenableFuture<@NonNull ListSystemUpdatesResponse> listSystemUpdatesFuture(@NonNull ListSystemUpdatesRequest request)
تعرض هذه الطريقة قائمة بجميع موارد SystemUpdate التي سبق أن ضبطها عميل OTA. هذا الإجراء مماثل للإجراء listSystemUpdates، ولكنّه يعرض ListenableFuture بدلاً من التعليق.
| المَعلمات | |
|---|---|
@NonNull ListSystemUpdatesRequest request |
الطلب الذي يحتوي على طريقة العرض المطلوبة للموارد |
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull ListSystemUpdatesResponse> |
تمثّل هذه السمة
|
reportSystemUpdateAborted
abstract @NonNull ReportSystemUpdateAbortedResponse reportSystemUpdateAborted(
@NonNull ReportSystemUpdateAbortedRequest request
)
تعرض هذه السمة أنّه تم إيقاف تحديث النظام.
يتم استدعاء هذه الطريقة عندما يلغي عميل التحديث عبر شبكة غير سلكية عملية تحديث النظام. يجب أن يتضمّن الطلب اسم مورد تحديث النظام وسبب الإلغاء. هذه حالة نهائية للتحديث.
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
reportSystemUpdateAbortedFuture
abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAbortedResponse> reportSystemUpdateAbortedFuture(
@NonNull ReportSystemUpdateAbortedRequest request
)
تعرض هذه السمة أنّه تم إيقاف تحديث النظام.
يتم استدعاء هذه الطريقة عندما يلغي عميل التحديث عبر شبكة غير سلكية عملية تحديث النظام. يجب أن يتضمّن الطلب اسم مورد تحديث النظام وسبب الإلغاء. هذه حالة نهائية للتحديث.
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull ReportSystemUpdateAbortedResponse> |
قيمة
|
reportSystemUpdateApplied
abstract @NonNull ReportSystemUpdateAppliedResponse reportSystemUpdateApplied(
@NonNull ReportSystemUpdateAppliedRequest request
)
تعرض هذه السمة تقارير تفيد بأنّه تم تطبيق تحديث النظام بنجاح.
يجب استدعاء هذه الطريقة عندما يطبّق برنامج OTA تحديثًا للنظام بنجاح باتّباع التعليمات الواردة من Android Management API. إذا كان ذلك يتطلّب إعادة التشغيل، يجب استدعاء هذا الإجراء بعد إعادة التشغيل. يجب أن يحدّد الطلب اسم المورد لتحديث النظام الذي تم تطبيقه. هذه حالة نهائية للتحديث.
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
reportSystemUpdateAppliedFuture
abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedResponse> reportSystemUpdateAppliedFuture(
@NonNull ReportSystemUpdateAppliedRequest request
)
تعرض هذه السمة تقارير تفيد بأنّه تم تطبيق تحديث النظام بنجاح.
يجب استدعاء هذه الطريقة عندما يطبّق برنامج OTA تحديثًا للنظام بنجاح باتّباع التعليمات الواردة من Android Management API. إذا كان ذلك يتطلّب إعادة التشغيل، يجب استدعاء هذا الإجراء بعد إعادة التشغيل. يجب أن يحدّد الطلب اسم المورد لتحديث النظام الذي تم تطبيقه. هذه حالة نهائية للتحديث.
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedResponse> |
قيمة
|
reportSystemUpdateAppliedWithOverride
abstract @NonNull ReportSystemUpdateAppliedWithOverrideResponse reportSystemUpdateAppliedWithOverride(
@NonNull ReportSystemUpdateAppliedWithOverrideRequest request
)
تشير إلى أنّه تم تطبيق تحديث للنظام، ما يؤدي إلى تجاهل تعليمات AMAPI.
يتم استدعاء هذه الطريقة عندما يطبّق برنامج OTA تحديثًا للنظام بما يتعارض مع التعليمات BLOCK من Android Management API. يجب أن يتضمّن الطلب اسم مورد تحديث النظام وسببًا لتجاوز الحدّ. هذه حالة نهائية للتحديث.
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
reportSystemUpdateAppliedWithOverrideFuture
abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedWithOverrideResponse> reportSystemUpdateAppliedWithOverrideFuture(
@NonNull ReportSystemUpdateAppliedWithOverrideRequest request
)
تشير إلى أنّه تم تطبيق تحديث للنظام، ما يؤدي إلى تجاهل تعليمات AMAPI.
يتم استدعاء هذه الطريقة عندما يطبّق برنامج OTA تحديثًا للنظام بما يتعارض مع التعليمات BLOCK من Android Management API. يجب أن يتضمّن الطلب اسم مورد تحديث النظام وسببًا لتجاوز الحدّ. هذه حالة نهائية للتحديث.
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull ReportSystemUpdateAppliedWithOverrideResponse> |
قيمة
|
reportSystemUpdateApplyPrevented
abstract @NonNull ReportSystemUpdateApplyPreventedResponse reportSystemUpdateApplyPrevented(
@NonNull ReportSystemUpdateApplyPreventedRequest request
)
تعرض هذه السمة تقارير تفيد بأنّه تم منع تطبيق تحديث النظام.
يجب استدعاء هذا الإجراء عندما يُطلب من عميل التحديث عبر الهواء تطبيق تحديث ولكن يمنعه شرط محلي من إجراء ذلك. يجب أن يتضمّن الطلب اسم المورد الخاص بتحديث النظام وسببًا لمنع التحديث.
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
reportSystemUpdateApplyPreventedFuture
abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateApplyPreventedResponse> reportSystemUpdateApplyPreventedFuture(
@NonNull ReportSystemUpdateApplyPreventedRequest request
)
تعرض هذه السمة تقارير تفيد بأنّه تم منع تطبيق تحديث النظام.
يجب استدعاء هذا الإجراء عندما يُطلب من عميل التحديث عبر الهواء تطبيق تحديث ولكن يمنعه شرط محلي من إجراء ذلك. يجب أن يتضمّن الطلب اسم المورد الخاص بتحديث النظام وسببًا لمنع التحديث.
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull ReportSystemUpdateApplyPreventedResponse> |
قيمة
|
reportSystemUpdateDownloadPrevented
abstract @NonNull ReportSystemUpdateDownloadPreventedResponse reportSystemUpdateDownloadPrevented(
@NonNull ReportSystemUpdateDownloadPreventedRequest request
)
تعرض هذه السمة أنّه تم منع تنزيل تحديث النظام.
يجب استدعاء هذه الطريقة عندما يُطلب من عميل OTA تنزيل تحديث ولكن يتم منعه من ذلك بسبب شرط محلي (مثل عدم كفاية البطارية أو عدم توفّر شبكة). يجب أن يتضمّن الطلب اسم المورد الخاص بتحديث النظام وسببًا وجيهًا لمنع التحديث.
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
reportSystemUpdateDownloadPreventedFuture
abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadPreventedResponse> reportSystemUpdateDownloadPreventedFuture(
@NonNull ReportSystemUpdateDownloadPreventedRequest request
)
تعرض هذه السمة أنّه تم منع تنزيل تحديث النظام.
يجب استدعاء هذه الطريقة عندما يُطلب من عميل OTA تنزيل تحديث ولكن يتم منعه من ذلك بسبب شرط محلي (مثل عدم كفاية البطارية أو عدم توفّر شبكة). يجب أن يتضمّن الطلب اسم المورد الخاص بتحديث النظام وسببًا وجيهًا لمنع التحديث.
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadPreventedResponse> |
قيمة
|
reportSystemUpdateDownloaded
abstract @NonNull ReportSystemUpdateDownloadedResponse reportSystemUpdateDownloaded(
@NonNull ReportSystemUpdateDownloadedRequest request
)
تعرض هذه السمة تقارير تفيد بأنّه تم تنزيل تحديث النظام بنجاح.
يجب استدعاء هذه الطريقة عندما يكمل برنامج OTA تنزيل تحديث النظام وفقًا للتعليمات التي تقدّمها Android Management API. يجب أن يتضمّن الطلب اسم المورد لتحديث النظام الذي تم تنزيله.
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
reportSystemUpdateDownloadedFuture
abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedResponse> reportSystemUpdateDownloadedFuture(
@NonNull ReportSystemUpdateDownloadedRequest request
)
تعرض هذه السمة تقارير تفيد بأنّه تم تنزيل تحديث النظام بنجاح.
يجب استدعاء هذه الطريقة عندما يكمل برنامج OTA تنزيل تحديث النظام وفقًا للتعليمات التي تقدّمها Android Management API. يجب أن يتضمّن الطلب اسم المورد لتحديث النظام الذي تم تنزيله.
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedResponse> |
قيمة
|
reportSystemUpdateDownloadedWithOverride
abstract @NonNull ReportSystemUpdateDownloadedWithOverrideResponse reportSystemUpdateDownloadedWithOverride(
@NonNull ReportSystemUpdateDownloadedWithOverrideRequest request
)
تعرض هذه السمة تقارير تفيد بأنّه تم تنزيل تحديث للنظام، ما يؤدي إلى تجاهل تعليمات AMAPI.
يتم استدعاء هذه الطريقة عندما يكمل برنامج OTA تنزيل تحديث النظام، بعد إلغاء تعليمات BLOCK من Android Management API. يجب أن يتضمّن الطلب اسم مورد تحديث النظام وسببًا لتجاوز الحدّ.
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
reportSystemUpdateDownloadedWithOverrideFuture
abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedWithOverrideResponse> reportSystemUpdateDownloadedWithOverrideFuture(
@NonNull ReportSystemUpdateDownloadedWithOverrideRequest request
)
تعرض هذه السمة تقارير تفيد بأنّه تم تنزيل تحديث للنظام، ما يؤدي إلى تجاهل تعليمات AMAPI.
يتم استدعاء هذه الطريقة عندما يكمل برنامج OTA تنزيل تحديث النظام، بعد إلغاء تعليمات BLOCK من Android Management API. يجب أن يتضمّن الطلب اسم مورد تحديث النظام وسببًا لتجاوز الحدّ.
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadedWithOverrideResponse> |
قيمة
|
reportSystemUpdateDownloading
abstract @NonNull ReportSystemUpdateDownloadingResponse reportSystemUpdateDownloading(
@NonNull ReportSystemUpdateDownloadingRequest request
)
تسجيل بدء تنزيل تحديث النظام
يجب استدعاء هذه الطريقة عندما يبدأ عميل التحديث عبر الهواء (OTA) أو يستأنف تنزيل تحديث النظام وفقًا للتعليمات الواردة من واجهة برمجة التطبيقات لإدارة Android. يجب أن يتضمّن الطلب اسم المورد لتحديث النظام الذي يتم تنزيله.
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
reportSystemUpdateDownloadingFuture
abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingResponse> reportSystemUpdateDownloadingFuture(
@NonNull ReportSystemUpdateDownloadingRequest request
)
تسجيل بدء تنزيل تحديث النظام
يجب استدعاء هذه الطريقة عندما يبدأ عميل التحديث عبر الهواء (OTA) أو يستأنف تنزيل تحديث النظام وفقًا للتعليمات الواردة من واجهة برمجة التطبيقات لإدارة Android. يجب أن يتضمّن الطلب اسم المورد لتحديث النظام الذي يتم تنزيله.
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingResponse> |
قيمة
|
reportSystemUpdateDownloadingWithOverride
abstract @NonNull ReportSystemUpdateDownloadingWithOverrideResponse reportSystemUpdateDownloadingWithOverride(
@NonNull ReportSystemUpdateDownloadingWithOverrideRequest request
)
تسجيل بدء تنزيل تحديث النظام، مع تجاهل تعليمات AMAPI
يجب استدعاء هذه الطريقة عندما يبدأ برنامج OTA بتنزيل تحديث للنظام على الرغم من أنّ التعليمات الواردة من Android Management API كانت بحظر التنزيل. يجب أن يتضمّن الطلب اسم مورد تحديث النظام وسببًا لتجاوز الحدّ.
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
reportSystemUpdateDownloadingWithOverrideFuture
abstract @NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingWithOverrideResponse> reportSystemUpdateDownloadingWithOverrideFuture(
@NonNull ReportSystemUpdateDownloadingWithOverrideRequest request
)
تسجيل بدء تنزيل تحديث النظام، مع تجاهل تعليمات AMAPI
يجب استدعاء هذه الطريقة عندما يبدأ برنامج OTA بتنزيل تحديث للنظام على الرغم من أنّ التعليمات الواردة من Android Management API كانت بحظر التنزيل. يجب أن يتضمّن الطلب اسم مورد تحديث النظام وسببًا لتجاوز الحدّ.
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull ReportSystemUpdateDownloadingWithOverrideResponse> |
قيمة
|
updateUpdateControlState
abstract @NonNull UpdateControlState updateUpdateControlState(
@NonNull UpdateUpdateControlStateRequest request
)
تعدّل هذه السمة حالة التحكّم في تحديث النظام. يستخدم عميل التحديث عبر اتصال لاسلكي (OTA) الخاص بالمصنّع الأصلي للجهاز هذه الطريقة للإبلاغ عن أي تغييرات في حالة التحكّم في التحديث. على عميل الشركة المصنّعة للمعدات الأصلية استدعاء هذه الطريقة كلما تغيّرت حالة التحكّم.
| المَعلمات | |
|---|---|
@NonNull UpdateUpdateControlStateRequest request |
الطلب الذي يحتوي على |
| المرتجعات | |
|---|---|
@NonNull UpdateControlState |
|
| عمليات الطرح | |
|---|---|
|
|
|
|
|
|
|
|
updateUpdateControlStateFuture
abstract @NonNull ListenableFuture<@NonNull UpdateControlState> updateUpdateControlStateFuture(
@NonNull UpdateUpdateControlStateRequest request
)
تعدّل هذه السمة حالة التحكّم في تحديث النظام. يستخدم عميل التحديث عبر اتصال لاسلكي (OTA) الخاص بالمصنّع الأصلي للجهاز هذه الطريقة للإبلاغ عن أي تغييرات في حالة التحكّم في التحديث. على عميل الشركة المصنّعة للمعدات الأصلية استدعاء هذه الطريقة كلما تغيّرت حالة التحكّم.
| المَعلمات | |
|---|---|
@NonNull UpdateUpdateControlStateRequest request |
الطلب الذي يحتوي على |
| المرتجعات | |
|---|---|
@NonNull ListenableFuture<@NonNull UpdateControlState> |
|