ภาพรวม NFC ขั้นสูง

เอกสารนี้อธิบายหัวข้อ 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 ด้วย การมีฟังก์ชันสำรองนี้ช่วยให้คุณทำงานกับข้อมูลในแท็กได้โดยตรงหากระบบการส่งแท็กแยกวิเคราะห์ข้อมูลให้คุณไม่ได้ ขั้นตอนพื้นฐานเมื่อทำงานกับเทคโนโลยีแท็กมีดังนี้

  1. กรองหา Intent ACTION_TECH_DISCOVERED ที่ระบุเทคโนโลยีแท็กที่คุณต้องการจัดการ ดูข้อมูลเพิ่มเติมได้ที่การกรอง Intent ของ NFC โดยทั่วไป ระบบการส่งแท็กจะพยายามเริ่ม Intent ACTION_TECH_DISCOVERED เมื่อไม่สามารถแมปข้อความ NDEF กับประเภท MIME หรือ URI หรือหากแท็กที่สแกนไม่มีข้อมูล NDEF ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพิจารณาได้ที่ระบบการส่งแท็ก
  2. เมื่อแอปพลิเคชันได้รับ Intent ให้รับออบเจ็กต์ Tag จาก Intent ดังนี้

    Kotlin

    var tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)

    Java

    Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
  3. รับอินสแตนซ์ของ 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 ที่เหมาะสมไปยังแอปพลิเคชันของคุณได้ วิธีเปิดใช้ระบบการส่งข้อมูลเบื้องหน้า

  1. เพิ่มโค้ดต่อไปนี้ในเมธอด onCreate() ของกิจกรรม
    1. สร้างออบเจ็กต์ 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);
    2. ประกาศตัวกรอง Intent เพื่อจัดการ Intent ที่คุณต้องการสกัดกั้น ระบบการส่งข้อมูลเบื้องหน้าจะตรวจสอบตัวกรอง Intent ที่ระบุด้วย Intent ที่ได้รับเมื่ออุปกรณ์สแกนแท็ก หากตรงกัน แอปพลิเคชันของคุณจะจัดการ Intent หากไม่ตรงกัน ระบบการส่งข้อมูลเบื้องหน้าจะกลับไปใช้ระบบการส่งข้อมูล Intent การระบุอาร์เรย์ null ของตัวกรอง Intent และตัวกรองเทคโนโลยีจะระบุว่าคุณต้องการกรองแท็กทั้งหมดที่ใช้ Intent TAG_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, };
    3. ตั้งค่าอาร์เรย์ของเทคโนโลยีแท็กที่แอปพลิเคชันต้องการจัดการ เรียกใช้เมธอด Object.class.getName() เพื่อรับคลาสของเทคโนโลยีที่ต้องการรองรับ

      Kotlin

      techListsArray = arrayOf(arrayOf<String>(NfcF::class.java.name))

      Java

      techListsArray = new String[][] { new String[] { NfcF.class.getName() } };
  2. ลบล้าง Lifecycle Callback ของวงจรกิจกรรมต่อไปนี้และเพิ่มตรรกะเพื่อเปิดและปิดใช้การส่งเบื้องหน้าเมื่อกิจกรรมสูญเสีย (onPause()) และได้รับ (onResume()) โฟกัสอีกครั้ง ต้องเรียกใช้ enableForegroundDispatch() จากเธรดหลักและเฉพาะเมื่อกิจกรรมอยู่เบื้องหน้า (การเรียกใช้ใน onResume() จะรับประกันเรื่องนี้) นอกจากนี้ คุณยังต้องใช้ Callback 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
    }