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.
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);
}
}
});