@capgo/capacitor-nfc 사용하기
Capacitor NFC 플러그인을 위한 공개 API 환경
설치
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 |
P2P를 통해 다른 기기와 NDEF 메시지를 공유합니다 (Android 전용). |
unshare |
이전에 공유한 NDEF 메시지 공유를 중단합니다 (Android 전용). |
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()
P2P 방식을 통해 다른 기기와 NDEF 메시지를 공유합니다 (Android 전용).
import { CapacitorNfc } from '@capgo/capacitor-nfc';
await CapacitorNfc.share({
records: [
{
tnf: 1,
type: [1],
id: [1],
payload: [1],
},
],
});
위 표에는 10개의 핵심 메서드가 나열되어 있습니다. Listener 및 version 헬퍼, 그리고 각 메서드의 전체 계약(contract)은 다음 문서에서 확인할 수 있습니다. GitHub 리포지토리.
이벤트 수신
addListener 핸들을 반환합니다. 호출하세요 handle.remove() 화면이 언마운트될 때.
전체 레퍼런스
@capgo/capacitor-nfc 사용 계속하기
사용 중이라면 @capgo/capacitor-nfc 사용하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-nfc @capgo/capacitor-nfc의 구현 세부 사항은 시작하기 Getting Started의 구현 상세 내용은 API 개요 구현 세부 사항은 API 개요에서 소개 Introduction의 구현 상세 내용은, 그리고 API 키 API Keys의 구현 상세 내용은