はじめから始める

インストール

Capgoの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の要件

SMS Retrieverには、AndroidデバイスにGoogle Playサービスが必要です。プラグインは、 READ_SMS または RECEIVE_SMS SMSの検証に必要なアプリのハッシュが含まれているSMSが必要です。ハッシュは

で生成する必要があります。署名キーを使用してアプリを配布する場合のハッシュです。デバッグ、リリース、Play App Signingのビルドは異なるハッシュを生成する可能性があります。 getHashString(). Generate the hash for the signing key used to distribute the app. Debug, release, and Play App Signing builds can have different hashes.

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検証の待ちのために、バックエンドから送信されるSMSの末尾にこのハッシュを使用してください。

電話番号のヒントを要求

const { phoneNumber } = await AndroidSmsRetriever.getPhoneNumber();
console.log(phoneNumber);

ユーザーが選択した電話番号を表示するためにAndroidはネイティブの電話番号ヒントUIを表示し、電話番号を返します。

例のSMS

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

アプリ署名キーでハッシュを置き換えます。

「Getting Started」から続けてください

「Getting Started」 ネイティブプラグインの作業を計画するために「Getting Started」を使用している場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-sms-retrieverと接続します 「Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-android-sms-retriever」を使用 「Using @capgo/capacitor-android-sms-retriever」 Capacitorのネイティブ機能の使用に@capgo/capacitor-android-sms-retrieverを使用します。 Capgo プラグインディレクトリ Capacitorの製品ワークフローについては、Capgo プラグインディレクトリを参照してください。 Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, プラグインの追加または更新 プラグインの追加または更新の実装詳細については、 Capacitor Enterprise プラグインの代替 Capacitorの製品ワークフローについては、Capacitor Enterprise プラグインの代替を参照してください。