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 lingkungan belum siap, lingkungan dapat disiapkan dengan memanggil EnvironmentClient.prepareEnvironment.

Catatan: Sinyal yang ditampilkan mungkin berbeda bergantung pada pemanggil dan status pengelolaan perangkat.

Hasil
@NonNull ListenableFuture<@NonNull Device>

ListenableFuture yang membungkus hasilnya. Hal ini dapat berupa

  • Future yang berhasil membungkus Device, jika berhasil.

  • Future yang gagal membungkus ApiLevelException jika level API perangkat kurang dari 28.

  • Kegagalan di masa mendatang yang membungkus EnvironmentNotPreparedException, jika panggilan gagal. Pesan dan subtipe pengecualian berisi detail selengkapnya tentang kegagalan.

  • Kegagalan di masa mendatang yang membungkus SecurityException, jika pemanggil tidak diizinkan untuk memanggil API ini.

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

  • Future yang gagal membungkus 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 lingkungan belum siap, lingkungan dapat disiapkan dengan memanggil EnvironmentClient.prepareEnvironment.

Catatan: Sinyal yang ditampilkan mungkin berbeda bergantung pada pemanggil dan status pengelolaan perangkat.

Hasil
@NonNull Device

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

jika level API perangkat kurang dari 28.

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

Jika pemanggil tidak diizinkan 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.