NFC (Near Field Communication) 讓裝置在 4 cm 內進行無線資料交換。Android 4.0+ 提供完整 API 支援 Peer-to-Peer (Android Beam)、Reader/Writer 模式 (讀寫 NDEF 標籤)、Card Emulation (HCE) 三大模式。本文以官方 Beam 範例為基礎,延伸至完整開發流程。
| 類別 | 用途 |
|---|---|
| NfcAdapter | NFC 控制器單例,啟用/停用、註冊回調 |
| NdefMessage / NdefRecord | NDEF 封裝資料結構 (MIME、URI、外部類型) |
| Tag | 被動標籤代表,透過 getTag() 取得 |
| NfcEvent | Beam 傳送事件,包含觸發時間 |
<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>
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)
}
}
}
// 讀取
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)
HostApduService 回應 APDU 指令。android.nfc.cardemulation.action.HOST_APDU_SERVICE 並提供 android:apduServiceInfo XML。com.nxp.mifare)。android:exported="true"、android:permission="android.permission.BIND_NFC_SERVICE"、AID 宣告正確。NFC 開發關鍵在於 NDEF 封裝與 IntentFilter 精準比對,掌握三大模式即可覆蓋絕大多數應用場景。