Phone Number Hint API ซึ่งเป็นไลบรารีที่ขับเคลื่อนโดยบริการ Google Play ช่วยให้แสดงหมายเลขโทรศัพท์ (ที่อิงตามซิม) ของผู้ใช้เป็นคำแนะนำได้อย่างราบรื่น
ประโยชน์ของการใช้คำแนะนำหมายเลขโทรศัพท์มีดังนี้
- ไม่จำเป็นต้องส่งคำขอสิทธิ์เพิ่มเติม
- ช่วยให้ผู้ใช้ไม่ต้องพิมพ์หมายเลขโทรศัพท์ด้วยตนเอง
- ไม่จำเป็นต้องมีบัญชี Google
- ไม่เชื่อมโยงกับเวิร์กโฟลว์การลงชื่อเข้าใช้หรือลงชื่อสมัครใช้โดยตรง
- รองรับ Android เวอร์ชันต่างๆ ได้มากกว่าเมื่อเทียบกับการป้อนข้อความอัตโนมัติ
วิธีการทำงาน
Phone Number Hint API ใช้ PendingIntent เพื่อเริ่มขั้นตอน เมื่อเปิดใช้งาน PendingIntent แล้ว ผู้ใช้จะเห็น UI ที่แสดงหมายเลขโทรศัพท์ (ที่อิงตามซิม) ทั้งหมด จากนั้นผู้ใช้จะเลือกหมายเลขโทรศัพท์ที่ต้องการใช้หรือยกเลิกขั้นตอนได้
จากนั้นหมายเลขโทรศัพท์ที่เลือกจะพร้อมให้นักพัฒนาแอปดึงข้อมูลจาก Intent
หากต้องการเตรียมแอป ให้ทำตามขั้นตอนในส่วนต่อไปนี้
กำหนดค่าแอป
เพิ่มทรัพยากร Dependency ของบริการ Google Play สำหรับ Phone Number Hint API ลงในไฟล์บิลด์ Gradle ของโมดูล ซึ่งโดยทั่วไปคือ app/build.gradle
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-auth:22.0.0'
}
สร้างออบเจ็กต์ 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 = ...
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);
});
กำลังดึงข้อมูลหมายเลขโทรศัพท์
ส่ง Intent ไปยัง SignInClient.getPhoneNumberFromIntent เพื่อดึงข้อมูลหมายเลขโทรศัพท์
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);
}
}
});