DeviceClient

public interface DeviceClient

Klien untuk mengakses API terkait perangkat.

Gunakan DeviceClientFactory untuk membuat instance yang berkomunikasi dengan aplikasi Android Device Policy di perangkat.

Ringkasan

Metode publik
abstract @NonNull ListenableFuture<@NonNull Device>

Mendapatkan sinyal perangkat.
abstract @NonNull Device

Mendapatkan sinyal perangkat.

Metode publik

getDevice

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

Mendapatkan sinyal perangkat.

API ini mengharuskan lingkungan disiapkan sebelum memanggil API ini. Lingkungan dapat diperiksa apakah sudah disiapkan dengan memanggil EnvironmentClient.getEnvironment. Jika belum siap, lingkungan dapat disiapkan dengan memanggil EnvironmentClient.prepareEnvironment.

Catatan: Sinyal yang ditampilkan dapat berbeda-beda bergantung pada pemanggil dan status pengelolaan perangkat.

Hasil
@NonNull ListenableFuture<@NonNull Device>

ListenableFuture yang menggabungkan hasilnya. Hal ini dapat berupa

  • Masa depan yang berhasil menggabungkan Device, jika berhasil.

  • Masa depan yang gagal menggabungkan ApiLevelException jika API level perangkat kurang dari 28.

  • Future yang gagal menggabungkan EnvironmentNotPreparedException, jika panggilan gagal. Pesan dan subjenis pengecualian berisi detail selengkapnya tentang kegagalan.

  • Future yang gagal menggabungkan SecurityException, jika pemanggil tidak diberi otorisasi untuk memanggil API ini.

  • Future yang gagal menggabungkan TimeoutException, jika panggilan gagal karena waktu tunggu habis.

  • Future yang gagal menggabungkan InternalException, jika panggilan gagal karena error internal.

getDeviceAwait

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

Mendapatkan sinyal perangkat.

API ini mengharuskan lingkungan disiapkan sebelum memanggil API ini. Lingkungan dapat diperiksa apakah sudah disiapkan dengan memanggil EnvironmentClient.getEnvironment. Jika belum siap, lingkungan dapat disiapkan dengan memanggil EnvironmentClient.prepareEnvironment.

Catatan: Sinyal yang ditampilkan dapat berbeda-beda bergantung pada pemanggil dan status pengelolaan perangkat.

Hasil
@NonNull Device

Device yang mewakili sinyal perangkat.
Menampilkan
com.google.android.managementapi.common.exceptions.ApiLevelException

jika API level perangkat kurang dari 28.

com.google.android.managementapi.environment.exception.EnvironmentNotPreparedException Jika panggilan gagal. Pesan dan subjenis pengecualian berisi detail selengkapnya tentang kegagalan.
java.lang.SecurityException

Jika pemanggil tidak diberi otorisasi untuk memanggil API ini.
java.util.concurrent.TimeoutException

Jika panggilan gagal karena waktu tunggu habis.
com.google.android.managementapi.common.exceptions.InternalException

Jika panggilan gagal karena error internal.