はじめから

インストール

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のビルドには異なるハッシュが必要です。

SMS検索には、SMSに含まれるアプリのハッシュが必要です。ハッシュは、署名キーで署名されたアプリのハッシュとして生成されます。デバッグ、リリース、Play App Signingのビルドには異なるハッシュが必要です。 getHashString()SMS検索には、SMSに含まれるアプリのハッシュが必要です。ハッシュは、署名キーで署名されたアプリのハッシュとして生成されます。デバッグ、リリース、Play App Signingのビルドには異なるハッシュが必要です。

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);

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

例のSMS

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

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

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

Capacitorを使用している場合 Capacitorを使用してネイティブプラグインの作業を計画する場合、Capacitorを使用してネイティブプラグインの作業を計画するプラグインと接続します。 Capacitorを使用してネイティブプラグインの作業を計画するプラグイン 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 プラグインの代替を参照してください。