AccountSetupClient

Kotlin |Java

interface AccountSetupClient

---

Cihazda yönetilen hesabın kurulumunu yönetmek için kullanılan istemci.

Yaşam Döngüsü Entegrasyonu Şartı: Bu istemci, launchAuthenticationActivity gibi işlemlerin gerektirdiği sonuç geri çağırmalarını doğru şekilde işlemek için AndroidX Activity Result API'lerini kullanır. Arayan, bu istemciyi Android bileşeninin yaşam döngüsüyle (Etkinlik veya Parça) aşağıdaki yöntemlerle entegre etmelidir:

1. getLifecycleObserver kullanarak gözlemciyi alma.

2. Bu gözlemciyi, genellikle onCreate içinde olmak üzere, barındırıcı Etkinliğin veya Parçanın Lifecycle ile kaydetme (ör. lifecycle.addObserver(client.lifecycleObserver)).

Durum güncellemeleri: Asenkron hesap kurulumu durum değişiklikleri hakkında bildirim almak için arama uygulamasının şunları yapması gerekir:

1. AccountSetupListener arayüzünü uygulayın.

2. Alınan durum güncellemelerini işleme için bir uygulama sağlayın.

3. NotificationReceiverService'i genişletin ve bir AccountSetupListener örneği sağlayın.

4. Genişletilmiş NotificationReceiverService sınıfını AndroidManifest.xml dosyanıza ekleyin ve dışa aktarıldığından emin olun.

Bu müşterinin bir örneğini oluşturmak için AccountSetupClientFactory öğesini kullanın.

Özet

Herkese açık işlevler
suspend AccountSetupAttempt	cancelAccountSetupAttempt(     cancelAccountSetupAttemptRequest: CancelAccountSetupAttemptRequest ) Belirtilen hesap kurulumu denemesini iptal eder.
ListenableFuture<AccountSetupAttempt>	cancelAccountSetupAttemptFuture(     cancelAccountSetupAttemptRequest: CancelAccountSetupAttemptRequest ) Belirtilen hesap kurulumu denemesini iptal eder.
suspend AccountSetupAttempt	launchAuthenticationActivity(     launchAuthenticationActivityRequest: LaunchAuthenticationActivityRequest ) Kullanıcının kimliğini doğrulamak için Minute Maid etkinliğini başlatır veya hesap cihazda zaten varsa hesap seçiciyi başlatır.
ListenableFuture<AccountSetupAttempt>	launchAuthenticationActivityFuture(     launchAuthenticationActivityRequest: LaunchAuthenticationActivityRequest ) Kullanıcının kimliğini doğrulamak için Minute Maid etkinliğini başlatır veya hesap cihazda zaten varsa hesap seçiciyi başlatır.
suspend List<AccountSetupAttempt>	listAccountSetupAttempts() Tüm hesap kurulumu denemelerini listeler.
ListenableFuture<List<AccountSetupAttempt>>	listAccountSetupAttemptsFuture() Tüm hesap kurulumu denemelerini listeler.
suspend AccountSetupAttempt	startAccountSetup(startAccountSetupRequest: StartAccountSetupRequest) Hesap kurulumunu başlatır.
ListenableFuture<AccountSetupAttempt>	startAccountSetupFuture(     startAccountSetupRequest: StartAccountSetupRequest ) Hesap kurulumunu başlatır.

Herkese açık özellikler
LifecycleObserver	lifecycleObserver Bu istemcinin yaşam döngüsüne bağlı kurulumunu işleyen LifecycleObserver.

Herkese açık işlevler

cancelAccountSetupAttempt

suspend fun cancelAccountSetupAttempt(
    cancelAccountSetupAttemptRequest: CancelAccountSetupAttemptRequest
): AccountSetupAttempt

Belirtilen hesap kurulumu denemesini iptal eder.

Parametreler
cancelAccountSetupAttemptRequest: CancelAccountSetupAttemptRequest	Hesap kurulumu denemesini iptal etme isteği.

İadeler
AccountSetupAttempt	Güncellenen hesap kurulumu denemesi.

