Bestätigung der Telefonnummer von Firebase zu Ihrer Android-App hinzufügen

1. Übersicht

Die Bestätigung der Telefonnummer in Firebase (Firebase Phone Number Verification, FPNV) ist eine schnellere und sicherere Methode zur Bestätigung von Telefonnummern. Im Gegensatz zur SMS-basierten Bestätigung, bei der Endnutzer einen Code aus einer Nachricht erhalten und eingeben müssen, wird bei der Bestätigung der Telefonnummer in Firebase die Telefonnummer, die der SIM-Karte im Gerät zugewiesen ist, mit nur einem Tippen direkt vom verbundenen Mobilfunkanbieter abgerufen. Dadurch wird die Nutzung für den Endnutzer vereinfacht, die Zuverlässigkeit verbessert, da keine SMS-Zustellung erforderlich ist, und Missbrauchsmöglichkeiten, die bei der Verwendung von SMS häufig ausgenutzt werden, werden eliminiert.

Pop-up-Dialogfeld für PNV in Firebase

In diesem Codelab erfahren Sie, wie Sie einen KI-Sprachagenten für die Restaurantsuche erstellen, der die Telefonnummer des Endnutzers mit der Firebase-Telefonnummerüberprüfung bestätigt, bevor eine Tischreservierung bestätigt wird.

Vorbereitung

  • Neueste Version von Android Studio
  • Android-Gerät oder ‑Emulator mit API‑Level 26 oder höher

Lerninhalte

  • Ein Firebase-Projekt mit Firebase PNV einrichten
  • Verwenden Sie Firebase PNV im Testmodus, um Prototypen ohne Rechnungskonto oder echte SIM-Karte zu erstellen.
  • Binden Sie das Firebase PNV SDK in eine Android-App ein.
  • Telefonnummer mit der Single-Call API bestätigen
  • Optional: Bereiten Sie Ihre App für die Produktion vor.

2. Beispielprojekt einrichten

Firebase-Projekt erstellen

  1. Melden Sie sich mit Ihrem Google-Konto in der Firebase Console an.
  2. Klicken Sie auf die Schaltfläche, um ein neues Projekt zu erstellen, und geben Sie dann einen Projektnamen ein (z. B. Tera Bites).
  3. Klicken Sie auf Weiter.
  4. Lesen und akzeptieren Sie bei Aufforderung die Firebase-Nutzungsbedingungen und klicken Sie dann auf Weiter.
  5. (Optional) Aktivieren Sie die KI-Unterstützung in der Firebase Console (als „Gemini in Firebase“ bezeichnet).
  6. Für dieses Codelab benötigen Sie kein Google Analytics. Deaktivieren Sie daher die Google Analytics-Option.
  7. Klicken Sie auf Projekt erstellen, warten Sie, bis Ihr Projekt bereitgestellt wurde, und klicken Sie dann auf Weiter.

Code herunterladen

Führen Sie die folgenden Befehle aus, um den Beispielcode für dieses Codelab zu klonen:

git clone https://github.com/GoogleCloudPlatform/devrel-demos
cd codelabs/firebase-pnv-android

Öffnen Sie das Verzeichnis firebase-pnv-android in Android Studio.

Android-Projekt mit Firebase verbinden

  1. Klicken Sie in der Firebase Console in der Mitte der Projektübersichtsseite auf das Android-Symbol oder auf App hinzufügen, um den Workflow zum Erstellen von Apps zu starten.
  2. Geben Sie im Feld Android-Paketname den Paketnamen der App ein: com.google.firebase.example.fpnv.
  3. Klicken Sie auf App registrieren.
  4. Folgen Sie der Anleitung zum Herunterladen der Datei google-services.json und verschieben Sie sie in das Verzeichnis app/ des gerade heruntergeladenen Codes.
  5. Klicken Sie auf Weiter.

Firebase AI Logic aktivieren

In diesem Codelab wird Firebase AI Logic verwendet, um den KI-Sprachagenten zu unterstützen. So aktivieren Sie Firebase AI Logic in Ihrem Firebase-Projekt:

  1. Rufen Sie in der Firebase Console AI Services > AI Logic auf.
  2. Klicken Sie auf Jetzt starten.
  3. Klicken Sie auf Erste Schritte mit dieser API, um die Gemini Developer API zu verwenden.
  4. Klicken Sie auf API aktivieren und bestätigen Sie die Aktion.

