本文档介绍了 NFC 的高级主题,例如使用各种标签技术、写入 NFC 标签以及前台调度,这使前台应用能够处理 intent,即使其他应用过滤了相同的 intent 也是如此。
使用支持的标签技术
在处理 NFC 标签和 Android 设备时,您在标签上读取和写入数据所用的主要格式是 NDEF。当设备扫描包含 NDEF 数据的标签时,Android 会提供支持来解析消息,并尽可能在 NdefMessage 中传送消息。不过,在某些情况下,您扫描的标签不包含 NDEF 数据,或者 NDEF 数据无法映射到 MIME 类型或 URI。在这些情况下,您需要直接与标签建立通信,并使用您自己的协议(以原始字节形式)对标签进行读写。Android 通过 android.nfc.tech 软件包为这些用例提供通用支持,如表 1 中所述。您可以使用 getTechList() 方法确定该标签支持的技术,并使用 android.nfc.tech 提供的某个类创建相应的 TagTechnology 对象
表 1. 支持的标签技术
| 类 | 说明 |
|---|---|
TagTechnology |
这是所有标签技术类都必须实现的接口。 |
NfcA |
提供对 NFC-A (ISO 14443-3A) 属性和 I/O 操作的访问权限。 |
NfcB |
提供对 NFC-B (ISO 14443-3B) 属性和 I/O 操作的访问权限。 |
NfcF |
提供对 NFC-F (JIS 6319-4) 属性和 I/O 操作的访问权限。 |
NfcV |
提供对 NFC-V (ISO 15693) 属性和 I/O 操作的访问权限。 |
IsoDep |
提供对 ISO-DEP (ISO 14443-4) 属性和 I/O 操作的访问权限。 |
Ndef |
提供对已格式化为 NDEF 的 NFC 标签上的 NDEF 数据和操作的访问权限。 |
NdefFormatable |
为可设置为 NDEF 格式的标签提供格式化操作。 |
Android 设备无需支持以下代码技术。
表 2. 可选择支持的标签技术
| 类 | 说明 |
|---|---|
MifareClassic |
如果此 Android 设备支持 MIFARE,则提供对 MIFARE Classic 属性和 I/O 操作的访问权限。 |
MifareUltralight |
如果此 Android 设备支持 MIFARE,则提供对 MIFARE Ultralight 属性和 I/O 操作的访问权限。 |
将标签技术和 ACTION_TECH_DISCOVERED Intent 结合使用
当设备扫描包含 NDEF 数据但无法映射到 MIME 或 URI 的标签时,标签调度系统会尝试使用 ACTION_TECH_DISCOVERED intent 启动 activity。当扫描到包含非 NDEF 数据的标签时,也会使用 ACTION_TECH_DISCOVERED。有了此后备机制,如果标签分派系统无法为您解析标签,您就可以直接处理标签上的数据。使用代码技术时的基本步骤如下:
- 过滤
ACTION_TECH_DISCOVEREDintent,指定您要处理的标签技术。如需了解详情,请参阅过滤 NFC intent。通常,如果 NDEF 消息无法映射到 MIME 类型或 URI,或者扫描的标签不包含 NDEF 数据,则标签调度系统会尝试启动ACTION_TECH_DISCOVEREDintent。如需详细了解如何确定这一点,请参阅代码调度系统。 - 当您的应用收到 intent 时,请从 intent 中获取
Tag对象:Kotlin
var tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)
Java
Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
- 通过调用
android.nfc.tech软件包中类的某个get工厂方法,获取TagTechnology的实例。您可以在调用get工厂方法之前调用getTechList(),枚举该标签支持的技术。例如,如需从Tag获取MifareUltralight的实例,请执行以下操作:Kotlin
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG))
Java
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG));
对标签执行读写操作
对 NFC 标签进行读写操作涉及从 intent 获取标签并与标签建立通信。您必须定义自己的协议栈,才能对标签执行读写操作。但请注意,直接使用标签时,您仍然可以读取和写入 NDEF 数据。具体取决于您要如何设计其结构。以下示例展示了如何使用 MIFARE Ultralight 标签。
Kotlin
package com.example.android.nfc import android.nfc.Tag import android.nfc.tech.MifareUltralight import java.io.IOException import java.nio.charset.Charset class MifareUltralightTagTester { fun writeTag(tag: Tag, tagText: String) { MifareUltralight.get(tag)?.use { ultralight -> ultralight.connect() Charset.forName("US-ASCII").also { usAscii -> ultralight.writePage(4, "abcd".toByteArray(usAscii)) ultralight.writePage(5, "efgh".toByteArray(usAscii)) ultralight.writePage(6, "ijkl".toByteArray(usAscii)) ultralight.writePage(7, "mnop".toByteArray(usAscii)) } } } fun readTag(tag: Tag): String? { return MifareUltralight.get(tag)?.use { mifare -> mifare.connect() val payload = mifare.readPages(4) String(payload, Charset.forName("US-ASCII")) } } }
Java
package com.example.android.nfc; import android.nfc.Tag; import android.nfc.tech.MifareUltralight; import android.util.Log; import java.io.IOException; import java.nio.charset.Charset; public class MifareUltralightTagTester { private static final String TAG = MifareUltralightTagTester.class.getSimpleName(); public void writeTag(Tag tag, String tagText) { MifareUltralight ultralight = MifareUltralight.get(tag); try { ultralight.connect(); ultralight.writePage(4, "abcd".getBytes(Charset.forName("US-ASCII"))); ultralight.writePage(5, "efgh".getBytes(Charset.forName("US-ASCII"))); ultralight.writePage(6, "ijkl".getBytes(Charset.forName("US-ASCII"))); ultralight.writePage(7, "mnop".getBytes(Charset.forName("US-ASCII"))); } catch (IOException e) { Log.e(TAG, "IOException while writing MifareUltralight...", e); } finally { try { ultralight.close(); } catch (IOException e) { Log.e(TAG, "IOException while closing MifareUltralight...", e); } } } public String readTag(Tag tag) { MifareUltralight mifare = MifareUltralight.get(tag); try { mifare.connect(); byte[] payload = mifare.readPages(4); return new String(payload, Charset.forName("US-ASCII")); } catch (IOException e) { Log.e(TAG, "IOException while reading MifareUltralight message...", e); } finally { if (mifare != null) { try { mifare.close(); } catch (IOException e) { Log.e(TAG, "Error closing tag...", e); } } } return null; } }
使用前台调度系统
前台调度系统允许 activity 拦截 intent 并声明其优先级高于其他处理相同 intent 的 activity。使用此系统需要构建一些数据结构,以便 Android 系统能够向您的应用发送适当的 intent。要启用前台调度系统,请执行以下操作:
- 在 activity 的
onCreate()方法中添加以下代码:- 创建一个可变的
PendingIntent对象,以便 Android 系统在扫描标签时使用标签的详细信息填充该对象。Kotlin
val intent = Intent(this, javaClass).apply { addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP) } var pendingIntent: PendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_MUTABLE)
Java
PendingIntent pendingIntent = PendingIntent.getActivity( this, 0, new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP), PendingIntent.FLAG_MUTABLE);
- 声明 Intent 过滤器,以处理您要拦截的 Intent。前台调度系统会根据设备扫描标签时收到的 intent 检查指定的 intent 过滤器。如果匹配,那么应用会处理该 Intent。如果不匹配,前台调度系统会回退到 intent 调度系统。
指定 intent 过滤器和技术过滤器的
null数组,表示您要过滤回退到TAG_DISCOVEREDintent 的所有标签。以下代码段会处理NDEF_DISCOVERED的所有 MIME 类型。您应该只处理所需的操作。Kotlin
val ndef = IntentFilter(NfcAdapter.ACTION_NDEF_DISCOVERED).apply { try { addDataType("*/*") /* Handles all MIME based dispatches. You should specify only the ones that you need. */ } catch (e: IntentFilter.MalformedMimeTypeException) { throw RuntimeException("fail", e) } } intentFiltersArray = arrayOf(ndef)
Java
IntentFilter ndef = new IntentFilter(NfcAdapter.ACTION_NDEF_DISCOVERED); try { ndef.addDataType("*/*"); /* Handles all MIME based dispatches. You should specify only the ones that you need. */ } catch (MalformedMimeTypeException e) { throw new RuntimeException("fail", e); } intentFiltersArray = new IntentFilter[] {ndef, };
- 设置应用要处理的一组标签技术。调用
Object.class.getName()方法,获取您要支持的技术的类。Kotlin
techListsArray = arrayOf(arrayOf<String>(NfcF::class.java.name))
Java
techListsArray = new String[][] { new String[] { NfcF.class.getName() } };
- 创建一个可变的
- 替换以下 activity 生命周期回调,并添加逻辑以在 activity 失去 (
onPause()) 和重新获得 (onResume()) 焦点时启用和停用前台调度。enableForegroundDispatch()必须从主线程调用,并且只能在 activity 处于前台时调用(在onResume()中调用可保证这一点)。您还需要实现onNewIntent回调,以处理来自扫描的 NFC 标记的数据。Kotlin
public override fun onPause() { super.onPause() adapter.disableForegroundDispatch(this) } public override fun onResume() { super.onResume() adapter.enableForegroundDispatch(this, pendingIntent, intentFiltersArray, techListsArray) } public override fun onNewIntent(intent: Intent) { val tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG) // do something with tagFromIntent }
Java
public void onPause() { super.onPause(); adapter.disableForegroundDispatch(this); } public void onResume() { super.onResume(); adapter.enableForegroundDispatch(this, pendingIntent, intentFiltersArray, techListsArray); } public void onNewIntent(Intent intent) { Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG); // do something with tagFromIntent }