DeviceClient

public interface DeviceClient

Es el cliente para acceder a las APIs relacionadas con el dispositivo.

Usa DeviceClientFactory para crear una instancia que se comunique con la app de Device Policy de Android en el dispositivo.

Resumen

Métodos públicos
abstract @NonNull ListenableFuture<@NonNull Device>

Obtiene los indicadores del dispositivo.
abstract @NonNull Device

Obtiene los indicadores del dispositivo.

Métodos públicos

getDevice

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

Obtiene los indicadores del dispositivo.

Esta API requiere que el entorno esté preparado antes de llamarla. Para verificar si el entorno ya está preparado, llama a EnvironmentClient.getEnvironment. Si el entorno no está preparado, se puede preparar llamando a EnvironmentClient.prepareEnvironment.

Nota: Los indicadores que se devuelven pueden variar según la persona que llama y el estado de administración del dispositivo.

Muestra
@NonNull ListenableFuture<@NonNull Device>

Un ListenableFuture que contiene el resultado. Puede ser

  • Es un futuro exitoso que contiene un Device en caso de éxito.

  • Es un futuro fallido que encapsula un ApiLevelException si el nivel de API del dispositivo es inferior a 28.

  • Es un futuro fallido que contiene un EnvironmentNotPreparedException si la llamada falló. El mensaje y el subtipo de la excepción contienen más detalles sobre la falla.

  • Es un futuro fallido que contiene un SecurityException si el llamador no está autorizado para llamar a esta API.

  • Es un futuro fallido que contiene un TimeoutException si la llamada falló debido a un tiempo de espera agotado.

  • Es un futuro fallido que contiene un InternalException si la llamada falló debido a un error interno.

getDeviceAwait

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

Obtiene los indicadores del dispositivo.

Esta API requiere que el entorno esté preparado antes de llamarla. Para verificar si el entorno ya está preparado, llama a EnvironmentClient.getEnvironment. Si el entorno no está preparado, se puede preparar llamando a EnvironmentClient.prepareEnvironment.

Nota: Los indicadores que se devuelven pueden variar según la persona que llama y el estado de administración del dispositivo.

Muestra
@NonNull Device

Device que representa los indicadores del dispositivo.
Arroja
com.google.android.managementapi.common.exceptions.ApiLevelException

si el nivel de API del dispositivo es inferior a 28

com.google.android.managementapi.environment.exception.EnvironmentNotPreparedException Si falló la llamada. El mensaje y el subtipo de la excepción contienen más detalles sobre la falla.
java.lang.SecurityException

Si el llamador no está autorizado para llamar a esta API.
java.util.concurrent.TimeoutException

Indica si la llamada falló debido a un tiempo de espera agotado.
com.google.android.managementapi.common.exceptions.InternalException

Si la llamada falló debido a un error interno.