এই ডকুমেন্টে NFC সংক্রান্ত উন্নত বিষয় বর্ণনা করা হয়েছে, যেমন বিভিন্ন ট্যাগ প্রযুক্তির সাথে কাজ করা, NFC ট্যাগে লেখা এবং ফোরগ্রাউন্ড ডিসপ্যাচিং, যা ফোরগ্রাউন্ডে থাকা কোনও অ্যাপ্লিকেশনকে ইনটেন্ট ম্যানেজ করার অনুমতি দেয়, এমনকি অন্যান্য অ্যাপ্লিকেশন একই ইনটেন্টের জন্য ফিল্টার করলেও।
কাজ করে এমন ট্যাগ টেকনোলজি ব্যবহার করা
NFC ট্যাগ এবং Android-চালিত ডিভাইসের সাথে কাজ করার সময়, ট্যাগে ডেটা পড়তে এবং লিখতে আপনি যে প্রধান ফর্ম্যাটটি ব্যবহার করেন তা হল NDEF। কোনও ডিভাইস NDEF ডেটা সহ ট্যাগ স্ক্যান করলে, Android মেসেজ পার্স করতে
এবং সম্ভব হলে NdefMessage-এ ডেলিভার করতে সহায়তা
করে। তবে, এমন কিছু পরিস্থিতি আছে যেখানে আপনি এমন ট্যাগ স্ক্যান করেন যাতে
NDEF ডেটা থাকে না অথবা NDEF ডেটা MIME-এর প্রকার বা URI-তে ম্যাপ করা যায় না।
এইসব ক্ষেত্রে, আপনাকে সরাসরি ট্যাগের সাথে যোগাযোগ করতে হবে এবং আপনার নিজস্ব প্রোটোকল (র বাইটে) ব্যবহার করে
এতে পড়তে ও লিখতে হবে। Android এইসব ব্যবহারের ক্ষেত্রে
android.nfc.tech প্যাকেজের মাধ্যমে সাধারণ সহায়তা প্রদান করে, যা সারণী ১-এ বর্ণনা করা হয়েছে। আপনি
getTechList() পদ্ধতি ব্যবহার করে ট্যাগ দ্বারা সমর্থিত প্রযুক্তি
নির্ধারণ করতে পারেন এবং android.nfc.tech দ্বারা প্রদত্ত ক্লাসগুলির একটির সাথে সংশ্লিষ্ট TagTechnology
অবজেক্ট তৈরি করতে পারেন
টেবিল ১. কাজ করে এমন ট্যাগ প্রযুক্তি
| শ্রেণী | বর্ণনা |
|---|---|
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-চালিত ডিভাইসে নিম্নলিখিত ট্যাগ প্রযুক্তি কাজ করার প্রয়োজন নেই।
সারণী ২. ঐচ্ছিক কাজ করে এমন ট্যাগ প্রযুক্তি
| শ্রেণী | বর্ণনা |
|---|---|
MifareClassic |
এই Android-পরিচালিত ডিভাইস MIFARE-এ কাজ করলে, MIFARE Classic প্রপার্টি এবং I/O অপারেশনে অ্যাক্সেস প্রদান করে। |
MifareUltralight |
এই Android-চালিত ডিভাইস MIFARE-এ কাজ করলে, MIFARE Ultralight প্রপার্টি এবং I/O অপারেশনে অ্যাক্সেস প্রদান করে। |
ট্যাগ টেকনোলজি ও ACTION_TECH_DISCOVERED ইনটেন্ট নিয়ে কাজ করা
কোনও ডিভাইস NDEF ডেটা আছে এমন ট্যাগ স্ক্যান করলে, কিন্তু MIME বা URI-তে ম্যাপ করা না গেলে,
ট্যাগ ডিসপ্যাচ সিস্টেম ACTION_TECH_DISCOVERED
ইনটেন্ট সহ অ্যাক্টিভিটি শুরু করার চেষ্টা করে। এছাড়াও, NDEF-নয় এমন ডেটা সহ ট্যাগ স্ক্যান করা হলে
ACTION_TECH_DISCOVERED ব্যবহার করা হয়। এই ফলব্যাক থাকলে, ট্যাগ ডিসপ্যাচ সিস্টেম আপনার জন্য এটি পার্স করতে না পারলে,
আপনি সরাসরি ট্যাগের ডেটা নিয়ে কাজ করতে পারবেন। ট্যাগ প্রযুক্তির সাথে কাজ করার সময় প্রাথমিক ধাপগুলি নিচে দেওয়া হল:
- আপনি যে ট্যাগ প্রযুক্তি ম্যানেজ করতে চান তা উল্লেখ করে
ACTION_TECH_DISCOVEREDইনটেন্টের জন্য ফিল্টার করুন। আরও তথ্যের জন্য NFC ইনটেন্টের জন্য ফিল্টার করা দেখুন। সাধারণত, ট্যাগ ডিসপ্যাচ সিস্টেমACTION_TECH_DISCOVEREDইনটেন্ট শুরু করার চেষ্টা করে যখন NDEF মেসেজ MIME টাইপ বা URI-তে ম্যাপ করা যায় না অথবা স্ক্যান করা ট্যাগে NDEF ডেটা থাকে না। এটি কীভাবে নির্ধারণ করা হয় সেই সম্পর্কে আরও জানতে, ট্যাগ ডিসপ্যাচ সিস্টেম দেখুন। - আপনার অ্যাপ্লিকেশন ইনটেন্ট পেলে, ইনটেন্ট থেকে
Tagঅবজেক্ট পান:Kotlin
var tagFromIntent: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)
জাভা
Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
android.nfc.techপ্যাকেজে ক্লাসেরgetফ্যাক্টরি পদ্ধতির মধ্যে একটিকে কল করেTagTechnology-এর একটি ইনস্ট্যান্স পান। আপনিgetফ্যাক্টরি মেথড কল করার আগেgetTechList()কল করে ট্যাগের কাজ করে এমন প্রযুক্তিগুলি গণনা করতে পারেন। যেমন,TagথেকেMifareUltralight-এর ইনস্ট্যান্স পেতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:Kotlin
MifareUltralight.get(intent.getParcelableExtra(NfcAdapter.EXTRA_TAG))
জাভা
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")) } } }
জাভা
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 সিস্টেমের জন্য কিছু ডেটা স্ট্রাকচার তৈরি করা যাতে আপনার অ্যাপ্লিকেশনে উপযুক্ত ইনটেন্ট পাঠানো যায়। ফোরগ্রাউন্ড ডিসপ্যাচ সিস্টেম চালু করতে:
- আপনার অ্যাক্টিভিটির
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)
জাভা
PendingIntent pendingIntent = PendingIntent.getActivity( this, 0, new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP), PendingIntent.FLAG_MUTABLE);
- আপনি যে ইনটেন্ট ইন্টারসেপ্ট করতে চান তা ম্যানেজ করার জন্য ইনটেন্ট ফিল্টার ঘোষণা করুন। ডিভাইস কোনও ট্যাগ স্ক্যান করলে,
যে ইনটেন্ট পাওয়া যায় তার সাথে নির্দিষ্ট ইনটেন্ট ফিল্টার ফোরগ্রাউন্ড
ডিসপ্যাচ সিস্টেম চেক করে। এটি মিলে গেলে, আপনার অ্যাপ্লিকেশন ইনটেন্ট ম্যানেজ করে। এটি ম্যাচ না করলে, ফোরগ্রাউন্ড ডিসপ্যাচ সিস্টেম ইনটেন্ট ডিসপ্যাচ সিস্টেমে ফিরে যায়।
ইনটেন্ট ফিল্টার ও প্রযুক্তি ফিল্টারের
nullঅ্যারে উল্লেখ করার অর্থ হল, আপনি সেইসব ট্যাগ ফিল্টার করতে চান যেগুলিTAG_DISCOVEREDইনটেন্টে ফলব্যাক করে। নিচের কোড স্নিপেটNDEF_DISCOVERED-এর জন্য সব MIME-এর প্রকার ম্যানেজ করে। আপনার প্রয়োজনীয় ইভেন্টগুলিই শুধু ম্যানেজ করা উচিত।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)
জাভা
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))
জাভা
techListsArray = new String[][] { new String[] { NfcF.class.getName() } };
- একটি পরিবর্তনযোগ্য
- নিম্নলিখিত অ্যাক্টিভিটি লাইফসাইকেল কলব্যাক ওভাররাইড করুন এবং অ্যাক্টিভিটি ফোকাস হারালে (
onPause()) এবং আবার ফিরে পেলে (onResume()) ফোরগ্রাউন্ড ডিসপ্যাচ চালু ও বন্ধ করার জন্য লজিক যোগ করুন।enableForegroundDispatch()অবশ্যই মূল থ্রেড থেকে কল করতে হবে এবং শুধুমাত্র যখন অ্যাক্টিভিটি ফোরগ্রাউন্ডে থাকে (onResume()-এ কল করা এটির গ্যারান্টি দেয়)। এছাড়াও, স্ক্যান করা NFC ট্যাগ থেকে ডেটা প্রসেস করার জন্য আপনাকেonNewIntentকলব্যাক প্রয়োগ করতে হবে।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 }
জাভা
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 }