เริ่มต้นใช้งานการยืนยันหมายเลขโทรศัพท์ด้วย Firebase ใน Android

หน้านี้จะอธิบายวิธีเริ่มต้นใช้งาน Firebase Phone Number Verification ในแอป Android โปรดดู ภาพรวม เพื่อดูคำอธิบายทั่วไปเกี่ยวกับฟีเจอร์นี้

ทำตามขั้นตอนในหน้านี้เพื่อเริ่มต้นใช้งานการติดตั้งใช้งานโฟลว์ของผู้ใช้สำหรับ Firebase PNV ได้อย่างรวดเร็ว โดยคุณจะสร้างโทเค็นสำหรับการทดสอบเท่านั้นซึ่งจะแปลงเป็นหมายเลขโทรศัพท์ปลอมเพื่อวัตถุประสงค์ในการทดสอบ การใช้โทเค็นทดสอบนี้ คุณสามารถเริ่มเพิ่ม Firebase PNV ลงในแอปได้โดยไม่ต้องมีบัญชีสำหรับการเรียกเก็บเงินหรือ อุปกรณ์ที่มีซิมจริง

เมื่อพอใจกับประสบการณ์ของผู้ใช้ Firebase PNV ในแอปแล้ว คุณสามารถ ทำตามขั้นตอนเพิ่มเติมเพื่อนำแอปไปใช้งานจริง

ก่อนเริ่มต้น

• เพิ่ม Firebase ลงในโปรเจ็กต์ Android หากยังไม่ได้ เพิ่ม

• หากต้องการใช้โหมดทดสอบ อุปกรณ์ที่เรียกใช้แอปต้องลงทะเบียนใน โปรแกรมเบต้าสาธารณะของบริการระบบ Google ดูวิธีลงทะเบียนได้ในหน้าเว็บที่เชื่อมโยง

1. เพิ่มไลบรารี Firebase PNV ลงในแอป

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.13.0"))

    // Add the dependencies for the Firebase Phone Number Verification libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-pnv")
}

การใช้ Firebase Android BoM, จะทำให้แอปใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้อยู่เสมอ

dependencies {
    // Add the dependencies for the Firebase Phone Number Verification libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-pnv:16.1.0")
}

2. เริ่มต้นใช้งานไลบรารี Firebase PNV ในโหมดทดสอบ

1. ในคอนโซล Firebase ให้ไปที่แท็บ ความปลอดภัย > การยืนยันทางโทรศัพท์ > การทดสอบ

2. คลิกสร้างโทเค็น

