萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android NFC 開發實戰:Beam、標籤讀寫與 HCE 完整指南

前言

NFC (Near Field Communication) 讓裝置在 4 cm 內進行無線資料交換。Android 4.0+ 提供完整 API 支援 Peer-to-Peer (Android Beam)、Reader/Writer 模式 (讀寫 NDEF 標籤)、Card Emulation (HCE) 三大模式。本文以官方 Beam 範例為基礎,延伸至完整開發流程。

核心類別速查

類別用途
NfcAdapterNFC 控制器單例,啟用/停用、註冊回調
NdefMessage / NdefRecordNDEF 封裝資料結構 (MIME、URI、外部類型)
Tag被動標籤代表,透過 getTag() 取得
NfcEventBeam 傳送事件,包含觸發時間

權限與 Manifest 宣告

<uses-permission android:name="android.permission.NFC" />
<uses-feature android:name="android.hardware.nfc" android:required="true" />

<application ...>
    <activity android:name=".BeamActivity">
        <intent-filter>
            <action android:name="android.nfc.action.NDEF_DISCOVERED" />
            <category android:name="android.intent.category.DEFAULT" />
            <data android:mimeType="application/com.example.beam" />
        </intent-filter>
    </activity>
</application>

模式一:Android Beam (P2P 傳送 NDEF)

class BeamActivity : Activity(), 
    NfcAdapter.CreateNdefMessageCallback, 
    NfcAdapter.OnNdefPushCompleteCallback {

    private lateinit var nfcAdapter: NfcAdapter
    private lateinit var textView: TextView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_beam)
        textView = findViewById(R.id.textView)

        nfcAdapter = NfcAdapter.getDefaultAdapter(this) ?: return
        nfcAdapter.setNdefPushMessageCallback(this, this)
        nfcAdapter.setOnNdefPushCompleteCallback(this, this)
    }

    override fun createNdefMessage(event: NfcEvent): NdefMessage {
        val time = SimpleDateFormat("HH:mm:ss", Locale.getDefault()).format(Date())
        val text = "Beam me up!\nBeam Time: $time"
        return NdefMessage(arrayOf(
            createMimeRecord("application/com.example.beam", text.toByteArray())
        ))
    }

    override fun onNdefPushComplete(event: NfcEvent) {
        runOnUiThread { Toast.makeText(this, "Message sent!", Toast.LENGTH_LONG).show() }
    }

    private fun createMimeRecord(mimeType: String, payload: ByteArray): NdefRecord {
        val mimeBytes = mimeType.toByteArray(Charsets.US_ASCII)
        return NdefRecord(NdefRecord.TNF_MIME_MEDIA, mimeBytes, ByteArray(0), payload)
    }

    override fun onResume() {
        super.onResume()
        if (NfcAdapter.ACTION_NDEF_DISCOVERED == intent.action) processIntent(intent)
    }

    override fun onNewIntent(intent: Intent) {
        setIntent(intent)
    }

    private fun processIntent(intent: Intent) {
        val rawMsgs = intent.getParcelableArrayExtra(NfcAdapter.EXTRA_NDEF_MESSAGES)
        rawMsgs?.firstOrNull()?.let { msg ->
            textView.text = String(msg.records[0].payload)
        }
    }
}

模式二:讀寫 NFC 標籤 (Reader/Writer)

// 讀取
val tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)
val ndef = Ndef.get(tag)
ndef?.connect()
val messages = ndef.cachedNdefMessage
ndef.close()

// 寫入
val newMsg = NdefMessage(arrayOf(
    NdefRecord.createMime("text/plain", "Hello NFC".toByteArray())
))
ndef.writeNdefMessage(newMsg)

模式三:主機卡模擬 (HCE, API 19+)

  • 實作 HostApduService 回應 APDU 指令。
  • Manifest 宣告 android.nfc.cardemulation.action.HOST_APDU_SERVICE 並提供 android:apduServiceInfo XML。
  • 適用:交通票證、門禁卡、會員卡虛擬化。

常見問題與除錯

Q: Beam 無法觸發?
A: 確認雙裝置皆啟用 NFC、Android Beam、螢幕解鎖、App 在前景;檢查 MIME type 與 IntentFilter 完全一致。
Q: 標籤讀取失敗?
A: 標籤可能未格式化為 NDEF、或為獨家格式 (Mifare Classic 需額外權限 com.nxp.mifare)。
Q: HCE 服務未被喚醒?
A: 檢查 android:exported="true"、android:permission="android.permission.BIND_NFC_SERVICE"、AID 宣告正確。

NFC 開發關鍵在於 NDEF 封裝與 IntentFilter 精準比對,掌握三大模式即可覆蓋絕大多數應用場景。

copyright © 萬盛學電腦網 all rights reserved