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 前,必須先準備環境。您可以呼叫 EnvironmentClient.getEnvironment,檢查環境是否已準備就緒。如果環境尚未準備就緒,可以呼叫 EnvironmentClient.prepareEnvironment 準備環境。

注意:系統傳回的信號可能因來電者和裝置管理狀態而異。

傳回
@NonNull ListenableFuture<@NonNull Device>

以 ListenableFuture 包裝結果。可用的值包括:

  • 如果成功,則為包裝 Device 的成功 Future。

  • 如果裝置 API 級別低於 28,則會包裝失敗的 Future ApiLevelException。

  • 如果呼叫失敗,則為封裝 EnvironmentNotPreparedException 的失敗 Future。訊息和例外狀況的子類型包含失敗的詳細資料。

  • 如果呼叫者未獲授權呼叫此 API,則會包裝 SecurityException 的失敗結果。

  • 如果呼叫因逾時而失敗,則為封裝 TimeoutException 的失敗 Future。

  • 如果因內部錯誤導致呼叫失敗,則為包裝 InternalException 的失敗 Future。

getDeviceAwait

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

取得裝置信號。

呼叫此 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

如果呼叫因內部錯誤而失敗。