Guía
Cómo usar NFC en Capacitor
Usando @capgo/capacitor-nfc
Superficie pública de la API para el plugin NFC de Capacitor.
Instalar
bun add @capgo/capacitor-nfc
bunx cap sync
bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.
Importar
import { CapacitorNfc } from '@capgo/capacitor-nfc';
API de un vistazo
| Método | Descripción |
|---|---|
startScanning |
Comienza a escuchar etiquetas NFC. |
stopScanning |
Detiene la sesión de escaneo NFC en curso. |
write |
Escribe los registros NDEF proporcionados en la última etiqueta detectada. |
erase |
Intenta borrar la última etiqueta detectada escribiendo un mensaje NDEF vacío. |
makeReadOnly |
Intenta poner la última etiqueta detectada en modo de solo lectura. |
share |
Comparte un mensaje NDEF con otro dispositivo vía peer-to-peer (solo Android). |
unshare |
Deja de compartir el mensaje NDEF proporcionado anteriormente (solo Android). |
getStatus |
Devuelve el estado actual del adaptador NFC. |
showSettings |
Abre la página de ajustes del sistema donde el usuario puede activar el NFC. |
isSupported |
Comprueba si el dispositivo tiene soporte de hardware NFC. |
Ejemplos
startScanning()
Comienza a escuchar etiquetas NFC.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.startScanning();
stopScanning()
Detiene la sesión de escaneo NFC en curso.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.stopScanning();
write()
Escribe los registros NDEF proporcionados en la última etiqueta detectada.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.write({
records: [
{
tnf: 1,
type: [1],
id: [1],
payload: [1],
},
],
});
erase()
Intenta borrar la última etiqueta detectada escribiendo un mensaje NDEF vacío.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.erase();
makeReadOnly()
Intenta poner la última etiqueta detectada en modo de solo lectura.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.makeReadOnly();
share()
Comparte un mensaje NDEF con otro dispositivo vía peer-to-peer (solo Android).
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.share({
records: [
{
tnf: 1,
type: [1],
id: [1],
payload: [1],
},
],
});
La tabla anterior enumera los 10 métodos principales. Los helpers de versión y listeners, junto con el contrato completo de cada método, están documentados en la repositorio GitHub.
Escuchar eventos
addListener devuelve un handle. Llama handle.remove() cuando la pantalla se desmonta.
Referencia completa
Continúa desde Using @capgo/capacitor-nfc
Si estás usando Usando @capgo/capacitor-nfc para planificar las operaciones del dashboard y de API, conéctalo con @capgo/capacitor-nfc para los detalles de implementación en @capgo/capacitor-nfc, Primeros pasos para los detalles de implementación en Primeros pasos, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Keys.