cancelAccountSetupAttemptFuture

fun cancelAccountSetupAttemptFuture(
    cancelAccountSetupAttemptRequest: CancelAccountSetupAttemptRequest
): ListenableFuture<AccountSetupAttempt>

Belirtilen hesap kurulumu denemesini iptal eder.

Parametreler
cancelAccountSetupAttemptRequest: CancelAccountSetupAttemptRequest	Hesap kurulumu denemesini iptal etme isteği.

İadeler
ListenableFuture<AccountSetupAttempt>	Sonucu saran bir ListenableFuture. Bu, Güncellenen hesap kurulumu denemesinin başarılı bir şekilde tamamlanması. Hesap kurulumu girişimi bulunamazsa veya zaten nihai durumdaysa (hata veya başarı) gelecekteki başarısızlık.

launchAuthenticationActivity

suspend fun launchAuthenticationActivity(
    launchAuthenticationActivityRequest: LaunchAuthenticationActivityRequest
): AccountSetupAttempt

Kullanıcının kimliğini doğrulamak için Minute Maid etkinliğini başlatır veya hesap cihazda zaten varsa hesap seçiciyi başlatır.

Parametreler
launchAuthenticationActivityRequest: LaunchAuthenticationActivityRequest	Kimlik doğrulama etkinliğini başlatma isteği. İstek, AUTHENTICATION_ACTIVITY_LAUNCH_REQUIRED_INFORMATION durumunda bir hesap kurulumu denemesi içermelidir.

Verdiği hatalar
java.lang.SecurityException	Arayan, cihaz sahibi veya profil sahibi değilse
com.google.android.managementapi.accountsetup.AccountSetupInvalidStateException	Hesap kurulumu denemesi AUTHENTICATION_ACTIVITY_LAUNCH_REQUIRED_INFORMATION durumunda değilse.

launchAuthenticationActivityFuture

fun launchAuthenticationActivityFuture(
    launchAuthenticationActivityRequest: LaunchAuthenticationActivityRequest
): ListenableFuture<AccountSetupAttempt>

Kullanıcının kimliğini doğrulamak için Minute Maid etkinliğini başlatır veya hesap cihazda zaten varsa hesap seçiciyi başlatır.

Parametreler
launchAuthenticationActivityRequest: LaunchAuthenticationActivityRequest	Kimlik doğrulama etkinliğini başlatma isteği. İstek, AUTHENTICATION_ACTIVITY_LAUNCH_REQUIRED_INFORMATION durumunda bir hesap kurulumu denemesi içermelidir.

İadeler

ListenableFuture<AccountSetupAttempt>

Sonucu saran bir ListenableFuture. Bu, Başarı durumunda, hesap kurulumu denemesini IN_PROGRESS durumunda sarmalayan başarılı bir gelecek. A failed future wrapping a SecurityException, if the caller is not a Device Owner or a Profile Owner. Hesap kurulumu denemesi AUTHENTICATION_ACTIVITY_LAUNCH_REQUIRED_INFORMATION durumunda değilse AccountSetupInvalidStateException sarmalayan başarısız bir gelecek.

listAccountSetupAttempts

suspend fun listAccountSetupAttempts(): List<AccountSetupAttempt>

Tüm hesap kurulumu denemelerini listeler. Yalnızca son 20 hesap kurulumu denemesi döndürülür.

İadeler
List<AccountSetupAttempt>	Tüm hesap kurulumu denemelerinin listesi.

listAccountSetupAttemptsFuture

fun listAccountSetupAttemptsFuture(): ListenableFuture<List<AccountSetupAttempt>>

Tüm hesap kurulumu denemelerini listeler. Yalnızca son 20 hesap kurulumu denemesi döndürülür.

İadeler
ListenableFuture<List<AccountSetupAttempt>>	Sonucu saran bir ListenableFuture.

startAccountSetup

suspend fun startAccountSetup(startAccountSetupRequest: StartAccountSetupRequest): AccountSetupAttempt

Hesap kurulumunu başlatır.

