Empezar

Instalar

Puede utilizar nuestra configuración asistida por inteligencia artificial para instalar el complemento. Agregue las Capgo habilidades a su herramienta de inteligencia artificial utilizando el siguiente comando:

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

Luego utilice el siguiente prompt:

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

Si prefiere la configuración manual, instale el complemento ejecutando los siguientes comandos y siguiendo las instrucciones específicas de la plataforma a continuación:

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

Importar

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

Requisitos de Android

El recuperador de SMS requiere servicios de Google Play en el dispositivo Android. El plugin no solicita READ_SMS ni RECEIVE_SMS permisos.

Su mensaje de texto de verificación debe incluir el hash de la aplicación devuelto por getHashString(). Genera el hash para la clave de firma utilizada para distribuir la aplicación. Los builds de depuración, de liberación y de Play App Signing pueden tener diferentes hashes.

Escuchar un mensaje de texto de verificación

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

Detener la observación

await AndroidSmsRetriever.stopWatch();

Obtener la Código de la Aplicación

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

Utilice este código en el final del mensaje de verificación SMS enviado por su backend.

Solicitar una Sugerencia de Número de Teléfono

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

Android muestra la interfaz de usuario nativa de Sugerencia de Número de Teléfono y devuelve el número de teléfono seleccionado por el usuario.

Mensaje de ejemplo

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

Sustituye la última línea con el hash de la clave de firma de tu aplicación.

Sigue adelante desde Inicio

Si estás utilizando Inicio para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-android-sms-retriever para la capacidad nativa en Usando @capgo/capacitor-android-sms-retriever Capgo Directorio de Plugin para el flujo de trabajo del producto en Capgo Directorio de Plugin Capacitor Plugins por Capgo para los detalles de implementación en Capacitor Plugins por Capgo, Agregar o Actualizar Plugins para los detalles de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise.