Inizia con Getting Started

Installazione

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

Importazione

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

Requisiti per Android

SMS Retriever richiede i servizi Google Play sul dispositivo Android. Il plugin non richiede READ_SMS ne RECEIVE_SMS permessi.

Il vostro SMS di verifica deve includere l'hash dell'applicazione restituito da getHashString(). Genera l'hash per la chiave di firma utilizzata per distribuire l'app. I build di debug, rilascio e Play App Signing possono avere hash diversi.

Ascolta un SMS di verifica

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

Stop di osservazione

await AndroidSmsRetriever.stopWatch();

Ottieni L'Hash Dell'app

const { hash } = await AndroidSmsRetriever.getHashString();
console.log(hash);

Utilizza questo hash alla fine del messaggio di verifica SMS inviato dal tuo backend.

Richiedi Un Suggerimento Di Numero Di Telefono

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

L'Android mostra l'interfaccia utente di suggerimento del numero di telefono nativa e restituisce il numero di telefono selezionato dall'utente.

Esempio Di Messaggio

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

Sostituisci la riga finale con l'hash della chiave di firma dell'app.

Continua da Getting Started

Se stai utilizzando Getting Started per pianificare il lavoro di plugin nativi, connettilo con Utilizzando @capgo/capacitor-android-sms-retriever per la capacità nativa in Utilizzando @capgo/capacitor-android-sms-retriever, Directory dei plugin Capgo per il flusso di lavoro del prodotto in Directory dei plugin Capgo, I plugin Capacitor di Capgo per la dettaglio di implementazione in I plugin Capacitor di Capgo, Aggiungere o aggiornare i plugin per i dettagli di implementazione in Aggiungere o Aggiornare Plugin, e Alternative per Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternative Plugin Enterprise Ionic.