시작하기
설치 단계와 이 플러그인에 대한 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-android-sms-retriever`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/android-sms-retriever/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
설치
설치 제목bun add @capgo/capacitor-android-sms-retrieverbunx cap sync android수입
수입 제목import { AndroidSmsRetriever } from '@capgo/capacitor-android-sms-retriever';안드로이드 요구 사항
Android 요구 사항Android 기기에서 Google Play 서비스가 필요합니다. 플러그인은 권한을 요청하지 않습니다. READ_SMS 또는 RECEIVE_SMS 인증 SMS는 앱 해시를 포함해야 합니다. 앱 해시를 생성하려면
앱을 배포하는 데 사용하는 서명 키의 해시를 생성하세요. 디버그, 릴리스 및 Play App Signing 빌드는 서로 다른 해시를 가질 수 있습니다. getHashString()인증 SMS를 기다리기
제목: SMS를 기다리기
클립보드에 복사import { AndroidSmsRetriever } from '@capgo/capacitor-android-sms-retriever';
const received = await AndroidSmsRetriever.addListener('smsReceived', ({ message }) => { const code = message.match(/\b\d{6}\b/)?.[0]; console.log('Verification code:', code);});
const timeout = await AndroidSmsRetriever.addListener('smsRetrieverTimeout', () => { console.log('SMS Retriever timed out');});
const errors = await AndroidSmsRetriever.addListener('smsRetrieverError', ({ message }) => { console.error('SMS Retriever error:', message);});
await AndroidSmsRetriever.startWatch();
// Remove listeners when the verification flow is done.await received.remove();await timeout.remove();await errors.remove();제목: 감시 중지
클립보드에 복사await AndroidSmsRetriever.stopWatch();앱 해시 가져오기
앱 해시 가져오기 섹션const { hash } = await AndroidSmsRetriever.getHashString();console.log(hash);인증 SMS에서 백엔드가 보내는 마지막에 이 해시를 사용하세요.
전화번호 힌트 요청
전화번호 힌트 요청 섹션const { phoneNumber } = await AndroidSmsRetriever.getPhoneNumber();console.log(phoneNumber);Android는 사용자가 선택한 전화번호를 반환하는 native Phone Number Hint UI를 보여줍니다.
예시 SMS
예시 SMS 섹션<#> 123456 is your verification code.FA+9qCX9VSu앱 서명 키의 해시를 마지막 줄에 대체하세요.