Android适配 - 实现4.3以后NFC的CardReader模式

Android 4.4更新了NFC的读卡器模式，具体API差异可以查看官方报告，本篇将梳理Android 4.3、Android 4.4以及之后版本的NFC读卡器模式的写法。(主要是对CPU卡的操作)

官方更新说明

新的 NFC 读取器模式允许 Activity 将所有 NFC Activity 限制为在前台时仅读取 Activity 感兴趣的标记类型。您可以使用 enableReaderMode() 为您的 Activity 启用读取器模式，提供一个 NfcAdapter.ReaderCallback 的实现，用于在检测到新的标记时接收回调。

Android 4.3 NFC读卡器模式

import android.app.PendingIntent;
import android.content.Intent;
import android.nfc.NfcAdapter;
import android.nfc.Tag;
import android.nfc.tech.IsoDep;
import android.nfc.tech.NfcF;
import android.os.Bundle;
import android.support.annotation.Nullable;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;import java.util.Arrays;/*** Created by ZP on 2017/9/20.*/public class NfcJellyBeanActivity extends AppCompatActivity {private static final String TAG = "NfcJellyBeanActivity";private NfcAdapter mNfcAdapter;private PendingIntent pendingIntent;@Overrideprotected void onCreate(@Nullable Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);mNfcAdapter = NfcAdapter.getDefaultAdapter(this);pendingIntent = PendingIntent.getActivity(this, 0, new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP), 0);}@Overrideprotected void onResume() {Log.d(TAG, "onResume: ");super.onResume();String[][] techListsArray = new String[][]{new String[]{NfcF.class.getName()},new String[]{IsoDep.class.getName()}};mNfcAdapter.enableForegroundDispatch(this, pendingIntent, null, techListsArray);}@Overrideprotected void onNewIntent(Intent intent) {super.onNewIntent(intent);if (intent != null) {Tag tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);Log.d(TAG, "onNewIntent: " + Arrays.toString(tag.getTechList()));} else {Log.d(TAG, "onNewIntent: ");}}@Overrideprotected void onPause() {Log.d(TAG, "onPause: ");super.onPause();mNfcAdapter.disableForegroundDispatch(this);}
}

在生命周期onResume和onPause分别启动和禁止读卡器模式，一旦CPU卡片贴到手机NFC感应区，将回调到onNewIntent，并且NFC读取到的Tag将从intent中获取。

卡片贴紧NFC感应处后，输出日志：

D/NfcJellyBeanActivity: onNewIntent: [android.nfc.tech.IsoDep, android.nfc.tech.NfcA]

关键在于调用了NfcAdapter.enableForegroundDispatch()方法，此方法有四个参数，官方注释对四个参数都进行了详细的说明。

第三个参数：涉及NFC标签的分发机制，官方说明如下图
第四个参数：当分发ACTION_TECH_DISCOVERED时，可以设置处理Tag的类型。
如果两个参数都设置为null，则全部Tag都分发给当前Activity进行处理。

Android 4.4 NFC读卡器模式

import android.content.Intent;
import android.nfc.NfcAdapter;
import android.nfc.Tag;
import android.os.Build;
import android.os.Bundle;
import android.support.annotation.Nullable;
import android.support.annotation.RequiresApi;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;import com.ppy.nfclib.Util;import java.util.Arrays;/*** Created by ZP on 2017/9/20.*/@RequiresApi(api = Build.VERSION_CODES.KITKAT)
public class NfcKikKatActivity extends AppCompatActivity {private static final String TAG = "NfcKikKatActivity";private static final int READER_FLAGS = NfcAdapter.FLAG_READER_NFC_A| NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK | NfcAdapter.FLAG_READER_NO_PLATFORM_SOUNDS;private NfcAdapter mNfcAdapter;private NfcAdapter.ReaderCallback mReaderCallback = new NfcAdapter.ReaderCallback() {@Overridepublic void onTagDiscovered(Tag tag) {Log.d(TAG, "onTagDiscovered: " + Arrays.toString(tag.getTechList()));}};@Overrideprotected void onCreate(@Nullable Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);}@Overrideprotected void onResume() {super.onResume();enableReaderMode();}@Overrideprotected void onPause() {super.onPause();disableReaderMode();}private void enableReaderMode() {Log.i(TAG, "Enabling reader mode");if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {NfcAdapter nfc = NfcAdapter.getDefaultAdapter(this);if (nfc != null) {nfc.enableReaderMode(this, mReaderCallback, READER_FLAGS, null);}}}private void disableReaderMode() {Log.i(TAG, "Disabling reader mode");if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {NfcAdapter nfc = NfcAdapter.getDefaultAdapter(this);if (nfc != null) {nfc.disableReaderMode(this);}}}
}

在生命周期onResume和onPause分别启动和禁止读卡器模式，一旦CPU卡片贴到手机NFC感应区，将回调到NfcAdapter.ReaderCallback，并且回调中返回NFC读取到的Tag。

卡片贴紧NFC感应处后，输出日志：

D/NfcKikKatActivity: onTagDiscovered: [android.nfc.tech.IsoDep, android.nfc.tech.NfcA]

Android 4.4之后关键在于调用了NfcAdapter.enableReaderMode() 方法，此方法需要四个参数，源码注释也给出详细说明。

第二个参数是回调，一旦读取到合适的Tag，将分发给当前Activity处理时，将Tag回调。
第三个参数是Flag，设置将处理Tag的类型，并且可以开启NFC读取到Tag时是否有系统默认声音。
第四个参数可以null，也可以传一个带有NfcAdapter.EXTRA_READER_PRESENCE_CHECK_DELAY 字段的Bundle，这个参数用于对卡片的延迟检测。

Android 4.4 更新的API

新增了NfcAdapter.EXTRA_READER_PRESENCE_CHECK_DELAY 用于Tag的回调
新增了一些Flag，值得注意的是FLAG_READER_NO_PLATFORM_SOUNDS，可以禁止NFC标签时默认的系统声音。

具体参考官网

NFC适配库

封装了一个NFC读卡器模式的库，主要是对CPU卡的操作API，Sample已经完成读取羊城通和深圳通的卡号、余额、交易记录。详情可以看Github，欢迎提Issue和PR，一起完善。
https://github.com/scauzhangpeng/NfcSample