Inizia a utilizzare

Installazione

Puoi utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo competenze al tuo strumento AI utilizzando il seguente comando:

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

Usa poi il seguente prompt:

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

Se preferisci la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo platform:

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

Importa

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

Requisiti per Android

L'applicazione SMS Retriever richiede i servizi Google Play sul dispositivo Android. Il plugin non richiede alcuna autorizzazione. READ_SMS o RECEIVE_SMS Le tue autorizzazioni.

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

Ascolta una 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 Watching

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

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

Esempio di SMS

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

Sostituisci la riga finale con l'hash per la chiave di firma dell'applicazione.

Continua da Inizia

Se stai utilizzando Inizia per pianificare il lavoro di plugin nativo, connettilo con Utilizza @capgo/capacitor-android-sms-retriever per la capacità nativa in Utilizza @capgo/capacitor-android-sms-retriever, Capgo Directory dei plugin per il flusso di lavoro del prodotto in Capgo Directory dei plugin, Plugin da Capacitor sviluppati da Capgo per i dettagli di implementazione in Plugin da Capacitor sviluppati da Capgo, Aggiunta o Aggiornamento di Plugin per i dettagli di implementazione in Aggiunta o Aggiornamento di Plugin, e Alternative per Plugin Enterprise di Ionic per il flusso di lavoro del prodotto in Alternative per Plugin Enterprise di Ionic.