SMS 인증 코드를 읽으려면 일회성 동의를 요청하세요.

이 페이지에서는 SMS User Consent API를 사용하여 사용자 동의를 요청하는 방법을 설명합니다. 을(를) 사용하여 SMS 확인 메시지 1개를 읽습니다. 사용자가 동의하면 API는 다음을 반환합니다. 메시지 텍스트입니다. 여기에서 인증 코드와 인증 절차를 완료하세요

종속 항목 설치

앱의 build.gradle 파일에 Play 서비스 인증 구성요소를 포함합니다.

implementation 'com.google.android.gms:play-services-auth:17.0.0'
implementation 'com.google.android.gms:play-services-auth-api-phone:17.4.0'

1. 사용자의 전화번호 가져오기

사용자의 전화번호를 모르는 경우 SMS를 시작하기 전에 요청하세요. 확인 절차를 거쳐야 합니다.

비즈니스에 적합한 방식으로 사용자의 전화번호를 있습니다. 다음과 같은 방법을 사용해 보세요. 비밀번호 대용 Smart Lock 힌트 선택기 필수 정보가 아닌 경우 사용자가 전화번호를 입력하도록 지원 사용자 계정을 만듭니다. 힌트 선택기를 사용하는 방법은 다음과 같습니다.

Kotlin

private val CREDENTIAL_PICKER_REQUEST = 1  // Set to an unused request code

// Construct a request for phone numbers and show the picker
private fun requestHint() {
    val hintRequest = HintRequest.Builder()
        .setPhoneNumberIdentifierSupported(true)
        .build()
    val credentialsClient = Credentials.getClient(this)
    val intent = credentialsClient.getHintPickerIntent(hintRequest)
    startIntentSenderForResult(
        intent.intentSender,
        CREDENTIAL_PICKER_REQUEST,
        null, 0, 0, 0
    )
}

public override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    when (requestCode) {
        CREDENTIAL_PICKER_REQUEST ->
            // Obtain the phone number from the result
            if (resultCode == Activity.RESULT_OK && data != null) {
                val credential = data.getParcelableExtra<Credential>(Credential.EXTRA_KEY)
                // credential.getId();  <-- will need to process phone number string
            }
        // ...
    }
}

Java

private static final int CREDENTIAL_PICKER_REQUEST = 1;  // Set to an unused request code

// Construct a request for phone numbers and show the picker
private void requestHint() throws IntentSender.SendIntentException {
    HintRequest hintRequest = new HintRequest.Builder()
            .setPhoneNumberIdentifierSupported(true)
            .build();
    PendingIntent intent = Credentials.getClient(this).getHintPickerIntent(hintRequest);
    startIntentSenderForResult(intent.getIntentSender(),
            RESOLVE_HINT, null, 0, 0, 0);
}

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    switch (requestCode) {
        case CREDENTIAL_PICKER_REQUEST:
            // Obtain the phone number from the result
            if (resultCode == RESULT_OK) {
                Credential credential = data.getParcelableExtra(Credential.EXTRA_KEY);
                // credential.getId();  <-- will need to process phone number string
            }
            break;
        // ...
    }
}

2. 수신 메시지 수신 대기 시작

다음으로 SMS User Consent API의 startSmsUserConsent() 메서드를 호출하여 시작합니다. 수신 메시지를 수신 대기할 수 있습니다 SMS를 받을 전화번호를 아는 경우 발생하면 null를 전달합니다. 이렇게 하면 User Consent API는 이 번호에서 보낸 메시지에서만 트리거됩니다.

듣기 시작하려면 다음 단계를 따르세요.

Kotlin

// Start listening for SMS User Consent broadcasts from senderPhoneNumber
// The Task<Void> will be successful if SmsRetriever was able to start
// SMS User Consent, and will error if there was an error starting.
val task = SmsRetriever.getClient(context).startSmsUserConsent(senderPhoneNumber /* or null */)

자바

// Start listening for SMS User Consent broadcasts from senderPhoneNumber
// The Task<Void> will be successful if SmsRetriever was able to start
// SMS User Consent, and will error if there was an error starting.
Task<Void> task = SmsRetriever.getClient(context).startSmsUserConsent(senderPhoneNumber /* or null */);

SMS 메시지 수신 후 인증 기능을 사용할 수 있습니다. 시스템에서 받은 인증 코드를 사용자의 전화번호로 전송합니다. 첫 번째 단계입니다

기기가 다음 5분 동안 일회성 코드인 경우 Play 서비스는 메시지를 표시하는 인텐트를 앱에 브로드캐스트합니다. 사용자에게 메시지를 읽을 수 있는 권한을 요청합니다. 메시지가 브로드캐스트를 트리거함 다음 기준을 충족하는 경우에만:

• 메시지에는 4~10자리 영숫자 문자열과 하나 이상의 문자열이 포함되어 있습니다. 있습니다.
• 발신자의 전화번호를 지정한 경우 해당 주소에서 메시지를 보낸 것입니다. 있습니다.

SEND_PERMISSION가 있는 broadcast receiver로 이러한 브로드캐스트를 처리합니다. 권한을 부여하고 SMS_RETRIEVED_ACTION 인텐트에 응답합니다. 만들고 broadcast receiver를 등록합니다.

