DeviceClient

public interface DeviceClient

Client für den Zugriff auf gerätebezogene APIs.

Verwenden Sie DeviceClientFactory, um eine Instanz zu erstellen, die mit der Android Device Policy App auf dem Gerät kommuniziert.

Zusammenfassung

Öffentliche Methoden
abstract @NonNull ListenableFuture<@NonNull Device>

Ruft die Gerätesignale ab.
abstract @NonNull Device

Ruft die Gerätesignale ab.

Öffentliche Methoden

getDevice

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

Ruft die Gerätesignale ab.

Für diese API muss die Umgebung vorbereitet werden, bevor sie aufgerufen werden kann. Mit EnvironmentClient.getEnvironment können Sie prüfen, ob die Umgebung bereits vorbereitet ist. Wenn die Umgebung nicht vorbereitet ist, können Sie sie mit EnvironmentClient.prepareEnvironment vorbereiten.

Hinweis: Die zurückgegebenen Signale können je nach Anrufer und Status der Geräteverwaltung variieren.

Ausgabe
@NonNull ListenableFuture<@NonNull Device>

Ein ListenableFuture, das das Ergebnis umschließt. Das kann

  • Ein erfolgreicher Vorgang, der eine Device umschließt, falls der Vorgang erfolgreich war.

  • Ein fehlgeschlagenes Future-Objekt, das eine ApiLevelException umschließt, wenn die API-Ebene des Geräts unter 28 liegt.

  • Ein fehlgeschlagener Future, der eine EnvironmentNotPreparedException umschließt, wenn der Aufruf fehlgeschlagen ist. Die Meldung und der Untertyp der Ausnahme enthalten weitere Informationen zum Fehler.

  • Ein fehlgeschlagener Future, der eine SecurityException umschließt, wenn der Aufrufer nicht berechtigt ist, diese API aufzurufen.

  • Ein fehlgeschlagener Future, der eine TimeoutException umschließt, wenn der Aufruf aufgrund einer Zeitüberschreitung fehlgeschlagen ist.

  • Ein fehlgeschlagener Future, der eine InternalException umschließt, wenn der Aufruf aufgrund eines internen Fehlers fehlgeschlagen ist.

getDeviceAwait

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

Ruft die Gerätesignale ab.

Für diese API muss die Umgebung vorbereitet werden, bevor sie aufgerufen werden kann. Mit EnvironmentClient.getEnvironment können Sie prüfen, ob die Umgebung bereits vorbereitet ist. Wenn die Umgebung nicht vorbereitet ist, können Sie sie mit EnvironmentClient.prepareEnvironment vorbereiten.

Hinweis: Die zurückgegebenen Signale können je nach Anrufer und Status der Geräteverwaltung variieren.

Ausgabe
@NonNull Device

Device, die die Gerätesignale darstellen.
Löst
com.google.android.managementapi.common.exceptions.ApiLevelException

wenn die Geräte-API-Ebene unter 28 liegt.

com.google.android.managementapi.environment.exception.EnvironmentNotPreparedException Wenn der Anruf fehlgeschlagen ist. Die Meldung und der Untertyp der Ausnahme enthalten weitere Informationen zum Fehler.
java.lang.SecurityException

Wenn der Aufrufer nicht berechtigt ist, diese API aufzurufen.
java.util.concurrent.TimeoutException

Wenn der Anruf aufgrund eines Zeitlimits fehlgeschlagen ist.
com.google.android.managementapi.common.exceptions.InternalException

Wenn der Aufruf aufgrund eines internen Fehlers fehlgeschlagen ist.