Tài liệu này mô tả các tác vụ NFC cơ bản mà bạn thực hiện trong Android. Tài liệu này giải thích cách gửi và nhận dữ liệu NFC dưới dạng thông báo NDEF, đồng thời mô tả các API khung Android hỗ trợ những tính năng này. Để biết thêm các chủ đề nâng cao, bao gồm cả nội dung thảo luận về cách làm việc với dữ liệu không phải NDEF, hãy xem phần NFC nâng cao.
Việc đọc dữ liệu NDEF từ thẻ NFC được xử lý bằng hệ thống điều phối thẻ. Hệ thống này sẽ phân tích các thẻ NFC được phát hiện, phân loại dữ liệu một cách thích hợp và khởi động một ứng dụng quan tâm đến dữ liệu được phân loại. Ứng dụng muốn xử lý thẻ NFC đã quét có thể khai báo bộ lọc ý định và yêu cầu xử lý dữ liệu.
Hệ thống gửi thẻ
Thiết bị chạy Android thường tìm thẻ NFC khi màn hình được mở khoá, trừ phi NFC bị tắt trong trình đơn Cài đặt của thiết bị. Khi một thiết bị chạy Android phát hiện thấy thẻ NFC, hành vi bạn muốn là có hoạt động phù hợp nhất để xử lý ý định mà không cần hỏi người dùng nên sử dụng ứng dụng nào. Vì các thiết bị quét thẻ NFC ở phạm vi rất ngắn, nên việc yêu cầu người dùng chọn một hoạt động theo cách thủ công có thể buộc họ phải di chuyển thiết bị ra khỏi thẻ và làm mất kết nối. Bạn nên phát triển hoạt động của mình để chỉ xử lý các thẻ NFC mà hoạt động của bạn quan tâm, nhằm ngăn Trình chọn hoạt động xuất hiện.
Để giúp bạn đạt được mục tiêu này, Android cung cấp một hệ thống điều phối thẻ đặc biệt giúp phân tích các thẻ NFC đã quét, phân tích cú pháp và cố gắng tìm các ứng dụng quan tâm đến dữ liệu đã quét. Để làm được điều này, Google:
- Phân tích cú pháp thẻ NFC và tìm ra loại MIME hoặc URI xác định tải trọng dữ liệu trong thẻ.
- Đóng gói loại MIME hoặc URI và tải trọng vào một ý định. Hai bước đầu tiên này được mô tả trong phần Cách liên kết thẻ NFC với loại MIME và URI.
- Bắt đầu một hoạt động dựa trên ý định. Điều này được mô tả trong phần Cách gửi thẻ NFC đến ứng dụng.
Cách liên kết thẻ NFC với loại MIME và URI
Trước khi bắt đầu viết ứng dụng NFC, bạn cần hiểu rõ các loại thẻ NFC, cách hệ thống điều phối thẻ phân tích cú pháp thẻ NFC và công việc đặc biệt mà hệ thống điều phối thẻ thực hiện khi phát hiện thông báo NDEF. Thẻ NFC có nhiều loại công nghệ và cũng có thể được ghi dữ liệu theo nhiều cách. Android hỗ trợ nhiều nhất cho tiêu chuẩn NDEF, do Diễn đàn NFC xác định.
Dữ liệu NDEF được đóng gói bên trong một thông báo (NdefMessage) chứa một hoặc nhiều bản ghi (NdefRecord). Mỗi bản ghi NDEF phải được định dạng đúng theo thông số kỹ thuật của loại bản ghi mà bạn muốn tạo. Android
cũng hỗ trợ các loại thẻ khác không chứa dữ liệu NDEF. Bạn có thể xử lý các thẻ này bằng cách sử dụng
các lớp trong gói android.nfc.tech. Để tìm hiểu thêm về các công nghệ này, hãy xem chủ đề NFC nâng cao. Khi làm việc với các loại thẻ khác, bạn cần viết ngăn xếp giao thức riêng để giao tiếp với thẻ. Do đó, bạn nên sử dụng NDEF khi có thể để dễ dàng phát triển và hỗ trợ tối đa cho các thiết bị chạy Android.
Lưu ý: Để tải thông số kỹ thuật đầy đủ của NDEF xuống, hãy truy cập vào trang web Thông số kỹ thuật và tài liệu ứng dụng của Diễn đàn NFC và xem phần Tạo các loại bản ghi NDEF phổ biến để biết ví dụ về cách tạo bản ghi NDEF.
Giờ đây, khi bạn đã có một số thông tin cơ bản về thẻ NFC, các phần sau đây sẽ mô tả chi tiết hơn về cách Android xử lý các thẻ có định dạng NDEF. Khi một thiết bị chạy Android quét thẻ NFC chứa dữ liệu có định dạng NDEF, thiết bị đó sẽ phân tích cú pháp thông báo và cố gắng tìm ra loại MIME hoặc URI nhận dạng của dữ liệu. Để làm việc này, hệ thống sẽ đọc NdefRecord đầu tiên bên trong NdefMessage để xác định cách diễn giải toàn bộ thông báo NDEF (một thông báo NDEF có thể có nhiều bản ghi NDEF). Trong một thông báo NDEF đúng định dạng, NdefRecord đầu tiên chứa các trường sau:
- TNF (Định dạng tên loại) 3 bit
- Cho biết cách diễn giải trường loại có độ dài biến. Các giá trị hợp lệ được mô tả trong Bảng 1.
- Loại độ dài biến
- Mô tả loại bản ghi. Nếu sử dụng
TNF_WELL_KNOWN, hãy dùng trường này để chỉ định Định nghĩa loại bản ghi (RTD). Các giá trị RTD hợp lệ được mô tả trong Bảng 2. - Mã nhận dạng có độ dài biến đổi
- Giá trị nhận dạng riêng biệt cho bản ghi. Trường này không được sử dụng thường xuyên, nhưng nếu cần xác định riêng một thẻ, bạn có thể tạo mã nhận dạng cho thẻ đó.
- Tải trọng có độ dài biến
- Trọng tải dữ liệu thực tế mà bạn muốn đọc hoặc ghi. Thông báo NDEF có thể chứa nhiều bản ghi NDEF, vì vậy, đừng cho rằng toàn bộ tải trọng đều nằm trong bản ghi NDEF đầu tiên của thông báo NDEF.
Hệ thống điều phối thẻ sử dụng các trường TNF và loại để cố gắng liên kết loại MIME hoặc URI với thông báo NDEF. Nếu thành công, phương thức này sẽ đóng gói thông tin đó bên trong một ý định ACTION_NDEF_DISCOVERED cùng với tải trọng thực tế. Tuy nhiên, có những trường hợp hệ thống điều phối thẻ không thể xác định loại dữ liệu dựa trên bản ghi NDEF đầu tiên. Điều này xảy ra khi không thể liên kết dữ liệu NDEF với loại MIME hoặc URI, hoặc khi thẻ NFC không chứa dữ liệu NDEF ngay từ đầu. Trong những trường hợp như vậy, đối tượng Tag có thông tin về công nghệ của thẻ và tải trọng sẽ được đóng gói bên trong ý định ACTION_TECH_DISCOVERED.
Bảng 1 mô tả cách hệ thống điều phối thẻ liên kết các trường TNF và loại với loại MIME hoặc URI. Tài liệu này cũng mô tả những TNF không thể liên kết với loại MIME hoặc URI.
Trong những trường hợp này, hệ thống gửi thẻ sẽ quay lại ACTION_TECH_DISCOVERED.
Ví dụ: nếu hệ thống điều phối thẻ gặp một bản ghi thuộc loại TNF_ABSOLUTE_URI, thì hệ thống sẽ liên kết trường loại có độ dài biến của bản ghi đó vào một URI. Hệ thống điều phối thẻ đóng gói URI đó trong trường dữ liệu của ý định ACTION_NDEF_DISCOVERED cùng với thông tin khác về thẻ, chẳng hạn như tải trọng. Mặt khác, nếu gặp bản ghi thuộc loại TNF_UNKNOWN, thì ứng dụng sẽ tạo một ý định đóng gói công nghệ của thẻ.
Bảng 1. TNF được hỗ trợ và mối liên kết của chúng
| Định dạng tên loại (TNF) | Liên kết |
|---|---|
TNF_ABSOLUTE_URI |
URI dựa trên trường loại. |
TNF_EMPTY |
Quay lại ACTION_TECH_DISCOVERED. |
TNF_EXTERNAL_TYPE |
URI dựa trên URN trong trường loại. URN được mã hoá vào trường loại NDEF ở dạng rút gọn: <domain_name>:<service_name>.
Android liên kết mã này với một URI ở dạng: vnd.android.nfc://ext/<domain_name>:<service_name>. |
TNF_MIME_MEDIA |
Loại MIME dựa trên trường loại. |
TNF_UNCHANGED |
Không hợp lệ trong bản ghi đầu tiên, vì vậy, hãy quay lại
ACTION_TECH_DISCOVERED. |
TNF_UNKNOWN |
Quay lại ACTION_TECH_DISCOVERED. |
TNF_WELL_KNOWN |
Loại MIME hoặc URI tuỳ thuộc vào Định nghĩa loại bản ghi (RTD) mà bạn đặt trong trường loại. Hãy xem Bảng 2 để biết thêm thông tin về các RTD hiện có và mối liên kết của các RTD đó. |
Bảng 2. Các RTD được hỗ trợ cho TNF_WELL_KNOWN và mối liên kết của chúng
| Định nghĩa loại bản ghi (RTD) | Liên kết |
|---|---|
RTD_ALTERNATIVE_CARRIER |
Quay lại ACTION_TECH_DISCOVERED. |
RTD_HANDOVER_CARRIER |
Quay lại ACTION_TECH_DISCOVERED. |
RTD_HANDOVER_REQUEST |
Quay lại ACTION_TECH_DISCOVERED. |
RTD_HANDOVER_SELECT |
Quay lại ACTION_TECH_DISCOVERED. |
RTD_SMART_POSTER |
URI dựa trên việc phân tích cú pháp tải trọng. |
RTD_TEXT |
Loại MIME của text/plain. |
RTD_URI |
URI dựa trên tải trọng. |
Cách gửi thẻ NFC đến các ứng dụng
Khi hệ thống điều phối thẻ hoàn tất việc tạo một ý định đóng gói thẻ NFC và thông tin nhận dạng của thẻ, hệ thống sẽ gửi ý định đó đến một ứng dụng quan tâm lọc ý định. Nếu có nhiều ứng dụng có thể xử lý ý định, thì Trình chọn hoạt động sẽ xuất hiện để người dùng có thể chọn Hoạt động. Hệ thống điều phối thẻ xác định 3 ý định, được liệt kê theo thứ tự ưu tiên từ cao nhất đến thấp nhất:
-
ACTION_NDEF_DISCOVERED: Ý định này được dùng để bắt đầu một Hoạt động khi thẻ chứa tải trọng NDEF được quét và thuộc loại được nhận dạng. Đây là ý định có mức độ ưu tiên cao nhất và hệ thống điều phối thẻ sẽ cố gắng bắt đầu một Hoạt động có ý định này trước bất kỳ ý định nào khác, bất cứ khi nào có thể.Lưu ý: Kể từ Android 16, việc quét thẻ NFC lưu trữ đường liên kết trang web (tức là lược đồ URI là "http://" hoặc "https://") sẽ kích hoạt ý định
ACTION_VIEWthay vì ý địnhACTION_NDEF_DISCOVERED. Kể từ Android 17, việc quét thẻ như vậy sẽ hiển thị thông báo "mở đường liên kết", yêu cầu người dùng tương tác rõ ràng để kích hoạt ý địnhACTION_VIEW. ACTION_TECH_DISCOVERED: Nếu không có hoạt động nào đăng ký để xử lý ý địnhACTION_NDEF_DISCOVERED, thì hệ thống điều phối thẻ sẽ cố gắng khởi động một ứng dụng có ý định này. Ý định này cũng được bắt đầu trực tiếp (mà không bắt đầuACTION_NDEF_DISCOVEREDtrước) nếu thẻ được quét chứa dữ liệu NDEF không thể liên kết với loại MIME hoặc URI, hoặc nếu thẻ không chứa dữ liệu NDEF nhưng thuộc công nghệ thẻ đã biết.ACTION_TAG_DISCOVERED: Ý định này được bắt đầu nếu không có hoạt động nào xử lý ý địnhACTION_NDEF_DISCOVEREDhoặcACTION_TECH_DISCOVERED.
Hệ thống điều phối thẻ hoạt động theo cách cơ bản như sau:
- Cố gắng bắt đầu một Hoạt động bằng ý định do hệ thống điều phối thẻ tạo ra khi phân tích cú pháp thẻ NFC (
ACTION_NDEF_DISCOVEREDhoặcACTION_TECH_DISCOVERED). - Nếu không có hoạt động nào lọc cho ý định đó, hãy thử bắt đầu một Hoạt động có ý định ưu tiên thấp nhất tiếp theo (
ACTION_TECH_DISCOVEREDhoặcACTION_TAG_DISCOVERED) cho đến khi một ứng dụng lọc cho ý định đó hoặc cho đến khi hệ thống điều phối thẻ thử tất cả các ý định có thể. - Nếu không có ứng dụng nào lọc cho bất kỳ ý định nào, thì không làm gì cả.
Bất cứ khi nào có thể, hãy làm việc với thông báo NDEF và ý định ACTION_NDEF_DISCOVERED, vì đây là ý định cụ thể nhất trong số ba ý định. Ý định này cho phép bạn khởi động ứng dụng vào thời điểm thích hợp hơn so với hai ý định còn lại, mang lại trải nghiệm tốt hơn cho người dùng.
Yêu cầu quyền truy cập NFC trong tệp kê khai Android
Trước khi có thể truy cập vào phần cứng NFC của thiết bị và xử lý đúng cách ý định NFC, hãy khai báo các mục này trong tệp AndroidManifest.xml:
- Phần tử NFC
<uses-permission>để truy cập vào phần cứng NFC:<uses-permission android:name="android.permission.NFC" />
- Kể từ Android 17 (cấp độ API 37), để một activity được gửi ý định NFC, nếu ứng dụng nhắm đến SDK >
Build.VERSION_CODES.BAKLAVA, thì ứng dụng đó phải được bảo vệ bằng quyềnandroid.permission.DISPATCH_NFC_MESSAGE. Điều này đảm bảo rằng chỉ dịch vụ hệ thống NFC mới có thể gửi ý định đến hoạt động của bạn. Ngoài ra, hệ thống sẽ không gửi ý định NFC đến các ứng dụng đang ở trạng thái dừng (ví dụ: nếu người dùng chưa từng chạy ứng dụng hoặc ứng dụng đã bị buộc dừng).<activity android:name=".MyActivity" android:exported="true" android:permission="android.permission.DISPATCH_NFC_MESSAGE"> ... </activity>
- Phiên bản SDK tối thiểu mà ứng dụng của bạn có thể hỗ trợ. cấp độ API 9 chỉ hỗ trợ
gửi thẻ giới hạn bằng
ACTION_TAG_DISCOVEREDvà chỉ cấp quyền truy cập vào thông báo NDEF bằngEXTRA_NDEF_MESSAGESbổ sung. Không thể truy cập vào các thuộc tính thẻ hoặc thao tác I/O khác. cấp độ API 10 bao gồm tính năng hỗ trợ đọc/ghi toàn diện cũng như đẩy NDEF trên nền trước, còn cấp độ API cấp 14 cung cấp thêm các phương thức tiện lợi để tạo bản ghi NDEF.<uses-sdk android:minSdkVersion="10"/> - Phần tử
uses-featuređể ứng dụng của bạn chỉ xuất hiện trên Google Play cho các thiết bị có phần cứng NFC:<uses-feature android:name="android.hardware.nfc" android:required="true" />
Nếu ứng dụng của bạn sử dụng chức năng NFC nhưng chức năng đó không quan trọng đối với ứng dụng, thì bạn có thể bỏ qua phần tử
uses-featurevà kiểm tra xem có NFC hay không trong thời gian chạy bằng cách kiểm tra xemgetDefaultAdapter()có phải lànullhay không.
Lọc ý định NFC
Để khởi động ứng dụng khi một thẻ NFC mà bạn muốn xử lý được quét, ứng dụng của bạn có thể lọc một, hai hoặc cả ba ý định NFC trong tệp kê khai Android. Tuy nhiên, bạn thường muốn lọc ý định ACTION_NDEF_DISCOVERED để kiểm soát tốt nhất thời điểm ứng dụng khởi động. Ý định ACTION_TECH_DISCOVERED là một phương án dự phòng cho ACTION_NDEF_DISCOVERED khi không có ứng dụng nào lọc cho ACTION_NDEF_DISCOVERED hoặc khi tải trọng không phải là NDEF. Việc lọc theo ACTION_TAG_DISCOVERED thường là một danh mục quá chung chung để lọc. Nhiều ứng dụng sẽ lọc ACTION_NDEF_DISCOVERED hoặc ACTION_TECH_DISCOVERED trước ACTION_TAG_DISCOVERED, vì vậy, ứng dụng của bạn có xác suất khởi động thấp. ACTION_TAG_DISCOVERED chỉ được dùng làm phương án cuối cùng để các ứng dụng lọc trong trường hợp không có ứng dụng nào khác được cài đặt để xử lý ý định ACTION_NDEF_DISCOVERED hoặc ACTION_TECH_DISCOVERED.
Vì việc triển khai thẻ NFC có thể khác nhau và nhiều khi không nằm trong tầm kiểm soát của bạn, nên không phải lúc nào bạn cũng có thể thực hiện được điều này. Đó là lý do bạn có thể quay lại hai ý định còn lại khi cần thiết. Khi bạn có quyền kiểm soát các loại thẻ và dữ liệu được ghi, bạn nên sử dụng NDEF để định dạng thẻ. Các phần sau đây mô tả cách lọc cho từng loại ý định.
ACTION_NDEF_DISCOVERED
Để lọc ý định ACTION_NDEF_DISCOVERED, hãy khai báo bộ lọc ý định cùng với loại dữ liệu mà bạn muốn lọc. Ví dụ sau đây lọc các ý định ACTION_NDEF_DISCOVERED có loại MIME là text/plain:
<activity android:name=".MyActivity" android:exported="true" android:permission="android.permission.DISPATCH_NFC_MESSAGE"> <intent-filter> <action android:name="android.nfc.action.NDEF_DISCOVERED"/> <category android:name="android.intent.category.DEFAULT"/> <data android:mimeType="text/plain" /> </intent-filter> </activity>
Ví dụ sau đây lọc một URI ở dạng https://developer.android.com/index.html.
<activity android:name=".MyActivity" android:exported="true" android:permission="android.permission.DISPATCH_NFC_MESSAGE"> <intent-filter> <action android:name="android.nfc.action.NDEF_DISCOVERED"/> <category android:name="android.intent.category.DEFAULT"/> <data android:scheme="https" android:host="developer.android.com" android:pathPrefix="/index.html" /> </intent-filter> </activity>
ACTION_TECH_DISCOVERED
Nếu hoạt động của bạn lọc ý định ACTION_TECH_DISCOVERED, thì bạn phải tạo một tệp tài nguyên XML chỉ định các công nghệ mà hoạt động của bạn hỗ trợ trong một nhóm tech-list. Hoạt động của bạn được coi là phù hợp nếu một tập hợp tech-list là một tập hợp con của các công nghệ được thẻ hỗ trợ, bạn có thể lấy tập hợp này bằng cách gọi getTechList().
Ví dụ: nếu thẻ được quét hỗ trợ MifareClassic, NdefFormatable và NfcA, thì tập hợp tech-list của bạn phải chỉ định cả ba, hai hoặc một trong các công nghệ (và không có công nghệ nào khác) để hoạt động của bạn được so khớp.
Mẫu sau đây xác định tất cả công nghệ. Bạn phải xoá những bản ghi không được thẻ NFC hỗ trợ. Lưu tệp này (bạn có thể đặt tên tuỳ ý) trong thư mục <project-root>/res/xml.
<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2"> <tech-list> <tech>android.nfc.tech.IsoDep</tech> <tech>android.nfc.tech.NfcA</tech> <tech>android.nfc.tech.NfcB</tech> <tech>android.nfc.tech.NfcF</tech> <tech>android.nfc.tech.NfcV</tech> <tech>android.nfc.tech.Ndef</tech> <tech>android.nfc.tech.NdefFormatable</tech> <tech>android.nfc.tech.MifareClassic</tech> <tech>android.nfc.tech.MifareUltralight</tech> </tech-list> </resources>
Bạn cũng có thể chỉ định nhiều nhóm tech-list. Mỗi tập hợp tech-list được xem xét độc lập và hoạt động của bạn được coi là khớp nếu bất kỳ tập hợp tech-list nào là một tập hợp con của các công nghệ do getTechList() trả về. Điều này cung cấp ngữ nghĩa AND và OR cho các công nghệ so khớp. Ví dụ sau đây khớp với các thẻ có thể hỗ trợ công nghệ NfcA và Ndef hoặc có thể hỗ trợ công nghệ NfcB và Ndef:
<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2"> <tech-list> <tech>android.nfc.tech.NfcA</tech> <tech>android.nfc.tech.Ndef</tech> </tech-list> <tech-list> <tech>android.nfc.tech.NfcB</tech> <tech>android.nfc.tech.Ndef</tech> </tech-list> </resources>
Trong tệp AndroidManifest.xml, hãy chỉ định tệp tài nguyên mà bạn vừa tạo trong phần tử <meta-data> bên trong phần tử <activity> như trong ví dụ sau:
<activity android:name=".MyActivity" android:exported="true" android:permission="android.permission.DISPATCH_NFC_MESSAGE"> <intent-filter> <action android:name="android.nfc.action.TECH_DISCOVERED"/> </intent-filter> <meta-data android:name="android.nfc.action.TECH_DISCOVERED" android:resource="@xml/nfc_tech_filter" /> </activity>
Để biết thêm thông tin về cách làm việc với công nghệ thẻ và ý định ACTION_TECH_DISCOVERED, hãy xem phần Làm việc với công nghệ thẻ được hỗ trợ trong tài liệu NFC nâng cao.
ACTION_TAG_DISCOVERED
Lưu ý: ACTION_TAG_DISCOVERED không còn được dùng nữa kể từ Android 17 (cấp độ API 37). Thay vào đó, hãy sử dụng
ACTION_NDEF_DISCOVERED hoặc
ACTION_TECH_DISCOVERED.
Để lọc ACTION_TAG_DISCOVERED, hãy sử dụng bộ lọc ý định sau:
<activity android:name=".MyActivity" android:exported="true" android:permission="android.permission.DISPATCH_NFC_MESSAGE"> <intent-filter> <action android:name="android.nfc.action.TAG_DISCOVERED"/> </intent-filter> </activity>
ACTION_VIEW
Kể từ Android 16, việc quét thẻ NFC lưu trữ đường liên kết trang web (tức là lược đồ URI là "http://" hoặc "https://") sẽ kích hoạt ý định ACTION_VIEW thay vì ý định ACTION_NDEF_DISCOVERED. Kể từ Android 17, việc quét một thẻ như vậy sẽ hiển thị thông báo "mở đường liên kết", yêu cầu người dùng tương tác rõ ràng để kích hoạt ý định ACTION_VIEW. Để lọc ACTION_VIEW,
hãy tham khảo this. Sử dụng Android app links để mở ứng dụng cho URL.
Lấy thông tin từ ý định
Nếu một hoạt động bắt đầu do ý định NFC, bạn có thể lấy thông tin về thẻ NFC được quét từ ý định đó. Ý định có thể chứa các thành phần bổ sung sau đây, tuỳ thuộc vào thẻ được quét:
EXTRA_TAG(bắt buộc): Đối tượngTagđại diện cho thẻ được quét.EXTRA_NDEF_MESSAGES(không bắt buộc): Một mảng thông báo NDEF được phân tích cú pháp từ thẻ. Thông tin bổ sung này là bắt buộc đối với ý địnhACTION_NDEF_DISCOVERED.EXTRA_ID(không bắt buộc): Mã cấp thấp của thẻ.
Để lấy các dữ liệu bổ sung này, hãy kiểm tra xem hoạt động của bạn có được khởi chạy bằng một trong các ý định NFC hay không để đảm bảo rằng thẻ đã được quét, sau đó lấy dữ liệu bổ sung từ ý định. Ví dụ sau đây kiểm tra ý định ACTION_NDEF_DISCOVERED và nhận thông báo NDEF từ một ý định bổ sung.
Kotlin
override fun onNewIntent(intent: Intent) { super.onNewIntent(intent) ... if (NfcAdapter.ACTION_NDEF_DISCOVERED == intent.action) { intent.getParcelableArrayExtra(NfcAdapter.EXTRA_NDEF_MESSAGES)?.also { rawMessages -> val messages: List<NdefMessage> = rawMessages.map { it as NdefMessage } // Process the messages array. ... } } }
Java
@Override protected void onNewIntent(Intent intent) { super.onNewIntent(intent); ... if (NfcAdapter.ACTION_NDEF_DISCOVERED.equals(intent.getAction())) { Parcelable[] rawMessages = intent.getParcelableArrayExtra(NfcAdapter.EXTRA_NDEF_MESSAGES); if (rawMessages != null) { NdefMessage[] messages = new NdefMessage[rawMessages.length]; for (int i = 0; i < rawMessages.length; i++) { messages[i] = (NdefMessage) rawMessages[i]; } // Process the messages array. ... } } }
Ngoài ra, bạn có thể lấy đối tượng Tag từ ý định. Đối tượng này sẽ chứa tải trọng và cho phép bạn liệt kê các công nghệ của thẻ:
Kotlin
val tag: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)
Java
Tag tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
Tạo các loại bản ghi NDEF phổ biến
Phần này mô tả cách tạo các loại bản ghi NDEF phổ biến để giúp bạn khi ghi vào thẻ NFC. Kể từ Android 4.0 (cấp độ API 14), phương thức createUri() sẽ giúp bạn tự động tạo bản ghi URI. Kể từ Android 4.1 (cấp độ API 16),
createExternal()
và createMime() có thể giúp bạn tạo
MIME và bản ghi NDEF loại bên ngoài. Sử dụng các phương thức trợ giúp này bất cứ khi nào có thể để tránh sai sót khi tạo bản ghi NDEF theo cách thủ công.
Phần này cũng mô tả cách tạo bộ lọc ý định tương ứng cho bản ghi. Tất cả các ví dụ về bản ghi NDEF này phải nằm trong bản ghi NDEF đầu tiên của thông báo NDEF mà bạn đang ghi vào thẻ.
TNF_ABSOLUTE_URI
Lưu ý: Bạn nên sử dụng loại RTD_URI thay vì TNF_ABSOLUTE_URI vì loại này hiệu quả hơn.
Bạn có thể tạo bản ghi NDEF TNF_ABSOLUTE_URI theo cách sau:
Kotlin
val uriRecord = ByteArray(0).let { emptyByteArray -> NdefRecord( TNF_ABSOLUTE_URI, "https://developer.android.com/index.html".toByteArray(Charset.forName("US-ASCII")), emptyByteArray, emptyByteArray ) }
Java
NdefRecord uriRecord = new NdefRecord( NdefRecord.TNF_ABSOLUTE_URI , "https://developer.android.com/index.html".getBytes(Charset.forName("US-ASCII")), new byte[0], new byte[0]);
Bộ lọc ý định cho bản ghi NDEF trước đó sẽ có dạng như sau:
<activity android:name=".MyActivity" android:exported="true" android:permission="android.permission.DISPATCH_NFC_MESSAGE"> <intent-filter> <action android:name="android.nfc.action.NDEF_DISCOVERED" /> <category android:name="android.intent.category.DEFAULT" /> <data android:scheme="https" android:host="developer.android.com" android:pathPrefix="/index.html" /> </intent-filter> </activity>
TNF_MIME_MEDIA
Bạn có thể tạo bản ghi NDEF TNF_MIME_MEDIA theo những cách sau:
Sử dụng phương thức createMime():
Kotlin
val mimeRecord = NdefRecord.createMime( "application/vnd.com.example.android.beam", "Beam me up, Android".toByteArray(Charset.forName("US-ASCII")) )
Java
NdefRecord mimeRecord = NdefRecord.createMime("application/vnd.com.example.android.beam", "Beam me up, Android".getBytes(Charset.forName("US-ASCII")));
Tạo NdefRecord theo cách thủ công:
Kotlin
val mimeRecord = Charset.forName("US-ASCII").let { usAscii -> NdefRecord( NdefRecord.TNF_MIME_MEDIA, "application/vnd.com.example.android.beam".toByteArray(usAscii), ByteArray(0), "Beam me up, Android!".toByteArray(usAscii) ) }
Java
NdefRecord mimeRecord = new NdefRecord( NdefRecord.TNF_MIME_MEDIA , "application/vnd.com.example.android.beam".getBytes(Charset.forName("US-ASCII")), new byte[0], "Beam me up, Android!".getBytes(Charset.forName("US-ASCII")));
Bộ lọc ý định cho bản ghi NDEF trước đó sẽ có dạng như sau:
<activity android:name=".MyActivity" android:exported="true" android:permission="android.permission.DISPATCH_NFC_MESSAGE"> <intent-filter> <action android:name="android.nfc.action.NDEF_DISCOVERED" /> <category android:name="android.intent.category.DEFAULT" /> <data android:mimeType="application/vnd.com.example.android.beam" /> </intent-filter> </activity>
TNF_WELL_KNOWN có RTD_TEXT
Bạn có thể tạo bản ghi NDEF TNF_WELL_KNOWN theo cách sau:
Kotlin
fun createTextRecord(payload: String, locale: Locale, encodeInUtf8: Boolean): NdefRecord { val langBytes = locale.language.toByteArray(Charset.forName("US-ASCII")) val utfEncoding = if (encodeInUtf8) Charset.forName("UTF-8") else Charset.forName("UTF-16") val textBytes = payload.toByteArray(utfEncoding) val utfBit: Int = if (encodeInUtf8) 0 else 1 shl 7 val status = (utfBit + langBytes.size).toChar() val data = ByteArray(1 + langBytes.size + textBytes.size) data[0] = status.toByte() System.arraycopy(langBytes, 0, data, 1, langBytes.size) System.arraycopy(textBytes, 0, data, 1 + langBytes.size, textBytes.size) return NdefRecord(NdefRecord.TNF_WELL_KNOWN, NdefRecord.RTD_TEXT, ByteArray(0), data) }
Java
public NdefRecord createTextRecord(String payload, Locale locale, boolean encodeInUtf8) { byte[] langBytes = locale.getLanguage().getBytes(Charset.forName("US-ASCII")); Charset utfEncoding = encodeInUtf8 ? Charset.forName("UTF-8") : Charset.forName("UTF-16"); byte[] textBytes = payload.getBytes(utfEncoding); int utfBit = encodeInUtf8 ? 0 : (1 << 7); char status = (char) (utfBit + langBytes.length); byte[] data = new byte[1 + langBytes.length + textBytes.length]; data[0] = (byte) status; System.arraycopy(langBytes, 0, data, 1, langBytes.length); System.arraycopy(textBytes, 0, data, 1 + langBytes.length, textBytes.length); NdefRecord record = new NdefRecord(NdefRecord.TNF_WELL_KNOWN, NdefRecord.RTD_TEXT, new byte[0], data); return record; }
Bộ lọc ý định cho bản ghi NDEF trước đó sẽ có dạng như sau:
<activity android:name=".MyActivity" android:exported="true" android:permission="android.permission.DISPATCH_NFC_MESSAGE"> <intent-filter> <action android:name="android.nfc.action.NDEF_DISCOVERED" /> <category android:name="android.intent.category.DEFAULT" /> <data android:mimeType="text/plain" /> </intent-filter> </activity>
TNF_WELL_KNOWN có RTD_URI
Bạn có thể tạo bản ghi NDEF TNF_WELL_KNOWN theo những cách sau:
Sử dụng phương thức createUri(String):
Kotlin
val rtdUriRecord1 = NdefRecord.createUri("https://example.com")
Java
NdefRecord rtdUriRecord1 = NdefRecord.createUri("https://example.com");
Sử dụng phương thức createUri(Uri):
Kotlin
val rtdUriRecord2 = Uri.parse("https://example.com").let { uri -> NdefRecord.createUri(uri) }
Java
Uri uri = Uri.parse("https://example.com"); NdefRecord rtdUriRecord2 = NdefRecord.createUri(uri);
Tạo NdefRecord theo cách thủ công:
Kotlin
val uriField = "example.com".toByteArray(Charset.forName("US-ASCII")) val payload = ByteArray(uriField.size + 1) //add 1 for the URI Prefix payload [0] = 0x01 //prefixes https://www. to the URI System.arraycopy(uriField, 0, payload, 1, uriField.size) //appends URI to payload val rtdUriRecord = NdefRecord(NdefRecord.TNF_WELL_KNOWN, NdefRecord.RTD_URI, ByteArray(0), payload)
Java
byte[] uriField = "example.com".getBytes(Charset.forName("US-ASCII")); byte[] payload = new byte[uriField.length + 1]; //add 1 for the URI Prefix payload[0] = 0x01; //prefixes https://www. to the URI System.arraycopy(uriField, 0, payload, 1, uriField.length); //appends URI to payload NdefRecord rtdUriRecord = new NdefRecord( NdefRecord.TNF_WELL_KNOWN, NdefRecord.RTD_URI, new byte[0], payload);
Bộ lọc ý định cho bản ghi NDEF trước đó sẽ có dạng như sau:
<activity android:name=".MyActivity" android:exported="true" android:permission="android.permission.DISPATCH_NFC_MESSAGE"> <intent-filter> <action android:name="android.nfc.action.NDEF_DISCOVERED" /> <category android:name="android.intent.category.DEFAULT" /> <data android:scheme="https" android:host="example.com" android:pathPrefix="" /> </intent-filter> </activity>
TNF_EXTERNAL_TYPE
Bạn có thể tạo bản ghi NDEF TNF_EXTERNAL_TYPE theo những cách sau:
Sử dụng phương thức createExternal():
Kotlin
var payload: ByteArray //assign to your data val domain = "com.example" //usually your app's package name val type = "externalType" val extRecord = NdefRecord.createExternal(domain, type, payload)
Java
byte[] payload; //assign to your data String domain = "com.example"; //usually your app's package name String type = "externalType"; NdefRecord extRecord = NdefRecord.createExternal(domain, type, payload);
Tạo NdefRecord theo cách thủ công:
Kotlin
var payload: ByteArray ... val extRecord = NdefRecord( NdefRecord.TNF_EXTERNAL_TYPE, "com.example:externalType".toByteArray(Charset.forName("US-ASCII")), ByteArray(0), payload )
Java
byte[] payload; ... NdefRecord extRecord = new NdefRecord( NdefRecord.TNF_EXTERNAL_TYPE, "com.example:externalType".getBytes(Charset.forName("US-ASCII")), new byte[0], payload);
Bộ lọc ý định cho bản ghi NDEF trước đó sẽ có dạng như sau:
<activity android:name=".MyActivity" android:exported="true" android:permission="android.permission.DISPATCH_NFC_MESSAGE"> <intent-filter> <action android:name="android.nfc.action.NDEF_DISCOVERED" /> <category android:name="android.intent.category.DEFAULT" /> <data android:scheme="vnd.android.nfc" android:host="ext" android:pathPrefix="/com.example:externalType"/> </intent-filter> </activity>
Sử dụng TNF_EXTERNAL_TYPE để triển khai thẻ NFC chung hơn nhằm hỗ trợ tốt hơn cho cả thiết bị chạy Android và không chạy Android.
Lưu ý: URN cho TNF_EXTERNAL_TYPE có định dạng chuẩn là:
urn:nfc:ext:example.com:externalType, tuy nhiên, thông số kỹ thuật RTD của Diễn đàn NFC
khai báo rằng phần urn:nfc:ext: của URN phải được bỏ qua khỏi
bản ghi NDEF. Vì vậy, bạn chỉ cần cung cấp miền (example.com trong ví dụ) và loại (externalType trong ví dụ) được phân tách bằng dấu hai chấm.
Khi gửi TNF_EXTERNAL_TYPE, Android sẽ chuyển đổi urn:nfc:ext:example.com:externalType
URN thành vnd.android.nfc://ext/example.com:externalType URI, đây là nội dung mà bộ lọc ý định trong ví dụ khai báo.
Bản ghi ứng dụng Android
Được ra mắt trong Android 4.0 (cấp độ API 14), Bản ghi ứng dụng Android (AAR) giúp đảm bảo chắc chắn hơn rằng ứng dụng của bạn sẽ khởi động khi thẻ NFC được quét. AAR có tên gói của một ứng dụng được nhúng bên trong bản ghi NDEF. Bạn có thể thêm AAR vào bất kỳ bản ghi NDEF nào của thông báo NDEF, vì Android sẽ tìm kiếm toàn bộ thông báo NDEF cho AAR. Nếu tìm thấy một AAR, thì hệ thống sẽ khởi động ứng dụng dựa trên tên gói bên trong AAR. Nếu ứng dụng không có trên thiết bị, Google Play sẽ được khởi chạy để tải ứng dụng xuống.
AAR rất hữu ích nếu bạn muốn ngăn các ứng dụng khác lọc cùng một ý định và có khả năng xử lý các thẻ cụ thể mà bạn đã triển khai. AAR chỉ được hỗ trợ ở cấp ứng dụng, do quy định ràng buộc về tên gói, chứ không phải ở cấp Hoạt động như với bộ lọc ý định. Nếu bạn muốn xử lý một ý định ở cấp Hoạt động, hãy sử dụng bộ lọc ý định.
Nếu một thẻ chứa AAR, thì hệ thống điều phối thẻ sẽ điều phối theo cách sau:
- Hãy thử bắt đầu một Hoạt động bằng bộ lọc ý định như bình thường. Nếu Hoạt động khớp với ý định cũng khớp với AAR, hãy bắt đầu Hoạt động.
- Nếu Hoạt động lọc ý định không khớp với AAR, nếu nhiều Hoạt động có thể xử lý ý định hoặc nếu không có Hoạt động nào xử lý ý định, hãy khởi động ứng dụng do AAR chỉ định.
- Nếu không có ứng dụng nào có thể khởi động bằng AAR, hãy truy cập Google Play để tải ứng dụng xuống dựa trên AAR.
Lưu ý: Bạn có thể ghi đè AAR và hệ thống điều phối ý định bằng hệ thống điều phối trên nền trước. Hệ thống này cho phép một hoạt động trên nền trước được ưu tiên khi phát hiện thấy thẻ NFC. Với phương thức này, hoạt động phải ở nền trước để ghi đè AAR và hệ thống điều phối ý định.
Nếu vẫn muốn lọc các thẻ đã quét không chứa AAR, bạn có thể khai báo bộ lọc ý định như bình thường. Điều này rất hữu ích nếu ứng dụng của bạn quan tâm đến các thẻ khác không chứa AAR. Ví dụ: có thể bạn muốn đảm bảo rằng ứng dụng của mình xử lý các thẻ độc quyền mà bạn triển khai cũng như các thẻ chung do bên thứ ba triển khai. Xin lưu ý rằng AAR chỉ dành riêng cho các thiết bị Android 4.0 trở lên, vì vậy, khi triển khai thẻ, bạn nên sử dụng kết hợp AAR và loại MIME/URI để hỗ trợ nhiều thiết bị nhất có thể. Ngoài ra, khi triển khai thẻ NFC, hãy cân nhắc cách bạn muốn ghi thẻ NFC để hỗ trợ hầu hết các thiết bị (thiết bị chạy Android và các thiết bị khác). Bạn có thể làm việc này bằng cách xác định một loại MIME hoặc URI tương đối riêng biệt để giúp các ứng dụng dễ dàng phân biệt hơn.
Android cung cấp một API đơn giản để tạo AAR, createApplicationRecord(). Bạn chỉ cần nhúng AAR vào bất cứ đâu trong NdefMessage. Bạn không nên sử dụng bản ghi đầu tiên của NdefMessage, trừ phi AAR là bản ghi duy nhất trong NdefMessage. Điều này là do hệ thống Android kiểm tra bản ghi đầu tiên của NdefMessage để xác định loại MIME hoặc URI của thẻ, được dùng để tạo ý định cho các ứng dụng lọc. Mã sau đây cho bạn biết cách tạo một AAR:
Kotlin
val msg = NdefMessage( arrayOf( ..., NdefRecord.createApplicationRecord("com.example.android.beam") ) )
Java
NdefMessage msg = new NdefMessage( new NdefRecord[] { ..., NdefRecord.createApplicationRecord("com.example.android.beam")} ); )
Danh sách ứng dụng được phép quét thẻ NFC
Kể từ Android 16, người dùng sẽ được thông báo khi một ứng dụng nhận được ý định NFC đầu tiên để quét thẻ NFC. Người dùng có thể chọn không cho phép ứng dụng quét thẻ NFC nữa trong thông báo.
- Ứng dụng có thể kiểm tra xem người dùng đã cho phép ứng dụng quét thẻ NFC hay chưa bằng cách sử dụng
NfcAdapter.isTagIntentAllowed(). - Ứng dụng có thể nhắc người dùng cho phép quét thẻ NFC một lần nữa bằng cách gửi ý định
ACTION_CHANGE_TAG_INTENT_PREFERENCE.
Lưu ý: Bạn có thể truy cập vào danh sách cho phép của ứng dụng quét thẻ NFC trong phần Settings > Apps > Special app access > Launch via NFC.