NdefRecord 組成 NdefMessage。NfcAdapter、NdefMessage、NdefRecord、CreateNdefMessageCallback、OnNdefPushCompleteCallback。public class BeamActivity extends Activity
implements NfcAdapter.CreateNdefMessageCallback, NfcAdapter.OnNdefPushCompleteCallback {
private NfcAdapter nfcAdapter;
private TextView infoText;
private static final int MESSAGE_SENT = 1;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_beam);
infoText = findViewById(R.id.textView);
nfcAdapter = NfcAdapter.getDefaultAdapter(this);
if (nfcAdapter == null) {
infoText.setText("設備不支援 NFC");
return;
}
// 註冊回調:生成 NDEF 消息、發送完成通知
nfcAdapter.setNdefPushMessageCallback(this, this);
nfcAdapter.setOnNdefPushCompleteCallback(this, this);
}
// 1. 構建要發送的 NDEF 消息
@Override
public NdefMessage createNdefMessage(NfcEvent event) {
String text = "Beam me up!\nTime: " + System.currentTimeMillis();
NdefRecord mimeRecord = createMimeRecord(
"application/com.example.android.beam", text.getBytes(StandardCharsets.UTF_8));
return new NdefMessage(new NdefRecord[]{mimeRecord});
}
// 2. 發送完成回調(運行在 Binder 線程,需 Handler 切主線程)
@Override
public void onNdefPushComplete(NfcEvent event) {
handler.obtainMessage(MESSAGE_SENT).sendToTarget();
}
private final Handler handler = new Handler(Looper.getMainLooper()) {
@Override
public void handleMessage(Message msg) {
if (msg.what == MESSAGE_SENT) {
Toast.makeText(BeamActivity.this, "消息已發送!", Toast.LENGTH_LONG).show();
}
}
};
// 3. 自定義 MIME 類型 Record
private NdefRecord createMimeRecord(String mimeType, byte[] payload) {
byte[] mimeBytes = mimeType.getBytes(StandardCharsets.US_ASCII);
return new NdefRecord(NdefRecord.TNF_MIME_MEDIA, mimeBytes, new byte[0], payload);
}
// 4. 接收端處理(在 onResume/onNewIntent 中)
@Override
protected void onResume() {
super.onResume();
if (NfcAdapter.ACTION_NDEF_DISCOVERED.equals(getIntent().getAction())) {
processIntent(getIntent());
}
}
@Override
protected void onNewIntent(Intent intent) {
setIntent(intent); // 更新 Intent 供下次 onResume 處理
}
private void processIntent(Intent intent) {
Parcelable[] rawMsgs = intent.getParcelableArrayExtra(NfcAdapter.EXTRA_NDEF_MESSAGES);
if (rawMsgs != null && rawMsgs.length > 0) {
NdefMessage msg = (NdefMessage) rawMsgs[0];
String payload = new String(msg.getRecords()[0].getPayload(), StandardCharsets.UTF_8);
infoText.setText(payload);
}
}
}
| 環節 | 說明 |
|---|---|
| 啟用 NFC | Manifest 聲明 <uses-permission android:name="android.permission.NFC"/> 及 <uses-feature android:name="android.hardware.nfc" android:required="true"/> |
| 前台調度系統 | Activity 需在 onResume 啟用 enableForegroundDispatch 搶佔 NDEF 意圖(Beam 模式下由系統自動處理,普通 Tag 讀取需手動啟用) |
| AAR (Android Application Record) | 在 NdefMessage 末尾添加 AAR 可確保接收端無應用時跳轉 Play Store 安裝指定包名 |
| 大數據傳輸 | Beam 仅适合小數據(<1KB)。大文件需用 Bluetooth Handover:NFC 交換 BT MAC/配置信息,再走藍牙傳輸 |
<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.android.beam"/>
</intent-filter>
</activity>
Android Beam 提供了極簡的 NFC 點對點體驗。核心流程:獲取 Adapter → 註冊創建消息回調 → 構建 NdefMessage (MIME Record) → 發送完成回調 → 接收端通過 Intent 過濾器解析 Payload。實際項目中需處理 NFC 狀態變化、異常捕獲、多類型 Record 解析及大數據傳輸降級策略。