3. Firebase-PNV im Testmodus einrichten

Im Testmodus können Sie eine „falsche“ Telefonnummer mit einem Testtoken für die Entwicklung bestätigen.

Am öffentlichen Betaprogramm für Google-Systemdienste teilnehmen

Registrieren Sie Ihr Entwicklungsgerät im Beta-Channel für Google-Systemdienste, um den Testmodus zu verwenden:

  1. Rufen Sie die Seite Android App Testing – Google-Systemdienste auf.
  2. Klicken Sie auf Tester werden.

Sie sind jetzt Betatester für Google-Systemdienste.

Firebase PNV-Abhängigkeit hinzufügen

In der Codebasis Ihres Android-Projekts sind die Abhängigkeiten für die Firebase PNV- und Firebase AI Logic-Bibliotheken bereits in der Datei /gradle/versions.toml definiert:

[versions]
# ... other dependencies
firebaseBom = "34.12.0"

[libraries]
# ... other libraries
firebase-bom = { module = "com.google.firebase:firebase-bom", version.ref = "firebaseBom" }
firebase-ai-logic = { module = "com.google.firebase:firebase-ai" }
firebase-pnv = { module = "com.google.firebase:firebase-pnv" }

Deklarieren Sie die Abhängigkeit für die Firebase PNV-Bibliothek in der Gradle-Datei Ihres Moduls (auf App-Ebene, in der Regel /app/build.gradle.kts):

dependencies {
  // ... other dependencies
  implementation(platform(libs.firebase.bom))
  implementation(libs.firebase.ai.logic)

  // Add this line
  implementation(libs.firebase.pnv)

  // ...
}

Testtoken generieren

  1. Rufen Sie in der Firebase Console Sicherheit > Telefonbestätigung auf.
  2. Wählen Sie den Tab Testen aus.
  3. Wählen Sie den Ländercode für Ihre Testtelefonnummer aus und klicken Sie auf Token generieren.
  4. Kopieren Sie den generierten Tokenstring.

Testsitzung in Ihrem Code aktivieren

  1. Öffnen Sie in Ihrem Android-Projekt die Datei ChatViewModel.kt und suchen Sie nach der Funktion verifyPhoneNumber().
  2. Initialisieren Sie den FirebasePhoneNumberVerification-Client und aktivieren Sie die Testsitzung. Fügen Sie dazu das Token ein, das Sie aus der Firebase Console kopiert haben:
    suspend fun verifyPhoneNumber(): String {
    // Initialize Firebase Phone Number Verification
    val fpnv = FirebasePhoneNumberVerification.getInstance(context!!)

    // Enable Test session
    fpnv.enableTestSession("PASTE_THE_TOKEN_YOU_COPIED_IN_PREV_STEP")

    // Trigger the Firebase PNV pop up
    val response = fpnv.getVerifiedPhoneNumber().await()
    val phoneNumber = response.getPhoneNumber()

    return phoneNumber
}

4. Anwendung ausführen

Nachdem Sie Firebase PNV implementiert haben, können Sie die App ausführen.

  1. Klicken Sie in Android Studio auf Run, um die App im Android-Emulator oder auf einem physischen Gerät zu starten.
  2. Nach dem Start der App sollte ein Bildschirm wie dieser angezeigt werden:
    Firebase PNV-App wird ausgeführt
  3. Klicken Sie auf Anruf starten und stellen Sie sich vor.
    Firebase PNV-App wird ausgeführt
  4. Der KI-Sprachagent sollte Sie nach Reservierungsdetails fragen. Nachdem Sie die Details angegeben haben, werden Sie aufgefordert, auf das Display zu schauen, um Ihre Telefonnummer zu bestätigen:
    Firebase PNV-App wird ausgeführt
  5. Danach wird der Bildschirm „Bestätigung abgeschlossen“ angezeigt:
    Firebase PNV-App wird ausgeführt
  6. Klicken Sie auf Sitzung beenden, um den Anruf zu beenden.

5. (Optional) Auf den Produktionsmodus upgraden

Firebase-Preismodell upgraden

