Guide
Comment utiliser le NFC dans Capacitor
Utilisation de @capgo/capacitor-nfc
Surface publique API pour le plugin NFC Capacitor.
Installer
bun add @capgo/capacitor-nfc
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.
Importer
import { CapacitorNfc } from '@capgo/capacitor-nfc';
API en un coup d'œil
| Méthode | Description |
|---|---|
startScanning |
Démarrer l'écoute des balises NFC. |
stopScanning |
Arrêtez la session d'écoute NFC en cours. |
write |
Écrit les enregistrements NDEF fournis dans la dernière balise découverte. |
erase |
Essaye d'effacer la dernière balise découverte en écrivant un message NDEF vide. |
makeReadOnly |
Essaye de rendre la dernière balise découverte non modifiable. |
share |
Partagez un message NDEF avec un autre appareil via peer-to-peer (seulement Android). |
unshare |
Arrêtez de partager le message NDEF fourni précédemment (seulement Android). |
getStatus |
Renvoie le statut actuel de l'adaptateur NFC. |
showSettings |
Ouvre la page de paramètres système où l'utilisateur peut activer l'NFC. |
isSupported |
Vérifie si le dispositif dispose d'un support matériel NFC. |
Exemples
startScanning()
Écoute les balises NFC.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.startScanning();
stopScanning()
Arrête la session de balayage NFC en cours.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.stopScanning();
write()
Écrit les enregistrements NDEF fournis sur la dernière tag découvert.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.write({
records: [
{
tnf: 1,
type: [1],
id: [1],
payload: [1],
},
],
});
erase()
Tente d'effacer le dernier tag découvert en écrivant un message NDEF vide.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.erase();
makeReadOnly()
Écrit les enregistrements NDEF fournis dans la dernière balise découverte.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.makeReadOnly();
share()
Essaye d'effacer la dernière balise découverte en écrivant un message NDEF vide.
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.share({
records: [
{
tnf: 1,
type: [1],
id: [1],
payload: [1],
},
],
});
La table ci-dessus liste les 10 méthodes de base. Les aides pour les listeners et les versions, ainsi que la pleine convention de chaque méthode, sont documentées dans le dépôt GitHub.
Écoutez les événements
addListener renvoie un gestionnaire. Appelez handle.remove() lorsque l'écran est démonté.
Référence complète
Continuez à partir de l'utilisation de @capgo/capacitor-nfc
Si vous utilisez L'utilisation de @capgo/capacitor-nfc pour planifier le tableau de bord et les opérations API, connectez-l’avec @capgo/capacitor-NFC Détails de mise en œuvre pour @capgo/capacitor-nfc, Prise en main Détails de mise en œuvre pour Prise en main, Vue d'ensemble de @API Détails de mise en œuvre pour Vue d'ensemble de @API, Introduction Détails de mise en œuvre pour Introduction, et Clés de @API Détails de mise en œuvre pour Clés de @API.