NOT: Bu yöntem, android.app.admin.DevicePolicyManager.DELEGATION_APP_RESTRICTIONS kapsamını Android Cihaz Politikası uygulamasına devreder. Böylece, çağıran yönetici adına uygulama kısıtlamalarını yönetebilir. Hesap kurulumu tamamlandıktan sonra Android Device Policy'ye yönelik bu yetki kapsamı kaldırılır.

Parametreler
startAccountSetupRequest: StartAccountSetupRequest	Hesap kurulumunu başlatma isteği.

İadeler
AccountSetupAttempt	Hesap kurulumu denemesi.

Verdiği hatalar
com.google.android.managementapi.environment.exception.EnvironmentNotReadyException	ortam hazırlanmamışsa
com.google.android.managementapi.accountsetup.AccountSetupUnknownException	Hesap kurulumu sırasında bilinmeyen bir hata oluşursa
com.google.android.managementapi.accountsetup.AccountSetupInvalidEnrollmentTokenException	Kayıt jetonu boşsa veya istekte ayarlanmamışsa
com.google.android.managementapi.accountsetup.AccountSetupInvalidAdminComponentException	Yönetici DeviceAdminReceiver bileşeni cihazda etkin bir yönetici değilse
com.google.android.managementapi.accountsetup.AccountSetupInvalidNotificationReceiverComponentException	Bildirim alıcı bileşeni cihazda yoksa

startAccountSetupFuture

fun startAccountSetupFuture(
    startAccountSetupRequest: StartAccountSetupRequest
): ListenableFuture<AccountSetupAttempt>

Hesap kurulumunu başlatır.

NOT: Bu yöntem, android.app.admin.DevicePolicyManager.DELEGATION_APP_RESTRICTIONS kapsamını Android Cihaz Politikası uygulamasına devreder. Böylece, çağıran yönetici adına uygulama kısıtlamalarını yönetebilir. Hesap kurulumu tamamlandıktan sonra Android Device Policy'ye yönelik bu yetki kapsamı kaldırılır.

Parametreler
startAccountSetupRequest: StartAccountSetupRequest	Hesap kurulumunu başlatma isteği.

İadeler

ListenableFuture<AccountSetupAttempt>

Sonucu saran bir ListenableFuture. Bu, Hesap kurulumu denemesinin gelecekteki başarılı sonucu. Ortam hazırlanmamışsa EnvironmentNotReadyException sarmalayan başarısız bir gelecek. Hesap kurulumu sırasında bilinmeyen bir hata oluşursa com.google.android.managementapi.accountsetup.AccountSetupUnknownException sarmalama işlemi başarısız olur. Kayıt jetonu boşsa veya istekte ayarlanmamışsa com.google.android.managementapi.accountsetup.AccountSetupInvalidEnrollmentTokenException sarmalayan başarısız bir gelecek. Yönetici DeviceAdminReceiver bileşeni cihazda etkin bir yönetici değilse com.google.android.managementapi.accountsetup.AccountSetupInvalidAdminComponentException sarmalayan başarısız bir gelecek. Bildirim alıcı bileşeni cihazda yoksa com.google.android.managementapi.accountsetup.AccountSetupInvalidNotificationReceiverComponentException sarmalama işlemi başarısız olur.

Herkese açık özellikler

lifecycleObserver

val lifecycleObserver: LifecycleObserver

Bu istemcinin yaşam döngüsüne bağlı kurulumunu işleyen LifecycleObserver.

Bu gözlemci, bu istemci örneğine ev sahipliği yapan Etkinlik veya Parça'nın Lifecycle ile kaydedilmiş olmalıdır (ör. lifecycle.addObserver(...) genellikle ana makinenin onCreate içinde çağrılır).

Bu gözlemciyi kaydetmek, istemcinin dahili bileşenleri (özellikle launchAuthenticationActivity sonucunu işlemek için gereken androidx.activity.result.ActivityResultLauncher) doğru şekilde başlatmasına olanak tanır. Bu gözlemcinin kaydedilmemesi, kimlik doğrulama etkinliği başlatılmaya çalışıldığında hatalara neden olur.