Hinweis zur Telefonnummer

Die Phone Number Hint API, eine von den Google Play-Diensten bereitgestellte Bibliothek, bietet eine einfache Möglichkeit, die (SIM-basierten) Telefonnummern eines Nutzers als Hinweis anzuzeigen.

Die Verwendung von Phone Number Hint bietet unter anderem folgende Vorteile:

  • Es sind keine zusätzlichen Berechtigungsanfragen erforderlich.
  • Nutzer müssen die Telefonnummer nicht mehr manuell eingeben.
  • Es ist kein Google-Konto erforderlich.
  • Nicht direkt mit Anmelde- oder Registrierungs-Workflows verknüpft
  • Unterstützung für mehr Android-Versionen als bei Autofill

Funktionsweise

Die Phone Number Hint API verwendet einen PendingIntent, um den Ablauf zu starten. Nachdem der PendingIntent gestartet wurde, wird dem Nutzer eine Benutzeroberfläche mit allen (SIM-basierten) Telefonnummern angezeigt. Der Nutzer kann dann eine Telefonnummer auswählen, die er verwenden möchte, oder den Vorgang abbrechen. Die ausgewählte Telefonnummer wird dann dem Entwickler zur Verfügung gestellt, damit er sie über die Intent abrufen kann.

Benutzeroberfläche und Einstellungen für Telefonnummer-Hinweise.
Abbildung 1. Benutzeroberfläche und Einstellungen für Telefonnummer-Hinweise

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre App vorzubereiten.

Eigene App konfigurieren

Fügen Sie die Abhängigkeit für die Google Play-Dienste für die Phone Number Hint API zur Gradle-Build-Datei Ihres Moduls hinzu, die normalerweise app/build.gradle ist:

  apply plugin: 'com.android.application'

  ...

  dependencies {
    implementation 'com.google.android.gms:play-services-auth:22.0.0'
  }

GetPhoneNumbeHintIntentRequest-Objekt erstellen

Erstellen Sie zuerst ein GetPhoneNumberHintIntentRequest-Objekt mit der bereitgestellten Methode GetPhoneNumberHintIntentRequest.Builder(). Mit diesem Anfrageobjekt kann dann ein Intent abgerufen werden, um den Ablauf für Telefonnummernvorschläge zu starten.

Kotlin

val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()

Java

GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();

Hinweis zur Telefonnummer wird angefordert

Rufe SignInClient.getPhoneNumberHintIntent() auf und übergib das vorherige GetPhoneNumberHintIntentRequest-Objekt, um den PendingIntent abzurufen und den Ablauf für den Hinweis auf die Telefonnummer zu starten.

Kotlin

val phoneNumberHintIntentResultLauncher = ...

Identity.getSignInClient(activity)
  .getPhoneNumberHintIntent(request)
  .addOnSuccessListener { result: PendingIntent ->
    try {
      phoneNumberHintIntentResultLauncher.launch(
        IntentSenderRequest.Builder(result).build()
      )
    } catch (e: Exception) {
        Log.e(TAG, "Launching the PendingIntent failed")
    }
  }
  .addOnFailureListener {
      Log.e(TAG, "Phone Number Hint failed")
  }

Java

ActivityResultLauncher<Intent> phoneNumberHintIntentResultLauncher = ...

Identity.getSignInClient(activity)
    .getPhoneNumberHintIntent(request)
    .addOnSuccessListener( result -> {
        try {
            phoneNumberHintIntentResultLauncher.launch(result.getIntentSender());
        } catch(Exception e) {
            Log.e(TAG, "Launching the PendingIntent failed", e);
        }
    })
    .addOnFailureListener(e -> {
        Log.e(TAG, "Phone Number Hint failed", e);
    });

Telefonnummer wird abgerufen

Übergeben Sie die Intent an SignInClient.getPhoneNumberFromIntent, um die Telefonnummer abzurufen.

Kotlin

val phoneNumberHintIntentResultLauncher =
  registerForActivityResult(ActivityResultContracts.StartIntentSenderForResult()) { result ->
        try {
            val phoneNumber = Identity.getSignInClient(activity).getPhoneNumberFromIntent(result.data)
        } catch(e: Exception) {
            Log.e(TAG, "Phone Number Hint failed")
        }
    }

Java

ActivityResultLauncher<Intent> phoneNumberHintIntentResultLauncher =
    registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        new ActivityResultCallback<ActivityResult>() {
            @Override
            public void onActivityResult(ActivityResult result) {
                try {
                    String phoneNumber = Identity.getSignInClient(activity).getPhoneNumberFromIntent(result.getData());
                } catch {
                    Log.e(TAG, "Phone Number Hint failed", e);
                }
            }
    });