メインコンテンツにジャンプ
@capgo/capacitor-nfc デバイスAPI オープンソース

NFC Capacitor プラグイン

Capacitor アプリ用のiOSとAndroidのネイティブNFCタグの検出、読み取り、書き込み

インストール

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

ガイド

How to use NFC in Capacitor

デバイスでテスト

Capgoアプリをダウンロードし、QRコードをスキャンしてください。code

NFC プラグインのプレビュー QR code

@capgo/capacitor-nfcを使用

Public API 面積に NFC プラグインの Capacitor を公開しています。

インストール

bun add @capgo/capacitor-nfc
bunx cap sync

bunx cap sync プラグインのネイティブ code をあなたのネイティブ プロジェクトにコピーします。プラグインのアップグレード後は、再度実行してください。

インポート

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

APIの概要

メソッド 説明
startScanning NFCタグを待ち受けます。
stopScanning NFCスキャニングセッションを停止します。
write 提供されたNDEFレコードを最後に発見したタグに書き込みます。
erase 最後に発見したタグを空のNDEFメッセージで書き換えます。
makeReadOnly 最後に発見したタグを読み取り専用にします。
share Android専用: NDEFメッセージを別のデバイスに共有します。
unshare Android専用: すでに提供されたNDEFメッセージの共有を停止します。
getStatus 現在のNFCアダプタの状態を取得します。
showSettings NFCを有効にするためのシステム設定ページを開きます。
isSupported このデバイスがNFCハードウェアをサポートしているかどうかを確認します。

例

startScanning()

タグを読み始めます。

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

await CapacitorNfc.startScanning();

stopScanning()

NFCスキャニングセッションを停止します。

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

await CapacitorNfc.stopScanning();

write()

提供されたNDEFレコードを最後に発見したタグに書き込みます。

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

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

erase()

最後に発見したタグを空のNDEFメッセージで書き込み、空のタグを消去します。

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

await CapacitorNfc.erase();

makeReadOnly()

最後に発見したタグを読み取り専用にします。

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

await CapacitorNfc.makeReadOnly();

share()

NDEFメッセージを別のデバイスとペアで共有します (Android 限定)。

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

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

上の表には、10つの基本メソッドがリストされています。リスナーとバージョンヘルパー、各メソッドの完全な契約は、 GitHub リポジトリ.

イベントを聞く

addListener ハンドルを返します。画面をアンマウントするには handle.remove() 画面をアンマウントしたときに呼びます。

フルリファレンス

続けて@capgo/capacitor-nfcを使用する

@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-nfcを使用している場合 @capgo/capacitor-nfcを使用している場合、ダッシュボードとcapgoのオペレーションを計画するには、@capgo/capacitor-nfcと接続する @API/__CAPGO_KEEP_1__-nfcを使用する @capgo/capacitor-nfc @capgo/capacitor-nfcの実装詳細について はじめに Capacitor NFCの実装詳細について API まとめ APIの実装詳細について Capacitor NFCのキー このページでは API キー API キーの実装詳細について

FAQ

FAQ

Capacitor NFC プラグインを Capacitor アプリにインストールする方法は何ですか。

Run "bun add @capgo/capacitor-nfc" (or "npm install @capgo/capacitor-nfc"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-nfc" in your app code.

@capgo/capacitor-nfcは、React、Vue、Angularとどのくらいの関係があるのでしょうか。

Yes. NFC is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Capacitor のバージョンは、@capgo/capacitor-nfc がサポートするでしょうか?

Capgo プラグインは Capacitor のメジャーバージョンに従います。使用するプラグインのメジャーバージョンは、Capacitor のメジャーバージョンと一致するものを使用してください (例えば、プラグイン v8 と Capacitor 8)。 GitHub README に記載されている互換性テーブルを参照してください。

@capgo/capacitor-nfc は無料でオープンソースですか?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-nfc/ and the package is free to install from npm. Bug reports and pull requests are welcome.

code を NFC が使用している場合に App Store のレビューなしで更新できますか?

プラグインをインストールまたはアップグレードすると、ネイティブ code が変更されるため、ストアのビルドが必要になります。その後、JavaScript、HTML、CSS の変更がプラグインを呼び出す場合、Capgo のライブ更新で即時配信できます。

NFC の変更をアプリレビューの待たずに配信する

プラグインがストアのビルドに含まれると、Capgo ライブアップデートは、ユーザーに JavaScript、HTML、CSS の変更を数分でプッシュします。

Capgo