萬盛學電腦網

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

Android NFC 開發實戰:基於 Beam 的 NDEF 消息收發

NFC 基礎概念

  • NDEF (NFC Data Exchange Format): 輕量級數據交換格式,由一條或多條 NdefRecord 組成 NdefMessage。
  • Android Beam: 基於 NFC 的點對點數據傳輸(Android 4.0+),雙設備背靠背即可發送小數據(聯系人、網址、小文件)。
  • 關鍵類: NfcAdapter、NdefMessage、NdefRecord、CreateNdefMessageCallback、OnNdefPushCompleteCallback。

完整 Beam 發送端實現

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);
        }
    }
}

關鍵點解析

環節說明
啟用 NFCManifest 聲明 <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/配置信息,再走藍牙傳輸

接收端 Manifest 過濾器

<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 解析及大數據傳輸降級策略。

copyright © 萬盛學電腦網 all rights reserved