Tài liệu này mô tả các chủ đề nâng cao về NFC, chẳng hạn như làm việc với nhiều công nghệ thẻ, ghi vào thẻ NFC và gửi ở nền trước, cho phép một ứng dụng ở nền trước xử lý ý định ngay cả khi các ứng dụng khác lọc cùng một ý định.
Làm việc với các công nghệ thẻ được hỗ trợ
Khi làm việc với thẻ NFC và thiết bị chạy Android, định dạng chính mà bạn sử dụng để đọc và ghi dữ liệu trên thẻ là NDEF. Khi một thiết bị quét thẻ có dữ liệu NDEF, Android sẽ hỗ trợ phân tích cú pháp thông báo và phân phối thông báo đó trong NdefMessage khi có thể. Tuy nhiên, có những trường hợp bạn quét một thẻ không chứa dữ liệu NDEF hoặc khi không thể liên kết dữ liệu NDEF với một loại MIME hoặc URI.
Trong những trường hợp này, bạn cần mở trực tiếp hoạt động giao tiếp với thẻ, đồng thời đọc và ghi vào thẻ bằng giao thức của riêng bạn (ở dạng byte thô). Android cung cấp dịch vụ hỗ trợ chung cho các trường hợp sử dụng này thông qua gói android.nfc.tech, được mô tả trong Bảng 1. Bạn có thể sử dụng phương thức getTechList() để xác định các công nghệ mà thẻ hỗ trợ và tạo đối tượng TagTechnology tương ứng bằng một trong các lớp do android.nfc.tech cung cấp
Bảng 1. Công nghệ thẻ được hỗ trợ
| Lớp | Mô tả |
|---|---|
TagTechnology |
Giao diện mà tất cả các lớp công nghệ thẻ phải triển khai. |
NfcA |
Cung cấp quyền truy cập vào các thuộc tính NFC-A (ISO 14443-3A) và các thao tác I/O. |
NfcB |
Cung cấp quyền truy cập vào các thuộc tính NFC-B (ISO 14443-3B) và các thao tác I/O. |
NfcF |
Cung cấp quyền truy cập vào các thuộc tính NFC-F (JIS 6319-4) và các thao tác I/O. |
NfcV |
Cung cấp quyền truy cập vào các thuộc tính NFC-V (ISO 15693) và các thao tác I/O. |
IsoDep |
Cung cấp quyền truy cập vào các thuộc tính ISO-DEP (ISO 14443-4) và các thao tác I/O. |
Ndef |
Cung cấp quyền truy cập vào dữ liệu NDEF và các thao tác trên thẻ NFC đã được định dạng là NDEF. |
NdefFormatable |
Cung cấp các thao tác định dạng cho thẻ có thể định dạng NDEF. |
Các công nghệ thẻ sau đây không bắt buộc phải được thiết bị chạy Android hỗ trợ.
Bảng 2. Công nghệ thẻ được hỗ trợ không bắt buộc
| Lớp | Mô tả |
|---|---|
MifareClassic |
Cung cấp quyền truy cập vào các thuộc tính MIFARE Classic và hoạt động I/O, nếu thiết bị chạy Android này hỗ trợ MIFARE. |
MifareUltralight |
Cung cấp quyền truy cập vào các thuộc tính MIFARE Ultralight và hoạt động I/O, nếu thiết bị chạy Android này hỗ trợ MIFARE. |
Làm việc với công nghệ thẻ và ý định ACTION_TECH_DISCOVERED
Khi một thiết bị quét thẻ có dữ liệu NDEF nhưng không thể liên kết với MIME hoặc URI, hệ thống điều phối thẻ sẽ cố gắng bắt đầu một hoạt động có ý định ACTION_TECH_DISCOVERED. ACTION_TECH_DISCOVERED cũng được dùng khi quét thẻ có dữ liệu không phải NDEF. Việc có phương án dự phòng này cho phép bạn làm việc trực tiếp với dữ liệu trên thẻ nếu hệ thống gửi thẻ không thể phân tích cú pháp cho bạn. Các bước cơ bản khi làm việc với công nghệ thẻ như sau:
- Lọc ý định
ACTION_TECH_DISCOVEREDchỉ định công nghệ thẻ mà bạn muốn xử lý. Hãy xem phần Lọc ý định NFC để biết thêm thông tin. Nhìn chung, hệ thống điều phối thẻ sẽ cố gắng bắt đầu một ý địnhACTION_TECH_DISCOVEREDkhi không thể liên kết thông báo NDEF với một loại MIME hoặc URI, hoặc nếu thẻ được quét không chứa dữ liệu NDEF. Để biết thêm thông tin về cách xác định điều này, hãy xem Hệ thống gửi thẻ. - Khi ứng dụng của bạn nhận được ý định, hãy lấy đối tượng
Tagtừ ý định:Kotlin
var tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)
Java
Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
- Lấy một thực thể của
TagTechnologybằng cách gọi một trong các phương thức nhà máygetcủa các lớp trong góiandroid.nfc.tech. Bạn có thể liệt kê các công nghệ được hỗ trợ của thẻ bằng cách gọigetTechList()trước khi gọi phương thức nhà máyget. Ví dụ: để lấy một thực thể củaMifareUltralighttừTag, hãy làm như sau:Kotlin
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG))
Java
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG));
Đọc và ghi vào thẻ
Việc đọc và ghi vào thẻ NFC bao gồm việc lấy thẻ từ ý định và mở giao tiếp với thẻ. Bạn phải xác định ngăn xếp giao thức của riêng mình để đọc và ghi dữ liệu vào thẻ. Tuy nhiên, hãy lưu ý rằng bạn vẫn có thể đọc và ghi dữ liệu NDEF khi làm việc trực tiếp với thẻ. Bạn có thể tự quyết định cách sắp xếp cấu trúc. Ví dụ sau đây cho thấy cách làm việc với thẻ 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; } }
Sử dụng hệ thống điều phối trên nền trước
Hệ thống điều phối trên nền trước cho phép một hoạt động chặn ý định và yêu cầu quyền ưu tiên so với các hoạt động khác xử lý cùng một ý định. Để sử dụng hệ thống này, bạn cần xây dựng một vài cấu trúc dữ liệu để hệ thống Android có thể gửi ý định thích hợp đến ứng dụng của bạn. Cách bật hệ thống điều phối trên nền trước:
- Thêm mã sau vào phương thức
onCreate()của hoạt động:- Tạo một đối tượng
PendingIntentcó thể thay đổi để hệ thống Android có thể điền thông tin chi tiết về thẻ khi quét thẻ.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);
- Khai báo bộ lọc ý định để xử lý các ý định mà bạn muốn chặn. Hệ thống điều phối trên nền trước sẽ kiểm tra các bộ lọc ý định được chỉ định bằng ý định nhận được khi thiết bị quét thẻ. Nếu khớp, thì ứng dụng của bạn sẽ xử lý ý định. Nếu không khớp, hệ thống điều phối trên nền trước sẽ quay lại hệ thống điều phối ý định.
Việc chỉ định một mảng
nullgồm các bộ lọc ý định và bộ lọc công nghệ cho biết rằng bạn muốn lọc tất cả các thẻ dự phòng cho ý địnhTAG_DISCOVERED. Đoạn mã dưới đây xử lý tất cả các loại MIME choNDEF_DISCOVERED. Bạn chỉ nên xử lý những sự kiện cần thiết.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, };
- Thiết lập một mảng công nghệ thẻ mà ứng dụng của bạn muốn xử lý. Gọi phương thức
Object.class.getName()để lấy lớp của công nghệ mà bạn muốn hỗ trợ.Kotlin
techListsArray = arrayOf(arrayOf<String>(NfcF::class.java.name))
Java
techListsArray = new String[][] { new String[] { NfcF.class.getName() } };
- Tạo một đối tượng
- Ghi đè các phương thức gọi lại trong vòng đời của activity sau đây và thêm logic để bật và tắt tính năng gửi trên nền trước khi activity mất (
onPause()) và lấy lại (onResume()) tiêu điểm.enableForegroundDispatch()phải được gọi từ luồng chính và chỉ khi hoạt động đang chạy ở nền trước (việc gọi trongonResume()sẽ đảm bảo điều này). Bạn cũng cần triển khai lệnh gọi lạionNewIntentđể xử lý dữ liệu từ thẻ NFC được quét.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 }