메인 콘텐츠로 건너뛰기
@capgo/capacitor-nfc 장치 API 오픈 소스

NFC Capacitor 플러그인

Capacitor 앱을 위한 iOS 및 Android에서 Native 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

Guide

Capacitor NFC 사용 방법

__CAPGO_KEEP_0__ 앱을 다운로드하고 QR __CAPGO_KEEP_1__를 스캔하세요.

다운로드하여 Capgo 앱을 설치한 후 QR code 코드를 스캔하세요.

NFC 플러그인 미리보기 QR code

@capgo/capacitor-nfc를 사용합니다

공개 API 표면은 Capacitor NFC 플러그인입니다.

설치

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 다른 기기와 NFC 태그를 공유합니다 (안드로이드 전용).
unshare 이전에 제공된 NDEF 메시지를 공유 중지합니다 (안드로이드 전용).
getStatus 현재 NFC 어댑터 상태를 반환합니다.
showSettings NFC를 활성화할 수 있는 시스템 설정 페이지를 엽니다.
isSupported 기기에 NFC 하드웨어 지원 여부를 확인합니다.

예시

startScanning()

NFC 태그를 감지하기 시작합니다.

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()

Android 전용으로 다른 기기와 NDEF 메시지를 공유합니다.

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

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

위 표에는 10개의 핵심 메서드가 나열되어 있습니다. 리스너 및 버전 헬퍼, 각 메서드의 전체 계약은 __CAPGO_KEEP_0__ 저장소에서 문서화되어 있습니다. GitHub 저장소.

화면이 언마운트 될 때 호출합니다.

addListener 전체 참조 handle.remove() NFC 태그를 감지합니다.

NFC 스캔 세션을 중지합니다.

@capgo/capacitor-nfc 계속 사용하세요

__CAPGO_KEEP_0__ 사용 @capgo/capacitor-nfc API 운영 @capgo/capacitor-nfc @capgo/capacitor-NFC 구현 세부사항을 위해 __CAPGO_KEEP_0__ 개요 __CAPGO_KEEP_0__ API 구현 세부 사항에 대한 API 개요 소개 구현 세부 사항에 대한 소개 및 API 키 API 키 구현 세부 사항을 위해.

FAQ

NFC 플러그인 FAQ

NFC 플러그인을 Capacitor 앱에 설치하는 방법은?

"bun add @capgo/capacitor-nfc" (또는 "npm install @capgo/capacitor-nfc")를 실행한 후 "bunx cap sync"를 실행하여 iOS 및 Android 프로젝트가 네이티브 code를 인식하도록 하세요. 그리고 앱 code에서 "@capgo/capacitor-nfc"를 임포트하세요.

React, Vue 및 Angular과 함께 @capgo/capacitor-nfc가 작동하는지?

네. NFC는 Capacitor 패키지이므로, Ionic, React, Vue, Angular, Svelte 및 일반 JavaScript와 같은 웹 프레임워크가 Capacitor 내에서 실행되는 경우 작동합니다.

어떤 Capacitor 버전이 @capgo/capacitor-nfc를 지원하는지?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

어떤 capgo 버전이 @capacitor/__CAPGO_KEEP_2__-nfc를 지원하는지?

네. code은 GitHub에 공개되어 있으며 https://github.com/Cap-go/capacitor-nfc/에서 무료로 설치할 수 있습니다. npm에서 버그 리포트와 풀 리퀘스트를 환영합니다.

code NFC를 사용하는 앱을 App Store 리뷰 없이 업데이트할 수 있나요?

code 플러그인을 설치하거나 업그레이드하면 네이티브 code이 변경되므로 새로운 스토어 빌드를 필요로 합니다. 그 후에 Capgo 라이브 업데이트를 사용하여 플러그인을 호출하는 자바스크립트, HTML 및 CSS 변경 사항이 즉시 배포될 수 있습니다.

NFC 변경 사항을 앱 리뷰 기다리지 않고 배포하세요.

플러그인이 스토어 빌드에 포함된 후, Capgo 라이브 업데이트 사용하면 사용자에게 몇 분만에 자바스크립트, HTML 및 CSS 변경 사항을 푸시할 수 있습니다.

Capgo로 시작하세요.