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 listeners y versiones, y 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 Uso de @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.