نظرة عامة على تقنية NFC المتقدمة

يصف هذا المستند مواضيع متقدّمة حول تكنولوجيا NFC، مثل العمل مع تقنيات العلامات المختلفة، والكتابة على علامات NFC، والإرسال في المقدّمة، ما يسمح لتطبيق في المقدّمة بالتعامل مع الأهداف حتى عندما تتم فلترة التطبيقات الأخرى للأهداف نفسها.

العمل باستخدام تكنولوجيات العلامات المتوافقة

عند العمل مع علامات NFC والأجهزة التي تعمل بنظام التشغيل Android، يكون التنسيق الرئيسي الذي تستخدمه لقراءة البيانات وكتابتها على العلامات هو NDEF. عندما يفحص جهاز علامة تحتوي على بيانات NDEF، يوفّر Android الدعم في تحليل الرسالة وتسليمها في NdefMessage عندما يكون ذلك ممكنًا. ومع ذلك، هناك حالات تقوم فيها بمسح علامة لا تحتوي على بيانات NDEF أو عندما يتعذر تعيين بيانات NDEF إلى نوع MIME أو URI. في هذه الحالات، عليك فتح الاتصال مباشرةً مع العلامة والقراءة والكتابة إليها باستخدام البروتوكول الخاص بك (بالبايتات الأولية). يوفّر Android دعمًا عامًا لحالات الاستخدام هذه من خلال حزمة android.nfc.tech الموضّحة في الجدول 1. يمكنك استخدام طريقة getTechList() لتحديد التكنولوجيات التي تتيحها العلامة وإنشاء عنصر TagTechnology المقابل باستخدام إحدى الفئات التي يوفّرها android.nfc.tech

الجدول 1: تكنولوجيات العلامات المتوافقة

الفئة الوصف
TagTechnology الواجهة التي يجب أن تنفّذها جميع فئات تكنولوجيا العلامات
NfcA يتيح الوصول إلى خصائص NFC-A (ISO 14443-3A) وعمليات الإدخال/الإخراج.
NfcB يتيح الوصول إلى خصائص NFC-B (ISO 14443-3B) وعمليات الإدخال/الإخراج.
NfcF يتيح الوصول إلى خصائص NFC-F (JIS 6319-4) وعمليات الإدخال/الإخراج.
NfcV يتيح الوصول إلى خصائص NFC-V (ISO 15693) وعمليات الإدخال/الإخراج.
IsoDep يتيح الوصول إلى خصائص ISO-DEP (ISO 14443-4) وعمليات الإدخال/الإخراج.
Ndef توفّر هذه الفئة إمكانية الوصول إلى بيانات NDEF والعمليات على علامات NFC التي تم تنسيقها بتنسيق NDEF.
NdefFormatable توفّر عمليات تنسيق للعلامات التي يمكن تنسيقها باستخدام NDEF.

لا يُشترط أن تكون تقنيات العلامات التالية متوافقة مع الأجهزة التي تعمل بنظام التشغيل Android.

الجدول 2: تكنولوجيات العلامات المتوافقة الاختيارية

الفئة الوصف
MifareClassic يتيح الوصول إلى خصائص MIFARE Classic وعمليات الإدخال/الإخراج، إذا كان هذا الجهاز الذي يعمل بنظام التشغيل Android متوافقًا مع MIFARE.
MifareUltralight يتيح الوصول إلى خصائص MIFARE Ultralight وعمليات الإدخال/الإخراج، إذا كان جهاز Android هذا متوافقًا مع MIFARE.

العمل باستخدام تكنولوجيات العلامات والهدف ACTION_TECH_DISCOVERED

عندما يمسح جهاز ضوئيًا علامة تحتوي على بيانات NDEF، ولكن لا يمكن ربطها بـ MIME أو معرّف موارد منتظم (URI)، يحاول نظام إرسال العلامات بدء نشاط باستخدام نية ACTION_TECH_DISCOVERED. يتم استخدام ACTION_TECH_DISCOVERED أيضًا عند مسح علامة تحتوي على بيانات غير متوافقة مع NDEF. يتيح لك هذا الإجراء الاحتياطي العمل مع البيانات على العلامة مباشرةً إذا لم يتمكّن نظام إرسال العلامات من تحليلها نيابةً عنك. في ما يلي الخطوات الأساسية عند استخدام تكنولوجيات العلامات:

  1. يمكنك الفلترة بحثًا عن هدف ACTION_TECH_DISCOVERED يحدّد تقنيات العلامات التي تريد التعامل معها. يمكنك الاطّلاع على فلترة أهداف NFC لمزيد من المعلومات. بشكل عام، يحاول نظام إرسال العلامات بدء نية ACTION_TECH_DISCOVERED عندما لا يمكن ربط رسالة NDEF بنوع MIME أو معرّف موارد منتظم (URI)، أو إذا كانت العلامة التي تم مسحها ضوئيًا لا تحتوي على بيانات NDEF. لمزيد من المعلومات حول كيفية تحديد ذلك، يُرجى الاطّلاع على نظام إرسال العلامات.
  2. عندما يتلقّى تطبيقك الغرض، يمكنك الحصول على عنصر Tag من الغرض:

    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 والكتابة عليها الحصول على العلامة من الغرض وفتح الاتصال بالعلامة. يجب تحديد حزمة البروتوكول الخاصة بك لقراءة البيانات وكتابتها في العلامة. ومع ذلك، تذكَّر أنّه لا يزال بإمكانك قراءة بيانات 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;
    }
}

استخدام نظام الإرسال في المقدّمة

يسمح نظام الإرسال في المقدّمة للنشاط باعتراض هدف والمطالبة بالأولوية على الأنشطة الأخرى التي تتعامل مع الهدف نفسه. يتضمن استخدام هذا النظام إنشاء بعض هياكل البيانات لنظام Android لكي يتمكن من إرسال الأهداف المناسبة إلى تطبيقك. لتفعيل نظام الإرسال في المقدّمة:

  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 filters لمعالجة intents التي تريد اعتراضها. يتحقّق نظام الإرسال في المقدّمة من intent filters المحدّدة مع intent الذي يتم تلقّيه عندما يفحص الجهاز علامة. وإذا تطابق، سيتولّى تطبيقك معالجة الطلب. وإذا لم يتطابق، يعود نظام الإرسال في المقدّمة إلى نظام إرسال الأهداف. يؤدي تحديد مصفوفة null من فلاتر الأهداف وفلاتر التكنولوجيا إلى تحديد أنّك تريد فلترة جميع العلامات التي تعود إلى هدف 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. يمكنك تجاوز عمليات الاستدعاء في إحدى مراحل النشاط التالية وإضافة منطق لتفعيل الإرسال في المقدّمة وإيقافه عندما يفقد النشاط التركيز (onPause()) ويستعيده (onResume()). يجب استدعاء enableForegroundDispatch() من سلسلة التعليمات الرئيسية وفقط عندما يكون النشاط في المقدّمة (يضمن استدعاء 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
    }