Guida
Come usare NFC in Capacitor
Uso di @capgo/capacitor-nfc
Superficie API pubblica per il plugin NFC Capacitor.
Installa
bun add @capgo/capacitor-nfc
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { CapacitorNfc } from '@capgo/capacitor-nfc';
API in breve
| Metodo | Descrizione |
|---|---|
startScanning |
Avvia l'ascolto dei tag NFC. |
stopScanning |
Interrompe la sessione di scansione NFC in corso. |
write |
Scrive i record NDEF forniti sull'ultimo tag rilevato. |
erase |
Tenta di cancellare l'ultimo tag rilevato scrivendo un messaggio NDEF vuoto. |
makeReadOnly |
Tenta di rendere l'ultimo tag rilevato di sola lettura. |
share |
Condivide un messaggio NDEF con un altro dispositivo via peer-to-peer (solo Android). |
unshare |
Interrompe la condivisione del messaggio NDEF fornito (solo Android). |
getStatus |
Restituisce lo stato attuale dell'adapter NFC. |
showSettings |
Apre la pagina delle impostazioni di sistema per abilitare l'NFC. |
isSupported |
Verifica se il dispositivo supporta l'hardware NFC. |
Esempi
startScanning()
Avvia l'ascolto dei tag NFC.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.startScanning();
stopScanning()
Interrompe la sessione di scansione NFC in corso.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.stopScanning();
write()
Scrive i record NDEF forniti nell'ultimo tag rilevato.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.write({
records: [
{
tnf: 1,
type: [1],
id: [1],
payload: [1],
},
],
});
erase()
Tenta di cancellare l'ultimo tag rilevato scrivendo un messaggio NDEF vuoto.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.erase();
makeReadOnly()
Tenta di impostare l'ultimo tag rilevato in modalità sola lettura.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.makeReadOnly();
share()
Condivide un messaggio NDEF con un altro dispositivo via peer-to-peer (solo Android).
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.share({
records: [
{
tnf: 1,
type: [1],
id: [1],
payload: [1],
},
],
});
La tabella sopra elenca i 10 metodi principali. Listener, helper di versione e il contratto completo di ogni metodo sono documentati nella repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata.
Riferimento completo
Continua con l'uso di @capgo/capacitor-nfc
Se stai usando Uso di @capgo/capacitor-nfc per pianificare le operazioni della dashboard e di API, collegalo a @capgo/capacitor-nfc per i dettagli di implementazione in @capgo/capacitor-nfc, Per iniziare per i dettagli di implementazione nella guida introduttiva, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, e Chiavi API per i dettagli implementativi in API Keys.