เอกสารนี้อธิบายหัวข้อ NFC ขั้นสูง เช่น การทำงานกับเทคโนโลยีแท็กต่างๆ การเขียนลงในแท็ก NFC และการส่งข้อมูลเบื้องหน้า ซึ่งช่วยให้แอปพลิเคชันในเบื้องหน้าจัดการ Intent ได้แม้ว่าแอปพลิเคชันอื่นๆ จะกรอง Intent เดียวกันก็ตาม
ทำงานร่วมกับเทคโนโลยีแท็กที่รองรับ
เมื่อทำงานกับแท็ก NFC และอุปกรณ์ที่ทำงานด้วยระบบ Android รูปแบบหลักที่คุณใช้ในการอ่านและเขียนข้อมูลในแท็กคือ NDEF เมื่ออุปกรณ์สแกนแท็กที่มีข้อมูล NDEF ระบบ Android จะรองรับการแยกวิเคราะห์ข้อความและส่งข้อความใน NdefMessage เมื่อเป็นไปได้ อย่างไรก็ตาม มีบางกรณีที่คุณสแกนแท็กที่ไม่มีข้อมูล NDEF หรือเมื่อไม่สามารถแมปข้อมูล NDEF กับประเภท MIME หรือ URI ได้
ในกรณีเหล่านี้ คุณต้องเปิดการสื่อสารกับแท็กโดยตรง รวมถึงอ่านและเขียนแท็กด้วยโปรโตคอลของคุณเอง (ในรูปแบบไบต์ดิบ) Android รองรับ Use Case เหล่านี้โดยทั่วไปด้วยแพ็กเกจ android.nfc.tech ซึ่งอธิบายไว้ในตารางที่ 1 คุณสามารถใช้เมธอด getTechList() เพื่อระบุเทคโนโลยีที่แท็กรองรับและสร้างออบเจ็กต์ TagTechnology ที่เกี่ยวข้องด้วยคลาสใดคลาสหนึ่งที่ android.nfc.tech มีให้
ตารางที่ 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 |
ให้สิทธิ์เข้าถึงพร็อพเพอร์ตี้ MIFARE Classic และการดำเนินการ I/O หากอุปกรณ์ที่ใช้ Android เครื่องนี้รองรับ MIFARE |
MifareUltralight |
ให้สิทธิ์เข้าถึงพร็อพเพอร์ตี้ MIFARE Ultralight และการดำเนินการ I/O หากอุปกรณ์ที่ใช้ Android เครื่องนี้รองรับ MIFARE |
ทำงานกับเทคโนโลยีแท็กและ Intent ACTION_TECH_DISCOVERED
เมื่ออุปกรณ์สแกนแท็กที่มีข้อมูล NDEF แต่ไม่สามารถแมปกับ MIME หรือ URI ได้ ระบบการส่งแท็กจะพยายามเริ่มกิจกรรมด้วย Intent ACTION_TECH_DISCOVERED นอกจากนี้ ระบบจะใช้ ACTION_TECH_DISCOVERED เมื่อสแกนแท็กที่มีข้อมูลที่ไม่ใช่ NDEF ด้วย การมีฟังก์ชันสำรองนี้ช่วยให้คุณทำงานกับข้อมูลในแท็กได้โดยตรงหากระบบการส่งแท็กแยกวิเคราะห์ข้อมูลให้คุณไม่ได้ ขั้นตอนพื้นฐานเมื่อทำงานกับเทคโนโลยีแท็กมีดังนี้
- กรองหา Intent
ACTION_TECH_DISCOVEREDที่ระบุเทคโนโลยีแท็กที่คุณต้องการจัดการ ดูข้อมูลเพิ่มเติมได้ที่การกรอง Intent ของ NFC โดยทั่วไป ระบบการส่งแท็กจะพยายามเริ่ม IntentACTION_TECH_DISCOVEREDเมื่อไม่สามารถแมปข้อความ NDEF กับประเภท MIME หรือ URI หรือหากแท็กที่สแกนไม่มีข้อมูล NDEF ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพิจารณาได้ที่ระบบการส่งแท็ก - เมื่อแอปพลิเคชันได้รับ Intent ให้รับออบเจ็กต์
Tagจาก Intent ดังนี้Kotlin
var tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)
Java
Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
- รับอินสแตนซ์ของ
TagTechnologyโดยเรียกใช้เมธอดgetของคลาสในแพ็กเกจandroid.nfc.techคุณสามารถแจกแจงเทคโนโลยีที่รองรับของแท็กได้โดยเรียกใช้getTechList()ก่อนเรียกใช้เมธอดแฟกทอรีgetตัวอย่างเช่น หากต้องการรับอินสแตนซ์ของMifareUltralightจากTagให้ทำดังนี้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; } }
ใช้ระบบการส่งข้อมูลเบื้องหน้า
ระบบการส่งข้อมูลเบื้องหน้าช่วยให้กิจกรรมสามารถสกัดกั้น Intent และอ้างสิทธิ์ลำดับความสำคัญเหนือกิจกรรมอื่นๆ ที่จัดการ Intent เดียวกันได้ การใช้ระบบนี้เกี่ยวข้องกับการสร้างโครงสร้างข้อมูลบางอย่างเพื่อให้ระบบ Android สามารถส่ง Intent ที่เหมาะสมไปยังแอปพลิเคชันของคุณได้ วิธีเปิดใช้ระบบการส่งข้อมูลเบื้องหน้า
- เพิ่มโค้ดต่อไปนี้ในเมธอด
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
การระบุอาร์เรย์
nullของตัวกรอง Intent และตัวกรองเทคโนโลยีจะระบุว่าคุณต้องการกรองแท็กทั้งหมดที่ใช้ IntentTAG_DISCOVEREDเป็นทางเลือกสำรอง ข้อมูลโค้ดด้านล่างจะจัดการประเภท MIME ทั้งหมดสำหรับNDEF_DISCOVEREDคุณควรจัดการเฉพาะรายการที่ต้องการเท่านั้น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() } };
- สร้างออบเจ็กต์
- ลบล้าง Lifecycle Callback ของวงจรกิจกรรมต่อไปนี้และเพิ่มตรรกะเพื่อเปิดและปิดใช้การส่งเบื้องหน้าเมื่อกิจกรรมสูญเสีย (
onPause()) และได้รับ (onResume()) โฟกัสอีกครั้ง ต้องเรียกใช้enableForegroundDispatch()จากเธรดหลักและเฉพาะเมื่อกิจกรรมอยู่เบื้องหน้า (การเรียกใช้ในonResume()จะรับประกันเรื่องนี้) นอกจากนี้ คุณยังต้องใช้ CallbackonNewIntentเพื่อประมวลผลข้อมูลจากแท็ก 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 }