DeviceClient

public interface DeviceClient


ไคลเอ็นต์เพื่อเข้าถึง API ที่เกี่ยวข้องกับอุปกรณ์

ใช้ 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)

รับสัญญาณอุปกรณ์

API นี้กำหนดให้ต้องเตรียมสภาพแวดล้อมก่อนเรียกใช้ API นี้ คุณสามารถตรวจสอบสภาพแวดล้อมได้หากมีการเตรียมไว้แล้วโดยการโทร EnvironmentClient.getEnvironment หากยังไม่ได้เตรียมสภาพแวดล้อม คุณสามารถเตรียมได้โดยโทรหา EnvironmentClient.prepareEnvironment

หมายเหตุ: สัญญาณที่ส่งคืนอาจแตกต่างกันไปตามผู้โทรและสถานะการจัดการอุปกรณ์

การคืนสินค้า
@NonNull ListenableFuture<@NonNull Device>

ListenableFuture ครอบผลลัพธ์ ประเภทรายการได้แก่

  • อนาคตที่ประสบความสำเร็จในการห่อหุ้ม Device ในกรณีที่ประสบความสำเร็จ

  • Future ที่ล้มเหลวซึ่งห่อหุ้ม ApiLevelException หากระดับ API ของอุปกรณ์น้อยกว่า 28

  • Future ที่ห่อหุ้ม EnvironmentNotPreparedException ไม่สำเร็จ หากการเรียกใช้ไม่สำเร็จ ข้อความและประเภทย่อยของข้อยกเว้นจะมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

  • Future ที่ล้มเหลวซึ่งห่อหุ้ม SecurityException หากผู้เรียกไม่มีสิทธิ์เรียก API นี้

  • Future ที่ล้มเหลวซึ่งห่อหุ้ม TimeoutException หากการเรียกใช้ล้มเหลวเนื่องจากหมดเวลา

  • Future ที่ล้มเหลวซึ่งห่อหุ้ม InternalException หากการเรียกใช้ล้มเหลวเนื่องจากข้อผิดพลาดภายใน

getDeviceAwait

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

รับสัญญาณอุปกรณ์

API นี้กำหนดให้ต้องเตรียมสภาพแวดล้อมก่อนเรียกใช้ API นี้ คุณสามารถตรวจสอบสภาพแวดล้อมได้หากมีการเตรียมไว้แล้วโดยการโทร EnvironmentClient.getEnvironment หากยังไม่ได้เตรียมสภาพแวดล้อม คุณสามารถเตรียมได้โดยโทรหา EnvironmentClient.prepareEnvironment

หมายเหตุ: สัญญาณที่ส่งคืนอาจแตกต่างกันไปตามผู้โทรและสถานะการจัดการอุปกรณ์

การคืนสินค้า
@NonNull Device

Device ซึ่งแสดงถึงสัญญาณอุปกรณ์

ส่ง
com.google.android.managementapi.common.exceptions.ApiLevelException

หากระดับ API ของอุปกรณ์ต่ำกว่า 28

com.google.android.managementapi.environment.exception.EnvironmentNotPreparedException หากโทรไม่สำเร็จ ข้อความและประเภทย่อยของข้อยกเว้นจะมีรายละเอียดเพิ่มเติมเกี่ยวกับความล้มเหลว

SecurityException

หากผู้โทรไม่มีสิทธิ์เรียก API นี้

java.util.concurrent.TimeoutException

หากการโทรล้มเหลวเนื่องจากหมดเวลา

com.google.android.managementapi.common.exceptions.InternalException

หากโทรไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดภายใน