Menambahkan Firebase Phone Number Verification ke aplikasi Android Anda

1. Ringkasan

Firebase Phone Number Verification (Firebase PNV atau FPNV) adalah metode yang lebih cepat dan lebih aman untuk memverifikasi nomor telepon. Tidak seperti verifikasi berbasis SMS, yang mengharuskan pengguna akhir menerima dan memasukkan kode dari pesan teks, PNV Firebase berfungsi dengan mendapatkan nomor telepon yang ditetapkan ke SIM di perangkat langsung dari operator yang terhubung dengan satu ketukan. Cara ini mengurangi hambatan bagi pengguna akhir, meningkatkan keandalan karena tidak bergantung pada pengiriman pesan SMS, dan menghilangkan jalur penyalahgunaan yang biasanya dieksploitasi saat menggunakan SMS.

Dialog pop-up Firebase PNV

Dalam codelab ini, Anda akan mempelajari cara membangun agen suara AI "Restaurant Finder" yang menggunakan Verifikasi Nomor Telepon Firebase untuk memverifikasi nomor telepon pengguna akhir sebelum mengonfirmasi reservasi meja.

Prasyarat

Versi terbaru Android Studio
Perangkat Android atau emulator dengan Level API 26 atau yang lebih tinggi

Yang akan Anda pelajari

Siapkan project Firebase dengan PNV Firebase.
Gunakan PNV Firebase dalam Mode Pengujian untuk membuat prototipe tanpa akun penagihan atau SIM sungguhan.
Mengintegrasikan Firebase PNV SDK ke dalam aplikasi Android.
Memverifikasi nomor telepon menggunakan API panggilan tunggal.
(Opsional) Siapkan aplikasi Anda untuk produksi.

2. Menyiapkan project contoh

Membuat project Firebase

Login ke Firebase console menggunakan Akun Google Anda.
Klik tombol untuk membuat project baru, lalu masukkan nama project (misalnya, Tera Bites).
Nama project ini digunakan sebagai nama tampilan di antarmuka Firebase, dan Firebase akan otomatis membuat project ID unik berdasarkan nama project ini. Perhatikan bahwa Anda dapat mengklik ikon Edit sekarang untuk menetapkan project ID pilihan Anda, tetapi Anda tidak dapat mengubah ID ini setelah project dibuat.
Klik Lanjutkan.
Jika diminta, tinjau dan setujui persyaratan Firebase, lalu klik Continue.
(Opsional) Aktifkan bantuan AI di Firebase console (disebut "Gemini di Firebase").
Untuk codelab ini, Anda tidak memerlukan Google Analytics, jadi nonaktifkan opsi Google Analytics.
Klik Buat project, tunggu hingga project Anda disediakan, lalu klik Lanjutkan.

Mendownload kode

Jalankan perintah berikut untuk meng-clone kode contoh untuk codelab ini:

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

Buka direktori firebase-pnv-android di Android Studio.

Menghubungkan project Android Anda ke Firebase

Di Firebase console, di bagian tengah halaman ringkasan project, klik ikon Android atau Tambahkan aplikasi untuk meluncurkan alur kerja pembuatan aplikasi.
Di kolom Nama paket Android, masukkan nama paket aplikasi: com.google.firebase.example.fpnv.
Klik Daftarkan aplikasi.
Ikuti petunjuk untuk mendownload file google-services.json, lalu pindahkan ke direktori app/ kode yang baru saja Anda download.
Klik Berikutnya.

Mengaktifkan Firebase AI Logic

Codelab ini menggunakan Firebase AI Logic untuk mendukung agen suara AI. Untuk mengaktifkan Firebase AI Logic di project Firebase Anda:

Di Firebase console, buka AI Services > AI Logic.
Klik Get started.
Pilih untuk menggunakan Gemini Developer API dengan mengklik Mulai menggunakan API ini.
Klik Enable API dan konfirmasi.

3. Menyiapkan PNV Firebase dalam mode pengujian

Mode pengujian memungkinkan Anda memverifikasi nomor telepon "palsu" menggunakan token pengujian untuk pengembangan.

Bergabung dengan program beta publik layanan sistem Google

Daftarkan perangkat pengembangan Anda ke channel beta layanan sistem Google untuk menggunakan mode pengujian:

Buka halaman Pengujian Aplikasi Android - Layanan sistem Google.
Klik Jadi penguji.

Anda kini menjadi penguji beta untuk layanan sistem Google.

Tambahkan dependensi Firebase PNV

Dalam codebase project Android Anda, dependensi untuk library Firebase PNV dan Firebase AI Logic sudah ditentukan dalam file /gradle/versions.toml:

[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" }

Dalam file Gradle modul (level aplikasi) Anda (biasanya /app/build.gradle.kts), deklarasikan dependensi untuk library PNV Firebase:

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

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

  // ...
}

Membuat token pengujian

Di Firebase console, buka Security > Phone Verification.
Pilih tab Pengujian.
Pilih kode negara untuk nomor telepon pengujian Anda, lalu klik Buat token.
Salin string token yang dihasilkan.

Aktifkan sesi pengujian dalam kode Anda

