คำขอเรียกดูข้อมูลเข้าสู่ระบบของผู้ใช้อาจล้มเหลวเมื่อผู้ใช้ยังไม่ได้บันทึกข้อมูลเข้าสู่ระบบหรือเมื่อผู้ใช้ยังไม่ได้ลงชื่อสมัครใช้แอปของคุณ ในสถานการณ์เช่นนี้ ให้ใช้ API ข้อมูลเข้าสู่ระบบเพื่อเรียกข้อมูลคำแนะนำในการลงชื่อเข้าใช้ เช่น ชื่อและอีเมลของผู้ใช้ ใช้คำแนะนำเหล่านี้เพื่อกรอกแบบฟอร์มลงชื่อเข้าใช้และลงชื่อสมัครใช้ของแอปไว้ล่วงหน้า ทำให้ขั้นตอนการเริ่มต้นใช้งานของแอปเร็วขึ้น
ใน Android 6.0 (Marshmallow) ขึ้นไป แอปของคุณไม่จำเป็นต้องขอสิทธิ์ในอุปกรณ์หรือรันไทม์ใดๆ เพื่อดึงคำแนะนำในการลงชื่อเข้าใช้ด้วย API ข้อมูลรับรอง
ก่อนเริ่มต้น
กำหนดค่าโปรเจ็กต์ Android Studio
เรียกข้อมูลคำแนะนำในการลงชื่อเข้าใช้
หากต้องการเรียกข้อมูลคำแนะนำในการลงชื่อเข้าใช้ ให้กำหนดค่ากล่องโต้ตอบตัวเลือกคำแนะนำก่อนโดยสร้างออบเจ็กต์ HintRequest จากนั้นส่งออบเจ็กต์ HintRequest ไปยัง CredentialsClient.getHintPickerIntent() เพื่อรับ Intent เพื่อแจ้งให้ผู้ใช้เลือกอีเมล สุดท้าย ให้เริ่มต้น Intent ด้วย startIntentSenderForResult()
HintRequest hintRequest = new HintRequest.Builder()
.setHintPickerConfig(new CredentialPickerConfig.Builder()
.setShowCancelButton(true)
.build())
.setEmailAddressIdentifierSupported(true)
.setAccountTypes(IdentityProviders.GOOGLE)
.build();
PendingIntent intent = mCredentialsClient.getHintPickerIntent(hintRequest);
try {
startIntentSenderForResult(intent.getIntentSender(), RC_HINT, null, 0, 0, 0);
} catch (IntentSender.SendIntentException e) {
Log.e(TAG, "Could not start hint picker Intent", e);
}
ผู้ใช้จะได้รับแจ้งให้เลือกอีเมลที่จะใช้
จากนั้นในเมธอด onActivityResult() ของกิจกรรม ให้รับคำแนะนำจากพาร์เซล Credential.EXTRA_KEY ตรวจสอบว่าผู้ใช้อยู่ในฐานข้อมูลผู้ใช้หรือไม่ และเริ่มกิจกรรมที่เหมาะสมด้วยคำแนะนำข้อมูลเข้าสู่ระบบ
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == RC_HINT) {
if (resultCode == RESULT_OK) {
Credential credential = data.getParcelableExtra(Credential.EXTRA_KEY);
Intent intent;
// Check for the user ID in your user database.
if (userDatabaseContains(credential.getId())) {
intent = new Intent(this, SignInActivity.class);
} else {
intent = new Intent(this, SignUpNewUserActivity.class);
}
intent.putExtra("com.mycompany.myapp.SIGNIN_HINTS", credential);
startActivity(intent);
} else {
Log.e(TAG, "Hint Read: NOT OK");
Toast.makeText(this, "Hint Read Failed", Toast.LENGTH_SHORT).show();
}
}
...
}
กรอกแบบฟอร์มลงชื่อเข้าใช้ล่วงหน้า
หากผู้ใช้อยู่ในฐานข้อมูลผู้ใช้และคุณได้เริ่มกิจกรรมการลงชื่อเข้าใช้ของแอป คุณสามารถตรวจสอบได้ว่าออบเจ็กต์ Credential มีโทเค็นรหัสหรือไม่ (ไม่บังคับ) หากใช่ คุณจะลงชื่อเข้าใช้ผู้ใช้ด้วยโทเค็นรหัสได้โดยที่ผู้ใช้ไม่ต้องพิมพ์รหัสผ่าน
หากออบเจ็กต์ Credential ไม่มีโทเค็นรหัส (หรือคุณไม่ต้องการใช้โทเค็นรหัส) ให้เติมคำแนะนำที่คุณเพิ่มไปยัง Intent ในช่องลงชื่อเข้าใช้ล่วงหน้า
public class SignInActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Intent intent = getIntent();
Credential credential = intent.getParcelableExtra("com.mycompany.myapp.SIGNIN_HINTS");
// Pre-fill ID field
mUsernameView.setText(credential.getId());
...
}
...
}
กรอกแบบฟอร์มลงชื่อสมัครใช้ล่วงหน้า
หากผู้ใช้ไม่อยู่ในฐานข้อมูลผู้ใช้และคุณเริ่มกิจกรรมการลงชื่อสมัครใช้ของแอปแล้ว ให้กรอกข้อมูลในช่องลงชื่อสมัครใช้ล่วงหน้าด้วยคำแนะนำในการลงชื่อเข้าใช้ที่คุณเพิ่มไว้ใน Intent
public class SignUpNewUserActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Intent intent = getIntent();
Credential credential = intent.getParcelableExtra("com.mycompany.myapp.SIGNIN_HINTS");
// Pre-fill sign-up fields
mUsernameView.setText(credential.getId());
mDisplaynameView.setText(credential.getName()); // Might be null.
...
}
...
}
นอกจากนี้ คุณยังตรวจสอบได้ด้วยว่าออบเจ็กต์ Credential มีโทเค็นรหัสที่มีอีเมลที่ยืนยันแล้วหรือไม่ หากเป็นเช่นนั้น คุณข้ามขั้นตอนการยืนยันอีเมลของแอปได้เลย เนื่องจากอีเมลได้รับการยืนยันโดย Google แล้ว