Kotlin

private val SMS_CONSENT_REQUEST = 2  // Set to an unused request code
private val smsVerificationReceiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        if (SmsRetriever.SMS_RETRIEVED_ACTION == intent.action) {
            val extras = intent.extras
            val smsRetrieverStatus = extras?.get(SmsRetriever.EXTRA_STATUS) as Status

            when (smsRetrieverStatus.statusCode) {
                CommonStatusCodes.SUCCESS -> {
                    // Get consent intent
                    val consentIntent = extras.getParcelable<Intent>(SmsRetriever.EXTRA_CONSENT_INTENT)
                    try {
                        // Start activity to show consent dialog to user, activity must be started in
                        // 5 minutes, otherwise you'll receive another TIMEOUT intent
                        startActivityForResult(consentIntent, SMS_CONSENT_REQUEST)
                    } catch (e: ActivityNotFoundException) {
                        // Handle the exception ...
                    }
                }
                CommonStatusCodes.TIMEOUT -> {
                    // Time out occurred, handle the error.
                }
            }
        }
    }
}

override fun onCreate(savedInstanceState: Bundle?) {
    // ...

    val intentFilter = IntentFilter(SmsRetriever.SMS_RETRIEVED_ACTION)
    registerReceiver(smsVerificationReceiver, SmsRetriever.SEND_PERMISSION, intentFilter)
}

자바

private static final int SMS_CONSENT_REQUEST = 2;  // Set to an unused request code
private final BroadcastReceiver smsVerificationReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (SmsRetriever.SMS_RETRIEVED_ACTION.equals(intent.getAction())) {
            Bundle extras = intent.getExtras();
            Status smsRetrieverStatus = (Status) extras.get(SmsRetriever.EXTRA_STATUS);

            switch (smsRetrieverStatus.getStatusCode()) {
                case CommonStatusCodes.SUCCESS:
                    // Get consent intent
                    Intent consentIntent = extras.getParcelable(SmsRetriever.EXTRA_CONSENT_INTENT);
                    try {
                        // Start activity to show consent dialog to user, activity must be started in
                        // 5 minutes, otherwise you'll receive another TIMEOUT intent
                        startActivityForResult(consentIntent, SMS_CONSENT_REQUEST);
                    } catch (ActivityNotFoundException e) {
                        // Handle the exception ...
                    }
                    break;
                case CommonStatusCodes.TIMEOUT:
                    // Time out occurred, handle the error.
                    break;
            }
        }
    }
};

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // ...

    IntentFilter intentFilter = new IntentFilter(SmsRetriever.SMS_RETRIEVED_ACTION);
    registerReceiver(smsVerificationReceiver, SmsRetriever.SEND_PERMISSION, intentFilter);
}

EXTRA_CONSENT_INTENT의 활동을 시작하면 사용자에게 다음을 요청하는 메시지를 표시합니다. 일회성 권한이 있어야 합니다.

중요: 다음 방법으로 브로드캐스트 인텐트가 SMS Retriever API에서 온 것인지 감지할 수 있습니다. com.google.android.gms.auth.api.phone.permission.SEND 권한을 전송합니다. 이 권한 설정은 Google Play 서비스에서 사용할 수 있습니다. 버전 19.8.31 이상이 필요합니다.

중요: 권한을 추가하지 마세요. 앱에 com.google.android.gms.auth.api.phone.permission.SEND하세요. 이 권한은 인텐트가 SMS Retriever에서 전송되는지 감지하는 데만 사용되어야 함 broadcast receiver의 API입니다.

3. 메시지에서 인증 코드 받기

onActivityResult() 메서드에서 요청에 대한 사용자 응답을 처리합니다. 확인하세요. 결과 코드 RESULT_OK가 나오면 사용자가 권한이 있어야만 메일 내용을 읽을 수 있고 삭제합니다.

Kotlin

public override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    when (requestCode) {
        // ...
        SMS_CONSENT_REQUEST ->
            // Obtain the phone number from the result
            if (resultCode == Activity.RESULT_OK && data != null) {
                // Get SMS message content
                val message = data.getStringExtra(SmsRetriever.EXTRA_SMS_MESSAGE)
                // Extract one-time code from the message and complete verification
                // `message` contains the entire text of the SMS message, so you will need
                // to parse the string.
                val oneTimeCode = parseOneTimeCode(message) // define this function

                // send one time code to the server
            } else {
                // Consent denied. User can type OTC manually.
            }
    }
}

자바

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    switch (requestCode) {
        // ...
        case SMS_CONSENT_REQUEST:
            if (resultCode == RESULT_OK) {
                // Get SMS message content
                String message = data.getStringExtra(SmsRetriever.EXTRA_SMS_MESSAGE);
                // Extract one-time code from the message and complete verification
                // `sms` contains the entire text of the SMS message, so you will need
                // to parse the string.
                String oneTimeCode = parseOneTimeCode(message); // define this function

                // send one time code to the server
            } else {
                // Consent canceled, handle the error ...
            }
            break;
    }
}

메시지 텍스트를 받으면 인증 코드를 파싱하고 양식을 자동으로 작성하거나 확인 절차를 완료합니다.