Getting Started

설치

AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

다음과 같은 프롬프트를 사용하세요:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-android-sms-retriever` plugin in my project.

만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래에 플랫폼에 따라 설명된 지침을 따르세요:

bun add @capgo/capacitor-android-sms-retriever
bunx cap sync android

수입

import { AndroidSmsRetriever } from '@capgo/capacitor-android-sms-retriever';

Android Requirements

Android 기기에서 Google Play 서비스가 필요합니다. 플러그인은 사용자에게 권한을 요청하지 않습니다. 앱 해시가 포함된 인증 SMS는 앱을 배포하기 위해 사용하는 서명 키의 해시를 생성해야 합니다. Debug, release, 및 Play App Signing 빌드는 다른 해시를 가질 수 있습니다. READ_SMS or RECEIVE_SMS SMS 인증을 위해 앱이 반환한 해시가 포함된 인증 SMS를 포함해야 합니다.

Listen For A Verification SMS getHashString()Section titled “Listen For A Verification 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);

안드로이드는 사용자가 선택한 전화번호를 반환하는 native Phone Number Hint UI를 보여줍니다.

예시 SMS

<#> 123456 is your verification code.
FA+9qCX9VSu

앱 서명 키의 해시로 마지막 줄을 대체하세요.

Getting Started에서 계속

이러한 기능을 사용 중이라면 Getting Started native plugin 작업을 계획할 때 native capability을 @capgo/capacitor-android-sms-retriever와 연결하세요. Using @capgo/capacitor-android-sms-retriever native capability의 @Capgo/__CAPGO_KEEP_1__-android-sms-retriever Capgo Plugin Directory Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 구현 세부 사항에 대해 플러그인 추가 또는 업데이트 __CAPGO_KEEP_0__ 플러그인 추가 또는 업데이트의 구현 세부 사항에 대해, 그리고 아이오닉 엔터프라이즈 플러그인 대체 아이오닉 엔터프라이즈 플러그인 대체의 제품 워크플로에 대해.