DeviceClient

public interface DeviceClient

العميل للوصول إلى واجهات برمجة التطبيقات ذات الصلة بالجهاز

استخدِم DeviceClientFactory لإنشاء مثيل يتواصل مع تطبيق Android Device Policy على الجهاز.

ملخّص

الإجراءات العامة
abstract @NonNull ListenableFuture<@NonNull Device>

تعرض هذه السمة إشارات الجهاز.
abstract @NonNull Device

تعرض هذه السمة إشارات الجهاز.

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

getDevice

@RequiresApi(value = 28)
abstract @NonNull ListenableFuture<@NonNull Device> getDevice(@NonNull GetDeviceRequest request)

تعرض هذه السمة إشارات الجهاز.

تتطلّب واجهة برمجة التطبيقات هذه إعداد البيئة قبل استدعائها. يمكن التحقّق من البيئة إذا كانت معدّة مسبقًا من خلال استدعاء EnvironmentClient.getEnvironment. إذا لم يتم إعداد البيئة، يمكن إعدادها من خلال الاتصال بـ EnvironmentClient.prepareEnvironment.

ملاحظة: قد تختلف الإشارات التي يتم عرضها حسب المتصل وحالة إدارة الجهاز.

المرتجعات
@NonNull ListenableFuture<@NonNull Device>

ListenableFuture يلتف حول النتيجة. يمكن أن يكون ذلك

  • تمثّل هذه السمة عملية ناجحة تتضمّن Device، في حال النجاح.

  • قيمة مستقبلية فاشلة تتضمّن ApiLevelException إذا كان مستوى واجهة برمجة التطبيقات للجهاز أقل من 28

  • قيمة Future غير ناجحة تتضمّن EnvironmentNotPreparedException، في حال تعذّر إجراء المكالمة تحتوي الرسالة والنوع الفرعي للاستثناء على مزيد من التفاصيل حول الخطأ.

  • قيمة مستقبلية غير ناجحة تتضمّن SecurityException، إذا لم يكن المتصل مخوّلاً بطلب البيانات من واجهة برمجة التطبيقات هذه.

  • قيمة Future غير ناجحة تتضمّن TimeoutException، إذا تعذّر إجراء المكالمة بسبب انتهاء المهلة

  • قيمة مستقبلية غير ناجحة تتضمّن InternalException، إذا تعذّر إجراء المكالمة بسبب خطأ داخلي

getDeviceAwait

@RequiresApi(value = 28)
abstract @NonNull Device getDeviceAwait(@NonNull GetDeviceRequest request)

تعرض هذه السمة إشارات الجهاز.

تتطلّب واجهة برمجة التطبيقات هذه إعداد البيئة قبل استدعائها. يمكن التحقّق من البيئة إذا كانت معدّة مسبقًا من خلال استدعاء EnvironmentClient.getEnvironment. إذا لم يتم إعداد البيئة، يمكن إعدادها من خلال الاتصال بـ EnvironmentClient.prepareEnvironment.

ملاحظة: قد تختلف الإشارات التي يتم عرضها حسب المتصل وحالة إدارة الجهاز.

المرتجعات
@NonNull Device

Device تمثّل إشارات الجهاز.
عمليات الطرح
com.google.android.managementapi.common.exceptions.ApiLevelException

إذا كان مستوى واجهة برمجة التطبيقات على الجهاز أقل من 28

com.google.android.managementapi.environment.exception.EnvironmentNotPreparedException في حال تعذّر إجراء المكالمة تحتوي الرسالة والنوع الفرعي للاستثناء على مزيد من التفاصيل حول الخطأ.
java.lang.SecurityException

إذا لم يكن لدى المتصل إذن بالاتصال بواجهة برمجة التطبيقات هذه.
java.util.concurrent.TimeoutException

إذا تعذّر إجراء المكالمة بسبب انتهاء المهلة
com.google.android.managementapi.common.exceptions.InternalException

إذا تعذّر إجراء المكالمة بسبب خطأ داخلي