Phone Number Hint API ซึ่งเป็นไลบรารีที่ขับเคลื่อนโดยบริการ Google Play มีวิธีแสดงหมายเลขโทรศัพท์ของผู้ใช้ (ตามซิม) เพื่อเป็นคําแนะนํา
ประโยชน์ของการใช้คําแนะนําหมายเลขโทรศัพท์มีดังนี้
- ไม่ต้องใช้คําขอสิทธิ์เพิ่มเติม
- ไม่จําเป็นต้องพิมพ์หมายเลขโทรศัพท์ด้วยตนเอง
- ไม่ต้องใช้บัญชี Google
- ไม่ได้เชื่อมโยงกับเวิร์กโฟลว์การลงชื่อเข้าใช้/ลงชื่อสมัครใช้โดยตรง
- การสนับสนุนที่กว้างขึ้นสําหรับ Android เวอร์ชันต่างๆ เมื่อเทียบกับการป้อนข้อความอัตโนมัติ
ข้อควรทราบก่อนที่จะเริ่มต้น
ทําตามขั้นตอนต่อไปนี้เพื่อเตรียมแอป
กําหนดค่าแอป
ในไฟล์ build.gradle
ระดับโปรเจ็กต์ ให้รวม Google's Maven
repository ทั้งในส่วน buildscript
และ allprojects
:
buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
เพิ่มทรัพยากร Dependency สําหรับหมายเลขโทรศัพท์ใน Google Play ไปยังไฟล์บิลด์ของ Gradle โมดูล ซึ่งโดยทั่วไปจะเป็น app/build.gradle
ดังนี้
dependencies {
implementation 'com.google.android.gms:play-services-auth:20.2.0'
}
วิธีการทำงาน
โดย Numbers API ของหมายเลขโทรศัพท์จะใช้ PendingIntent
เพื่อเริ่มขั้นตอน เมื่อเปิด PendingIntent แล้ว
ผู้ใช้จะเห็น UI โดยระบุหมายเลขโทรศัพท์ทั้งหมด (ตามซิม) จากนั้นผู้ใช้จะเลือกหมายเลขโทรศัพท์ที่ต้องการใช้หรือยกเลิกขั้นตอนดังกล่าวได้
หมายเลขโทรศัพท์ที่เลือกจะเปิดให้นักพัฒนาแอปดึงข้อมูลได้จาก Intent

สร้างออบเจ็กต์ GetPhoneNumbeHintIntentRequest
เริ่มต้นด้วยการสร้างออบเจ็กต์ GetPhoneNumberHintIntentRequest
โดยใช้เมธอด GetPhoneNumberHintIntentRequest.Builder()
ที่ให้ไว้ จากนั้นจะใช้ออบเจ็กต์คําขอนี้เพื่อรับ Intent
เพื่อเริ่มโฟลว์คําแนะนําหมายเลขโทรศัพท์ได้
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
ขอคําแนะนําเกี่ยวกับหมายเลขโทรศัพท์
เรียกใช้ SignInClient.getPhoneNumberHintIntent()
เพื่อส่งผ่านในออบเจ็กต์ GetPhoneNumberHintIntentRequest
ก่อนหน้านี้เพื่อเรียก PendingIntent
เพื่อเริ่มขั้นตอนแนะนําหมายเลขโทรศัพท์
Kotlin
val phoneNumberHintIntentResultLauncher: ActivityResultLauncher = ... Identity.signInClient(activity) .getPhoneNumberHintIntent(request) .addOnSuccessListener( try { phoneNumberHintIntentResultLauncher.launch(request.getIntentSender()) } catch(e: Exception) { Log.e(TAG, “Launching the PendingIntent failed”) }) .addOnFailureListener( Log.e(TAG, “Phone Number Hint failed”) )
Java
ActivityResultLauncherphoneNumberHintIntentResultLauncher = ... 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); });
กําลังเรียกดูหมายเลขโทรศัพท์
ส่งใน Intent
ไปยัง SignInClient.getPhoneNumberFromIntent
เพื่อเรียกข้อมูลหมายเลขโทรศัพท์
Kotlin
val phoneNumberHintIntentResultLauncher: ActivityResultLauncher = registerForActivityResult(StartActivityForResult()) { result -> try { val phoneNumber = Identity.signInClient(activity).getPhoneNumberFromIntent(result.data) } catch(e: Exception) { Log.e(TAG, "Phone Number Hint failed") } }
Java
ActivityResultLauncherphoneNumberHintIntentResultLauncher = registerForActivityResult( new ActivityResultContracts.StartActivityForResult(), new ActivityResultCallback () { @Override public void onActivityResult(ActivityResult result) { try { String phoneNumber = Identity.getSignInClient(activity).getPhoneNumberFromIntent(result.getData()); } catch { Log.e(TAG, “Phone Number Hint failed”, e); } } });