NFC－NFCAdapter

NFCAdapter

• 參數及說明： Object tech， 標籤類型枚舉

  内容	類型	說明
  ndef	String	對應Ndef實例，實例支持對NDEF格式的NFC標籤上的NDEF數據的讀寫
  nfcA	String	對應NfcA實例，實例支持NFC-A（ISO 14443-3A）標準的讀寫
  nfcB	String	對應NfcB實例，實例支持NFC-B（ISO 14443-3B）標準的讀寫
  isoDep	String	對應IsoDep實例，實例支持ISO-DEP（ISO 14443-4）標準的讀寫
  nfcF	String	對應NfcF實例，實例支持NFC-F（JIS 6319-4）標準的讀寫
  nfcV	String	對應NfcV實例，實例支持NFC-V（ISO 15693）標準的讀寫
  mifareClassic	String	對應MifareClassic實例，實例支持MIFARE Classic標籤的讀寫
  mifareUltralight	String	對應MifareUltralight實例，實例支持MIFARE Ultralight標籤的讀寫

.startDiscovery

TIP

該API使用方法為： NFCAdapter.startDiscovery()

• 參數及說明： Object object。

  内容	類型	預設值	必填	說明
  success	Function	-	否	接口調用成功的回呼函數
  fail	Function	-	否	接口調用失敗的回呼函數
  complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

• 錯誤碼

  錯誤碼	錯誤資訊	說明
  13000	設備不支持NFC	-
  13001	系統NFC開關未打開	-
  13010	未知錯誤	-
  13019	user is not authorized	用戶未授權
  13011	invalid parameter	參數無效
  13012	parse NdefMessage failed	將參數解析為NdefMessage失敗
  13021	NFC discovery already started	已經開始NFC掃描
  13018	NFC discovery has not started	嘗試在未開始NFC掃描時，停止NFC掃描
  13022	Tech already connected	標籤已經連接
  13023	Tech has not connected	嘗試在未連接標籤時斷開連接
  13013	NFC tag has not been discovered	未掃描到NFC標籤
  13014	invalid tech	無效的標籤科技
  13015	unavailable tech	從標籤上獲取對應科技失敗
  13024	function not support	當前標籤科技不支持該功能
  13017	system internal error	相關讀寫操作失敗
  13016	connect fail	連接失敗

.stopDiscovery

TIP

該API使用方法為： NFCAdapter.stopDiscovery()

• 參數及說明： Object object。

  内容	類型	預設值	必填	說明
  success	Function	-	否	接口調用成功的回呼函數
  fail	Function	-	否	接口調用失敗的回呼函數
  complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

• 錯誤碼

  錯誤碼	錯誤資訊	說明
  13000	設備不支持NFC	-
  13001	系統NFC開關未打開	-
  13010	未知錯誤	-
  13019	user is not authorized	用戶未授權
  13011	invalid parameter	參數無效
  13012	parse NdefMessage failed	將參數解析為NdefMessage失敗
  13021	NFC discovery already started	已經開始NFC掃描
  13018	NFC discovery has not started	嘗試在未開始NFC掃描時，停止NFC掃描
  13022	Tech already connected	標籤已經連接
  13023	Tech has not connected	嘗試在未連接標籤時斷開連接
  13013	NFC tag has not been discovered	未掃描到NFC標籤
  13014	invalid tech	無效的標籤科技
  13015	unavailable tech	從標籤上獲取對應科技失敗
  13024	function not support	當前標籤科技不支持該功能
  13017	system internal error	相關讀寫操作失敗
  13016	connect fail	連接失敗

.getNdef

TIP

該API使用方法為： Ndef NFCAdapter.getNdef()

• 功能說明： 獲取Ndef實例，實例支持對NDEF格式的NFC標籤上的NDEF數據的讀寫
• 返回值： Ndef。

.getNfcA

TIP

該API使用方法為： Ndef NFCAdapter.getNfcA()

• 功能說明： 獲取NfcA實例，實例支持NFC-A（ISO 14443-3A）標準的讀寫
• 返回值： NfcA。

.getNfcB

TIP

該API使用方法為： NfcB NFCAdapter.getNfcB()

• 功能說明： 獲取NfcB實例，實例支持NFC-B（ISO 14443-3B）標準的讀寫
• 返回值： NfcB。

.getNfcF

TIP

該API使用方法為： NfcF NFCAdapter.getNfcF()

• 功能說明： 獲取NfcF實例，實例支持NFC-F（JIS 6319-4）標準的讀寫
• 返回值： NfcF。

.getNfcV

TIP

該API使用方法為： NfcV NFCAdapter.getNfcV()

• 功能說明： 獲取NfcV實例，實例支持NFC-V（ISO 15693）標準的讀寫
• 返回值： NfcV。

.getIsoDep

TIP

該API使用方法為： IsoDep NFCAdapter.getlsoDep()

• 功能說明： 獲取IsoDep實例，實例支持ISO-DEP（ISO 14443-4）標準的讀寫
• 返回值： IsoDep。

.getMifareClassic

TIP

該API使用方法為： MifareClassic NFCAdapter.getMifareClassic()

• 功能說明： 獲取MifareClassic實例，實例支持MIFARE Classic標籤的讀寫
• 返回值： MifareClassic。

.getMifareUltralight

TIP

該API使用方法為： MifareUltralight NFCAdapter.getMifareUltralight()

• 功能說明： 獲取MifareUltralight實例，實例支持MIFARE Ultralight標籤的讀寫
• 返回值： MifareUltralight。

.onDiscovered

TIP

該API使用方法為： NFCAdapter.onDiscovered(function listener)

• 功能說明： 監聽NFC Tag
• 參數及說明： function listener，監聽函數，參數Object res如下：

  内容	類型	說明
  id	ArrayBuffer	-
  techs	Array	tech數組，用於匹配NFC卡片具體可以使用什麼標準（NfcA等實例）處理
  messages	Array	NdefMessage 數組，訊息格式為 {id: ArrayBuffer, type: ArrayBuffer, payload: ArrayBuffer}

.offDiscovered

TIP

該API使用方法為： NFCAdapter.offDiscovered(function listener)

• 功能說明： 移除NFC Tag的監聽函數

• 參數及說明： function listener，onDiscovered傳入的監聽函數。 不傳此參數則移除所有監聽函數

• 示例代碼：

const listener = function (res) { console.log(res) }

NFCAdapter.onDiscovered(listener)
NFCAdapter.offDiscovered(listener) // Pass the same function object used for listening.