Saltare al contenuto principale
@capgo/capacitor-nfc API di dispositivo Sorgente aperta

NFC Plugin Capacitor

Scoperta, lettura e scrittura di etichette NFC native per gli applicazioni Capacitor su iOS e Android

Installa

bun add @capgo/capacitor-nfc bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-nfc
  • pnpm add @capgo/capacitor-nfc
  • yarn add @capgo/capacitor-nfc

Guida

Come utilizzare NFC in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansione il QR code.

Collegamento QR di anteprima del plugin NFC code

Utilizza @capgo/capacitor-nfc

Superficie pubblica API per il plugin NFC Capacitor

Installa

bun add @capgo/capacitor-nfc
bunx cap sync

bunx cap sync copia il code nativo del plugin nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

import { CapacitorNfc } from '@capgo/capacitor-nfc';

Vedi API in un colpo d'occhio

Metodo Description
startScanning Eseguire la scansione NFC in corso.
stopScanning Eseguire la scansione NFC in corso.
write Scrive i record NDEF forniti sul tag scoperto più recentemente.
erase Tenta di cancellare l'ultima tag scoperto scrivendo un messaggio NDEF vuoto.
makeReadOnly Tenta di rendere in sola lettura l'ultima etichetta scoperta.
share Condivide un messaggio NDEF con un altro dispositivo tramite peer-to-peer (disponibile solo su Android).
unshare Stops sharing previously provided NDEF message (Android only).
getStatus Eseguire la scansione NFC in corso.
showSettings Apri la pagina delle impostazioni del sistema dove l'utente può abilitare il NFC.
isSupported Controlla se il dispositivo supporta la tecnologia NFC.

Examples

startScanning()

Inizia ad ascoltare le etichette 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()

Scrivi i record NDEF forniti sulla ultima etichetta scoperta.

import { CapacitorNfc } from '@capgo/capacitor-nfc';

await CapacitorNfc.write({
  records: [
    {
      tnf: 1,
      type: [1],
      id: [1],
      payload: [1],
    },
  ],
});

erase()

Cerca di cancellare l'ultima etichetta scoperta scrivendo un messaggio NDEF vuoto.

import { CapacitorNfc } from '@capgo/capacitor-nfc';

await CapacitorNfc.erase();

makeReadOnly()

Cerca di rendere l'ultima etichetta scoperta non modificabile.

import { CapacitorNfc } from '@capgo/capacitor-nfc';

await CapacitorNfc.makeReadOnly();

share()

Condividi un messaggio NDEF con un altro dispositivo tramite peer-to-peer (solo per Android).

import { CapacitorNfc } from '@capgo/capacitor-nfc';

await CapacitorNfc.share({
  records: [
    {
      tnf: 1,
      type: [1],
      id: [1],
      payload: [1],
    },
  ],
});

I metodi principali sono elencati nella tabella sopra. I listener e gli aiuti di versione, nonché il contratto completo di ogni metodo, sono documentati nel GitHub repository.

ritorna un handle. Chiama

addListener quando lo schermo viene smontato. handle.remove() Riferimento completo

Metodi core

Continua dall'uso di @capgo/capacitor-nfc

Utilizza @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-nfc Usando @capgo/capacitor-nfc per pianificare il dashboard e le API operazioni, connettilo con per i dettagli di implementazione in @capgo/capacitor-nfc per i dettagli di implementazione in @capgo/capacitor-nfc, per i dettagli di implementazione in Guida di avvio per i dettagli di implementazione nella sezione Getting Started, Riferimento di API per il dettaglio di implementazione in API Panoramica Introduzione per il dettaglio di implementazione in Introduzione, e API Chiavi per il dettaglio di implementazione in API Chiavi.

FAQ

Faq del plugin NFC

Come posso installare il plugin NFC in un'app Capacitor?

Esegui "bun add @capgo/capacitor-nfc" (o "npm install @capgo/capacitor-nfc"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il nativo code. Importalo da "@capgo/capacitor-nfc" nella tua app code.

Funziona @capgo/capacitor-nfc con React, Vue e Angular?

Sì. Il plugin NFC è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-nfc?

I plugin Capgo seguono la versione maggiore di Capacitor: utilizza la versione maggiore del plugin che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-nfc?

Sì. La fonte code è pubblica su GitHub in https://github.com/Cap-go/capacitor-nfc/ e il pacchetto è gratuito per l'installazione da npm. I rapporti di bug e le richieste di pull sono i benvenuti.

Posso aggiornare code che utilizza NFC senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il code nativo, quindi richiede una nuova costruzione del negozio. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti immediatamente con gli aggiornamenti Capgo in tempo reale.

Invia modifiche NFC senza dover attendere la revisione dell'app.

Una volta che il plugin è nel tuo store build, le Capgo aggiornamenti live inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo