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 をラップした成功したフューチャー。

  • デバイスの API レベルが 28 未満の場合、ApiLevelException をラップする失敗したフューチャー。

  • 呼び出しが失敗した場合、EnvironmentNotPreparedException をラップする失敗したフューチャー。メッセージと例外のサブタイプには、障害の詳細が含まれています。

  • 呼び出し元にこの API を呼び出す権限がない場合に、SecurityException をラップした失敗したフューチャー。

  • タイムアウトが原因で呼び出しが失敗した場合、TimeoutException をラップする失敗した future。

  • 内部エラーが原因で呼び出しが失敗した場合、InternalException をラップする失敗したフューチャー。

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 呼び出しに失敗した場合。メッセージと例外のサブタイプには、障害の詳細が含まれています。
java.lang.SecurityException

呼び出し元にこの API を呼び出す権限がない。
java.util.concurrent.TimeoutException

タイムアウトが原因で通話が失敗した場合。
com.google.android.managementapi.common.exceptions.InternalException

内部エラーが原因で呼び出しが失敗した場合。