3. ในแอป ให้เริ่มต้นใช้งานไคลเอ็นต์ Firebase PNV เพื่อใช้เซสชันทดสอบโดยทำดังนี้

   Kotlin

   นำเข้าไลบรารี

     import com.google.firebase.pnv.FirebasePhoneNumberVerification
     ```
   
   Create a new instance of the `FirebasePhoneNumberVerification` class and use
   this instance for all Firebase PNV calls.
   
   ```kotlin
     val fpnv = FirebasePhoneNumberVerification.getInstance()
     ```
   
   Enable a test session using the token you generated in the previous step:
   
   ```kotlin
     fpnv.enableTestSession("COPIED_TOKEN_STRING")
     ```
   
   You must call this method only once on an instance of
       `FirebasePhoneNumberVerification`; subsequent calls will throw an error.
   

โทเค็นทดสอบมี TTL 7 วัน หลังจากช่วงเวลานี้ คุณจะต้องสร้างโทเค็นใหม่เพื่อเปิดใช้เซสชันทดสอบ โทเค็นทดสอบใช้งานได้ในอุปกรณ์จริงและโปรแกรมจำลอง ซึ่งเหมาะอย่างยิ่งสำหรับการสร้างต้นแบบ UX ในแอปหรือการทดสอบใน CI/CD

3. แนะนำ: ตรวจสอบการรองรับ Firebase PNV

เราขอแนะนำให้ตรวจสอบว่าอุปกรณ์และซิมการ์ดรองรับ Firebase PNV หรือไม่เมื่อเปิดแอป เพื่อช่วยคุณพิจารณาว่าจะแสดง UI สำหรับป้อนหมายเลขหรือ UI อธิบายเมื่อใด การตรวจสอบนี้เป็นการตรวจสอบเบื้องต้นที่ไม่ต้องได้รับความยินยอมจากผู้ใช้ คุณสามารถใช้ ผลการทดสอบนี้เพื่อตัดสินใจว่าจะเริ่มโฟลว์ Firebase PNV หรือใช้วิธีอื่น ในการยืนยันหมายเลขโทรศัพท์ เช่น SMS

หากต้องการตรวจสอบความเข้ากันได้ของอุปกรณ์ ให้เรียกใช้เมธอด getVerificationSupportInfo() ขณะที่เซสชันทดสอบทำงานอยู่ เมธอดนี้จะแสดงรายการที่มีรายการเดียวสำหรับโทเค็นทดสอบที่ทำงานอยู่ในโปรเจ็กต์ หลังจากนำแอปไปใช้งานจริงแล้ว เมธอดนี้จะแสดงผลลัพธ์สำหรับซิมแต่ละรายการในอุปกรณ์

// Check all SIMs for support.
fpnv.getVerificationSupportInfo()
.addOnSuccessListener { results ->
  if (results.any { it.isSupported() }) {
    // At least one SIM is supported; okay to call getVerifiedPhoneNumber
    // (see the next step).
  } else {
    // No SIMs are supported, so fall back to SMS verification.
  }
}
.addOnFailureListener { e ->
  // Handle error.
}

4. เริ่มโฟลว์การยืนยัน

หากต้องการเริ่มโฟลว์ Firebase PNV ให้เรียกใช้เมธอด getVerifiedPhoneNumber():

fpnv.getVerifiedPhoneNumber(this@MainActivity)
.addOnSuccessListener { result ->
  // In test mode, this phone number will have a valid country code,
  // followed by all zeros.
  val phoneNumber = result.getPhoneNumber()
  val token = result.getToken()

  // Verification successful. Send token to your backend. (See Next Steps.)
}
.addOnFailureListener { e ->
  // Handle failures, such as the user declining consent or a network error.
}

เมธอด getVerifiedPhoneNumber() จะดำเนินการโฟลว์การยืนยันหมายเลขโทรศัพท์ทั้งหมด ซึ่งรวมถึง

• ใช้ Credential Manager ของ Android เพื่อขอความยินยอมของผู้ใช้ในการแชร์หมายเลขโทรศัพท์
• ส่งคำขอไปยังแบ็กเอนด์ Firebase PNV
• แสดงโทเค็นที่มีหมายเลขโทรศัพท์ที่ยืนยันแล้วสำหรับอุปกรณ์ (ในแอปเวอร์ชันที่ใช้งานจริง การเรียกเก็บเงินจะเกิดขึ้นในขั้นตอนนี้)

ขั้นตอนถัดไป

• หน้านี้จะอธิบายรายละเอียดเกี่ยวกับวิธีผสานรวมกับ Firebase PNV โดยใช้ API แบบเรียกครั้งเดียวที่รวมเป็นหนึ่ง การเรียกใช้เมธอดเดียวจะจัดการโฟลว์ผู้ใช้ Firebase PNV ทั้งหมด ตั้งแต่การขอความยินยอมของผู้ใช้ไปจนถึงการเรียกเครือข่ายที่จำเป็นไปยังแบ็กเอนด์ Firebase PNV การใช้เมธอดนี้จะช่วยลดขั้นตอนการผสานรวมเหลือเพียงการเรียกใช้เมธอดเดียว

  เราขอแนะนำ API นี้สำหรับนักพัฒนาแอปส่วนใหญ่ อย่างไรก็ตาม หากคุณมีข้อกำหนดเฉพาะ ที่ไลบรารีไม่รองรับ โปรดดูข้อมูลเกี่ยวกับการติดตั้งใช้งานโฟลว์ที่กำหนดเองได้ในหน้าปรับแต่งFirebase Phone Number Verification โฟลว์

• หากคุณใช้หมายเลขโทรศัพท์ที่ยืนยันแล้วนอกไคลเอ็นต์แอป คุณควรส่งโทเค็นแทนหมายเลขโทรศัพท์เองเพื่อให้ยืนยันความสมบูรณ์ของโทเค็นได้เมื่อใช้งาน ดูยืนยันFirebase PNV โทเค็น

• หลังจากติดตั้งใช้งานและทดสอบโฟลว์ Firebase PNV และการผสานรวมแบ็กเอนด์ ของแอปแล้ว คุณสามารถนำแอปไปใช้งานจริงเพื่อเริ่มรับหมายเลขโทรศัพท์ที่ ยืนยันแล้วจริง ดูอัปเกรดเป็นโหมดเวอร์ชันที่ใช้งานจริง