Wenn Sie Firebase PNV im Produktionsmodus verwenden möchten, muss für Ihr Firebase-Projekt der Blaze-Tarif (Pay as you go) aktiviert sein. Das bedeutet, dass es mit einem Cloud-Rechnungskonto verknüpft ist.

  • Für ein Cloud-Rechnungskonto ist eine Zahlungsmethode wie eine Kreditkarte erforderlich.
  • Wenn Sie neu bei Firebase und Google Cloud sind, können Sie prüfen, ob Sie Anspruch auf ein Guthaben von 300$und ein Cloud-Rechnungskonto für den kostenlosen Testzeitraum haben.
  • Wenn Sie dieses Codelab im Rahmen einer Veranstaltung durchführen, fragen Sie den Organisator, ob Cloud-Guthaben verfügbar ist.

So führen Sie ein Upgrade Ihres Projekts auf den Blaze-Tarif durch:

  1. Wählen Sie in der Firebase Console die Option zum Aktualisieren Ihres Abos aus.
  2. Wählen Sie den Blaze-Tarif aus. Folgen Sie der Anleitung auf dem Bildschirm, um ein Cloud-Rechnungskonto mit Ihrem Projekt zu verknüpfen.
    Wenn Sie im Rahmen dieses Upgrades ein Cloud-Rechnungskonto erstellen mussten, müssen Sie möglicherweise zur Firebase-Konsole zurückkehren, um das Upgrade abzuschließen.

Firebase PNV-Produktionsmodus aktivieren

  1. Fügen Sie den SHA-256-Fingerabdruck Ihrer App hinzu:
    1. Rufen Sie in der Firebase Console die Seite Einstellungen > Allgemein auf.
    2. Scrollen Sie nach unten zur Karte Meine Apps und suchen Sie Ihre Android-App.
    3. Fügen Sie im Feld Fingerabdrücke für SHA-Zertifikat Ihren SHA‑256-Fingerabdruck hinzu. Weitere Informationen zum Abrufen des SHA‑256-Fingerabdrucks Ihrer App finden Sie unter Client authentifizieren.
  2. Kehren Sie zu Sicherheit > Telefonbestätigung zurück.
  3. Klicken Sie auf Produktion einrichten. Sie sehen eine Liste der Apps in Ihrem Projekt, die für die Produktion aktiviert werden, und können weitere Apps hinzufügen.
  4. Reichen Sie Ihre App zur OAuth-Markenüberprüfung und zur Richtlinienüberprüfung der Datenschutzerklärung ein. Google Cloud prüft, ob Sie Ihre App und ihre Datenschutzerklärung klar und korrekt identifizieren.
    Klicken Sie auf In Google Cloud fortfahren, um die Überprüfung zu starten. Dieser Vorgang kann manchmal 24 Stunden oder länger dauern.
  5. Während Sie auf die Markenüberprüfung warten, sollten Sie sich die dienstspezifischen Nutzungsbedingungen für den Firebase PNV-Dienst ansehen, die in der Console verlinkt sind.
  6. Nachdem Ihre App die Markenüberprüfung bestanden hat, setzen Sie ein Häkchen, um die dienstspezifischen Nutzungsbedingungen zu bestätigen, und klicken Sie dann auf Aktivieren.

Firebase PNV ist jetzt im Produktionsmodus aktiv.

Testcode entfernen

Löschen Sie in Ihrem Android-Projekt die Zeile fpnv.enableTestSession(...).

Firebase AI Logic zur Verwendung von Vertex AI migrieren

Wenn Sie Guthaben in Ihrem Rechnungskonto verwenden, können Sie es nicht mit der Gemini Developer API nutzen. Sie können sie jedoch mit der Vertex AI Gemini API verwenden.

  1. Rufen Sie in der Firebase Console AI Services > AI Logic auf.
  2. Klicken Sie auf Einstellungen.
  3. Klicken Sie unter Vertex AI Gemini API auf Aktivieren.
  4. Ändern Sie in Ihrem Android-Projekt die Initialisierung von Firebase AI Logic so, dass das Vertex AI-Backend anstelle von Google AI verwendet wird:
    val model = Firebase.ai(
    backend = GenerativeBackend.vertexAI(location = "us-central1")
).liveModel(
    modelName = "gemini-live-2.5-flash-native-audio",
    // ... other configuration
)

6. Glückwunsch!

Sie haben die Bestätigung der Telefonnummer in Firebase erfolgreich in eine Android-App eingebunden.

Behandelte Themen

  • Ein Projekt für Firebase PNV einrichten
  • Testmodus für Prototyping verwenden
  • Implementieren Sie die Firebase PNV Single-Call API.
  • Upgrade auf den Produktionsmodus

Nächste Schritte