개요
개요 섹션@capgo/capacitor-android-sms-retriever Google Play 서비스의 SMS 수신기 및 전화번호 힌트 API를 Android 전용으로 Capacitor 인증 흐름에 사용합니다.
이 플러그인은 앱이 SMS 허용 권한을 요청하지 않고도 SMS를 받은 앱에만 주소된 단일 인증 SMS를 듣도록 허용합니다. 또한 사용자가 SIM 기반의 전화번호를 수동으로 입력하지 않고 선택할 수 있도록 Android의 원본 전화번호 힌트 UI를 표시할 수 있습니다.
핵심 기능
핵심 기능 섹션startWatch- 5분간의 SMS 수신기 시계를 1개의 인증 SMS에 대해 시작합니다.stopWatch- 활성화된 SMS 수신기 시계를 중지합니다.getHashString- 인증 SMS 메시지에 사용된 11자리 앱 해시를 읽습니다.getPhoneNumber- Android의 전화번호 힌트를 열고 선택한 전화번호를 반환합니다.smsReceived- 수신된 인증 SMS를 듣습니다.smsRetrieverTimeout- 5분의 시간 초과를 듣습니다.smsRetrieverError- 안드로이드 또는 Google Play 서비스에서 런타임 오류를 감지합니다.
플랫폼 지원
플랫폼 지원| 플랫폼 | 지원 |
|---|---|
| 안드로이드 | 지원 |
| iOS | 미지원 |
| 웹 | 미지원 |
API
공개 API| 메서드 | 설명 |
|---|---|
startWatch | 1개의 인증 SMS를 기다리기 시작합니다. |
stopWatch | 활성 시계를 중지합니다. |
getHashString | 11자리 앱 해시를 반환합니다. |
getPhoneNumber | 전화번호 힌트를 표시하고 선택한 번호를 반환합니다. |
addListener('smsReceived', ...) | 추출한 SMS 페이로드를 받습니다. |
addListener('smsRetrieverTimeout', ...) | 시간 초과 이벤트를 처리합니다. |
addListener('smsRetrieverError', ...) | 리트리버 오류를 처리합니다. |
getPluginVersion | 자연 플러그인 버전을 반환합니다. |
소스 오브 트루스
Source Of Truth이 참조는 src/definitions.ts 에서同步 capacitor-android-sms-retriever.