Kembali ke project Android Anda, buka file ChatViewModel.kt, lalu temukan fungsi verifyPhoneNumber().

Lakukan inisialisasi klien FirebasePhoneNumberVerification dan aktifkan sesi pengujian, dengan menempelkan token yang Anda salin dari Firebase console:

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. Menjalankan aplikasi

Setelah Anda menerapkan PNV Firebase, saatnya menjalankan aplikasi.

Di Android Studio, klik Run untuk meluncurkan aplikasi di emulator Android atau di perangkat fisik.
Setelah aplikasi diluncurkan, Anda akan melihat layar yang terlihat seperti ini:
Klik Mulai panggilan, dan perkenalkan diri Anda.
Agen suara AI akan meminta detail reservasi Anda. Setelah Anda memberikan detail, Anda akan diminta untuk melihat layar guna memverifikasi nomor telepon Anda:
Setelah selesai, Anda akan melihat layar verifikasi selesai:
Klik Akhiri sesi untuk mengakhiri panggilan.

5. (Opsional) Upgrade ke mode produksi

Mengupgrade paket harga Firebase Anda

Untuk menggunakan PNV Firebase dalam mode produksi, project Firebase Anda harus menggunakan paket harga bayar sesuai penggunaan (Blaze), yang berarti project tersebut ditautkan ke akun Penagihan Cloud.

Akun Penagihan Cloud memerlukan metode pembayaran, seperti kartu kredit.
Jika Anda baru menggunakan Firebase dan Google Cloud, periksa apakah Anda memenuhi syarat untuk mendapatkan kredit sebesar$300 dan akun Penagihan Cloud Uji Coba Gratis.
Jika Anda melakukan codelab ini sebagai bagian dari acara, tanyakan kepada penyelenggara apakah ada kredit Cloud yang tersedia.

Untuk mengupgrade project Anda ke paket Blaze, ikuti langkah-langkah berikut:

Di Firebase console, pilih upgrade your plan.
Pilih paket Blaze. Ikuti petunjuk di layar untuk menautkan akun Penagihan Cloud ke project Anda.
Jika perlu membuat akun Penagihan Cloud sebagai bagian dari upgrade ini, Anda mungkin perlu kembali ke alur upgrade di Firebase console untuk menyelesaikan upgrade.

Mengaktifkan mode produksi PNV Firebase

Tambahkan sidik jari SHA-256 aplikasi Anda:
1. Di Firebase console, buka halaman Settings > General.
2. Scroll ke bawah ke kartu Your apps, lalu temukan aplikasi Android Anda.
3. Di kolom SHA certificate fingerprints, tambahkan sidik jari SHA-256 Anda. Baca artikel Mengautentikasi Klien untuk mengetahui detail tentang cara mendapatkan sidik jari SHA-256 aplikasi.
Kembali ke Keamanan > Verifikasi Telepon.
Klik Siapkan produksi. Anda akan melihat daftar aplikasi di project yang akan diaktifkan untuk produksi, dan memiliki kesempatan untuk menambahkan aplikasi lain.
Kirimkan aplikasi Anda untuk verifikasi brand OAuth dan peninjauan kebijakan privasi. Google Cloud akan memverifikasi bahwa Anda mengidentifikasi aplikasi dan kebijakan privasinya secara jelas dan akurat.
Untuk memulai peninjauan, klik Lanjutkan di Google Cloud. Proses ini terkadang memerlukan waktu 24 jam atau lebih.
Saat Anda menunggu verifikasi merek, tinjau persyaratan khusus layanan PNV Firebase, yang ditautkan di konsol.
Setelah aplikasi Anda lulus verifikasi merek, centang kotak untuk menyetujui persyaratan khusus layanan, lalu klik Aktifkan.

PNV Firebase kini aktif dalam mode produksi.

Menghapus kode pengujian

Di project Android Anda, hapus baris fpnv.enableTestSession(...).

Memigrasikan Firebase AI Logic untuk menggunakan Vertex AI

Jika Anda menggunakan kredit di akun penagihan, Anda tidak akan dapat menggunakannya dengan Gemini Developer API. Namun, Anda dapat menggunakannya dengan Vertex AI Gemini API.

Di Firebase console, buka AI Services > AI Logic.
Klik Settings.
Di bagian Vertex AI Gemini API, klik Aktifkan.

Di project Android Anda, ubah inisialisasi Firebase AI Logic untuk menggunakan backend Vertex AI, bukan Google AI:

val model = Firebase.ai(
    backend = GenerativeBackend.vertexAI(location = "us-central1")
).liveModel(
    modelName = "gemini-live-2.5-flash-native-audio",
    // ... other configuration
)

6. Selamat!

Anda telah berhasil mengintegrasikan Firebase Phone Number Verification ke dalam aplikasi Android.

Yang telah kita bahas

Menyiapkan project untuk PNV Firebase.
Menggunakan mode pengujian untuk pembuatan prototipe.
Menerapkan API panggilan tunggal Firebase PNV.
Mengupgrade ke mode produksi.

Langkah berikutnya

Pelajari cara menyesuaikan alur PNV Firebase.
Pelajari cara memverifikasi token PNV Firebase.
Periksa harga dan kuota.