USB অ্যাক্সেসরি ওভারভিউ

USB অ্যাক্সেসরি মোড ব্যবহারকারীদের বিশেষভাবে Android-চালিত ডিভাইসের জন্য ডিজাইন করা USB হোস্ট হার্ডওয়্যার কানেক্ট করার অনুমতি দেয়। অ্যাক্সেসরিকে অবশ্যই Android অ্যাক্সেসরি ডেভেলপমেন্ট কিট ডকুমেন্টেশনে উল্লেখ করা Android অ্যাক্সেসরি প্রোটোকল মেনে চলতে হবে। এটি Android-চালিত ডিভাইসগুলিকে অনুমতি দেয় যা USB হোস্ট হিসাবে কাজ করতে পারে না তবুও USB হার্ডওয়্যারের সাথে ইন্টারঅ্যাক্ট করতে পারে। Android-চালিত ডিভাইস USB অ্যাক্সেসরি মোডে থাকলে, অ্যাটাচ করা Android USB অ্যাক্সেসরি হোস্ট হিসেবে কাজ করে, USB বাসে পাওয়ার প্রদান করে এবং কানেক্ট করা ডিভাইস গণনা করে। Android 3.1 (API লেভেল 12) USB অ্যাক্সেসরি মোডকে সাপোর্ট করে এবং এই ফিচারটি Android 2.3.4 (API লেভেল 10)-এ ব্যাকপোর্ট করা হয়েছে যাতে আরও বেশি সংখ্যক ডিভাইসে সাপোর্ট করা যায়।

সঠিক USB অ্যাক্সেসরি API বেছে নিন

যদিও USB অ্যাক্সেসরি API, Android 3.1-এ প্ল্যাটফর্মে চালু করা হয়েছিল, তবে এটি Google API অ্যাড-অন লাইব্রেরি ব্যবহার করে Android 2.3.4-এও উপলভ্য। যেহেতু এই API-গুলি এক্সটার্নাল লাইব্রেরি ব্যবহার করে ব্যাকপোর্ট করা হয়েছে, তাই USB অ্যাক্সেসরি মোড সাপোর্ট করার জন্য আপনি দুটি প্যাকেজ ইমপোর্ট করতে পারেন। Android-চালিত কোন ডিভাইসে আপনি সহায়তা করতে চান তার উপর নির্ভর করে, আপনাকে একটির পরিবর্তে অন্যটি ব্যবহার করতে হতে পারে:

  • com.android.future.usb: Android 2.3.4-এ USB অ্যাক্সেসরি মোড সাপোর্ট করার জন্য, Google APIs অ্যাড-অন লাইব্রেরিতে ব্যাকপোর্ট করা USB অ্যাক্সেসরি API অন্তর্ভুক্ত থাকে এবং সেগুলি এই নেমস্পেসে থাকে। Android 3.1-এ অ্যাড-অন লাইব্রেরির সাহায্যে লেখা অ্যাপ্লিকেশনকে সাপোর্ট করার জন্য এই নেমস্পেসের মধ্যে ক্লাস ইমপোর্ট ও কল করার সুবিধাও রয়েছে। এই অ্যাড-অন লাইব্রেরি হল android.hardware.usb অ্যাক্সেসরি API-এর চারপাশে একটি পাতলা র‍্যাপার এবং এটি USB হোস্ট মোডকে সমর্থন করে না।

    আপনি যদি USB অ্যাক্সেসরি মোড কাজ করে এমন সর্বাধিক সংখ্যক ডিভাইসে এটি ব্যবহার করতে চান, তাহলে অ্যাড-অন লাইব্রেরি ব্যবহার করুন এবং এই প্যাকেজ ইমপোর্ট করুন। মনে রাখবেন, সব Android 2.3.4 ডিভাইসে USB অ্যাক্সেসরি ফিচার কাজ নাও করতে পারে। প্রতিটি ডিভাইস প্রস্তুতকারক এই ক্ষমতাকে সমর্থন করবে কিনা তা সিদ্ধান্ত নেয়, যার কারণে আপনাকে এটি আপনার ম্যানিফেস্ট ফাইলে ঘোষণা করতে হবে।

  • android.hardware.usb: এই নেমস্পেসে এমন ক্লাস আছে যা Android 3.1-এ USB অ্যাক্সেসরি মোডকে সাপোর্ট করে। এই প্যাকেজ ফ্রেমওয়ার্ক API-এর অংশ হিসেবে অন্তর্ভুক্ত, তাই Android 3.1 কোনও অ্যাড-অন লাইব্রেরি ব্যবহার না করেই USB অ্যাক্সেসরি মোড সাপোর্ট করে। এই প্যাকেজটি ব্যবহার করুন যদি আপনি শুধুমাত্র Android 3.1 বা তার পরবর্তী ভার্সনের ডিভাইসগুলির জন্য চিন্তা করেন যেগুলিতে USB অ্যাক্সেসরি মোডের জন্য হার্ডওয়্যার সাপোর্ট রয়েছে, যা আপনি আপনার ম্যানিফেস্ট ফাইলে ঘোষণা করতে পারেন।

Google APIs অ্যাড-অন লাইব্রেরি ইনস্টল করা

আপনি অ্যাড-অন ইনস্টল করতে চাইলে, SDK Manager-এর মাধ্যমে Google APIs Android API 10 প্যাকেজ ইনস্টল করে তা করতে পারবেন। অ্যাড-অন লাইব্রেরি ইনস্টল করার ব্যাপারে আরও তথ্যের জন্য Google APIs অ্যাড-অন ইনস্টল করা দেখুন।

API ওভারভিউ

যেহেতু অ্যাড-অন লাইব্রেরি হল ফ্রেমওয়ার্ক API-এর জন্য একটি র‍্যাপার, তাই USB অ্যাক্সেসরি ফিচারকে সাপোর্ট করে এমন ক্লাসগুলি একই রকম। আপনি অ্যাড-অন লাইব্রেরি ব্যবহার করলেও android.hardware.usb-এর জন্য রেফারেন্স ডকুমেন্টেশন ব্যবহার করতে পারবেন।

মনে রাখবেন: তবে, অ্যাড-অন লাইব্রেরি এবং ফ্রেমওয়ার্ক API-এর মধ্যে সামান্য ব্যবহারের পার্থক্য রয়েছে যা আপনার জানা উচিত।

নিম্নলিখিত সারণীতে USB অ্যাক্সেসরি API-কে সাপোর্ট করে এমন ক্লাস বর্ণনা করা আছে:

শ্রেণী বর্ণনা
UsbManager কানেক্ট করা USB অ্যাক্সেসরি গণনা ও তার সাথে যোগাযোগ করতে দেয়।
UsbAccessory একটি USB অ্যাক্সেসরিকে উপস্থাপন করে এবং এর শনাক্তকরণ তথ্য অ্যাক্সেস করার পদ্ধতিগুলি ধারণ করে।

অ্যাড-অন লাইব্রেরি ও প্ল্যাটফর্ম API-এর মধ্যে ব্যবহারের পার্থক্য

Google APIs অ্যাড-অন লাইব্রেরি এবং প্ল্যাটফর্ম API-এর মধ্যে ব্যবহারের ক্ষেত্রে দুটি পার্থক্য রয়েছে।

আপনি অ্যাড-অন লাইব্রেরি ব্যবহার করলে, আপনাকে নিম্নলিখিত উপায়ে UsbManager অবজেক্ট পেতে হবে:

Kotlin

val manager = UsbManager.getInstance(this)

জাভা

UsbManager manager = UsbManager.getInstance(this);

আপনি অ্যাড-অন লাইব্রেরি ব্যবহার না করলে, আপনাকে অবশ্যই নিম্নলিখিত উপায়ে UsbManager অবজেক্ট পেতে হবে:

Kotlin

val manager = getSystemService(Context.USB_SERVICE) as UsbManager

জাভা

UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);

আপনি যখন ইনটেন্ট ফিল্টার সহ কানেক্ট করা অ্যাক্সেসরির জন্য ফিল্টার করেন, তখন UsbAccessory অবজেক্টটি ইনটেন্টের মধ্যে থাকে যা আপনার অ্যাপ্লিকেশনে পাস করা হয়। আপনি অ্যাড-অন লাইব্রেরি ব্যবহার করলে, আপনাকে নিম্নলিখিত উপায়ে UsbAccessory অবজেক্ট পেতে হবে:

Kotlin

val accessory = UsbManager.getAccessory(intent)

জাভা

UsbAccessory accessory = UsbManager.getAccessory(intent);

আপনি অ্যাড-অন লাইব্রেরি ব্যবহার না করলে, আপনাকে অবশ্যই নিম্নলিখিত উপায়ে UsbAccessory অবজেক্ট পেতে হবে:

Kotlin

val accessory = intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY) as UsbAccessory

জাভা

UsbAccessory accessory = (UsbAccessory) intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY);

Android ম্যানিফেস্ট সংক্রান্ত প্রয়োজনীয়তা

USB অ্যাক্সেসরি API-এর সাথে কাজ করার আগে আপনার অ্যাপ্লিকেশনের ম্যানিফেস্ট ফাইলে কী যোগ করতে হবে তা নিম্নলিখিত তালিকায় বর্ণনা করা হয়েছে। ম্যানিফেস্ট ও রিসোর্স ফাইলের উদাহরণ থেকে এইসব আইটেম কীভাবে ঘোষণা করতে হয় তা দেখানো হয়েছে:

  • যেহেতু সব Android-চালিত ডিভাইস USB অ্যাক্সেসরি API-কে সমর্থন করার গ্যারান্টি দেয় না, তাই একটি <uses-feature> এলিমেন্ট অন্তর্ভুক্ত করুন যা ঘোষণা করে যে আপনার অ্যাপ্লিকেশন android.hardware.usb.accessory ফিচারটি ব্যবহার করে।
  • আপনি অ্যাড-অন লাইব্রেরি ব্যবহার করলে, লাইব্রেরির জন্য com.android.future.usb.accessory উল্লেখ করে <uses-library> এলিমেন্ট যোগ করুন।
  • আপনি অ্যাড-অন লাইব্রেরি ব্যবহার করলে অ্যাপ্লিকেশনের ন্যূনতম SDK API লেভেল ১০-এ সেট করুন অথবা android.hardware.usb প্যাকেজ ব্যবহার করলে ১২-এ সেট করুন।
  • আপনি যদি চান যে আপনার অ্যাপ্লিকেশনটি একটি অ্যাটাচ করা USB অ্যাক্সেসরি সম্পর্কে বিজ্ঞপ্তি পাবে, তাহলে আপনার প্রধান অ্যাক্টিভিটিতে android.hardware.usb.action.USB_ACCESSORY_ATTACHED ইনটেন্টের জন্য একটি <intent-filter> এবং <meta-data> এলিমেন্ট পেয়ার নির্দিষ্ট করুন। <meta-data> এলিমেন্টটি একটি এক্সটার্নাল XML রিসোর্স ফাইলকে পয়েন্ট করে যা আপনি যে অ্যাক্সেসরি শনাক্ত করতে চান তার শনাক্তকরণ তথ্য ঘোষণা করে।

    XML রিসোর্স ফাইলে, আপনি যেসব অ্যাক্সেসরি ফিল্টার করতে চান, সেগুলির জন্য <usb-accessory> এলিমেন্ট ঘোষণা করুন। প্রতিটি <usb-accessory>-এ নিম্নলিখিত অ্যাট্রিবিউট থাকতে পারে:

    • manufacturer
    • model
    • version

    version-এ ফিল্টার করার সুবিধা চালু করা সাজেস্ট করা হয় না। কোনও অ্যাক্সেসরি বা ডিভাইস সবসময় ভার্সন স্ট্রিং উল্লেখ নাও করতে পারে (ইচ্ছাকৃত বা অনিচ্ছাকৃতভাবে)। আপনার অ্যাপ ফিল্টার করার জন্য কোনও ভার্সন অ্যাট্রিবিউট ঘোষণা করলে এবং অ্যাক্সেসরি বা ডিভাইস কোনও ভার্সন স্ট্রিং নির্দিষ্ট না করলে, এর ফলে Android-এর আগের ভার্সনে NullPointerException হয়। Android 12-এ এই সমস্যার সমাধান করা হয়েছে।

    res/xml/ ডিরেক্টরিতে রিসোর্স ফাইল সেভ করুন। রিসোর্স ফাইলের নাম (.xml এক্সটেনশন ছাড়া) <meta-data> এলিমেন্টে আপনার উল্লেখ করা নামের একই হতে হবে। XML রিসোর্স ফাইলের ফর্ম্যাটও নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

ম্যানিফেস্ট ও রিসোর্স ফাইলের উদাহরণ

নিচের উদাহরণে একটি স্যাম্পেল ম্যানিফেস্ট এবং তার সংশ্লিষ্ট রিসোর্স ফাইল দেখানো হয়েছে:

<manifest ...>
    <uses-feature android:name="android.hardware.usb.accessory" />
    
    <uses-sdk android:minSdkVersion="<version>" />
    ...
    <application>
      <uses-library android:name="com.android.future.usb.accessory" />
        <activity ...>
            ...
            <intent-filter>
                <action android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" />
            </intent-filter>

            <meta-data android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED"
                android:resource="@xml/accessory_filter" />
        </activity>
    </application>
</manifest>

এই ক্ষেত্রে, নিম্নলিখিত রিসোর্স ফাইলটি res/xml/accessory_filter.xml-এ সেভ করা উচিত এবং এটি নির্দিষ্ট করে যে সংশ্লিষ্ট মডেল, প্রস্তুতকারক এবং ভার্সন আছে এমন যেকোনও অ্যাক্সেসরি ফিল্টার করা উচিত। অ্যাক্সেসরি Android-পরিচালিত ডিভাইসে এইসব অ্যাট্রিবিউট পাঠায়:

<?xml version="1.0" encoding="utf-8"?>

<resources>
    <usb-accessory model="DemoKit" manufacturer="Google" version="1.0"/>
</resources>

অ্যাক্সেসরি ব্যবহার করা

ব্যবহারকারী Android-চালিত ডিভাইসে USB অ্যাক্সেসরি কানেক্ট করলে, Android সিস্টেম নির্ধারণ করতে পারে যে আপনার অ্যাপ্লিকেশন কানেক্ট করা অ্যাক্সেসরিতে আগ্রহী কিনা। যদি তা হয়, তাহলে আপনি চাইলে অ্যাক্সেসরির সাথে যোগাযোগ সেট-আপ করতে পারবেন। এটি করতে, আপনার অ্যাপ্লিকেশনকে:

  1. কানেক্ট করা অ্যাক্সেসরি খুঁজে পেতে, এমন ইনটেন্ট ফিল্টার ব্যবহার করুন যা অ্যাক্সেসরি অ্যাটাচ করা ইভেন্ট ফিল্টার করে অথবা কানেক্ট করা অ্যাক্সেসরি গণনা করে উপযুক্ত অ্যাক্সেসরি খুঁজে পায়।
  2. অ্যাক্সেসরির সাথে যোগাযোগ করার জন্য ব্যবহারকারীর অনুমতি নিন, যদি আগে থেকে অনুমতি না নেওয়া থাকে।
  3. উপযুক্ত ইন্টারফেস এন্ডপয়েন্টে ডেটা পড়া ও লেখার মাধ্যমে অ্যাক্সেসরির সাথে যোগাযোগ করুন।

অ্যাক্সেসরি খুঁজুন

ব্যবহারকারী কোনও অ্যাক্সেসরি কানেক্ট করলে বিজ্ঞপ্তি পাওয়ার জন্য ইনটেন্ট ফিল্টার ব্যবহার করে অথবা আগে থেকেই কানেক্ট করা আছে এমন অ্যাক্সেসরি গণনা করে, আপনার অ্যাপ্লিকেশন অ্যাক্সেসরি খুঁজে পেতে পারে। আপনি যদি চান যে আপনার অ্যাপ্লিকেশনটি আপনার পছন্দের একটি অ্যাক্সেসরি অটোমেটিক শনাক্ত করুক, তাহলে ইনটেন্ট ফিল্টার ব্যবহার করা কার্যকর। আপনি যদি কানেক্ট করা সব অ্যাক্সেসরির তালিকা পেতে চান অথবা আপনার অ্যাপ্লিকেশন যদি কোনও ইনটেন্টের জন্য ফিল্টার না করে, তাহলে কানেক্ট করা অ্যাক্সেসরি গণনা করা উপযোগী।

ইনটেন্ট ফিল্টার ব্যবহার করা

আপনার অ্যাপ্লিকেশন যাতে কোনও নির্দিষ্ট USB অ্যাক্সেসরি খুঁজে পায়, তার জন্য আপনি android.hardware.usb.action.USB_ACCESSORY_ATTACHED ইনটেন্ট ফিল্টার করার জন্য একটি ইনটেন্ট ফিল্টার নির্দিষ্ট করতে পারেন। এই ইনটেন্ট ফিল্টারের সাথে, আপনাকে একটি রিসোর্স ফাইল উল্লেখ করতে হবে যা USB অ্যাক্সেসরির প্রপার্টি উল্লেখ করে, যেমন প্রস্তুতকারক, মডেল এবং ভার্সন।

ইনটেন্ট ফিল্টার কীভাবে ঘোষণা করতে হয় তা নিম্নলিখিত উদাহরণ থেকে দেখুন:

<activity ...>
    ...
    <intent-filter>
        <action android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" />
    </intent-filter>

    <meta-data android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED"
        android:resource="@xml/accessory_filter" />
</activity>

নিম্নলিখিত উদাহরণে দেখানো হয়েছে যে আপনি যে USB অ্যাক্সেসরি ব্যবহার করতে চান তা উল্লেখ করে সংশ্লিষ্ট রিসোর্স ফাইল কীভাবে ঘোষণা করবেন:

<?xml version="1.0" encoding="utf-8"?>

<resources>
    <usb-accessory manufacturer="Google, Inc." model="DemoKit" version="1.0" />
</resources>

আপনার অ্যাক্টিভিটিতে, আপনি UsbAccessory পেতে পারেন যা ইনটেন্ট থেকে অ্যাটাচ করা অ্যাক্সেসরিকে এইভাবে দেখায় (অ্যাড-অন লাইব্রেরির সাথে):

Kotlin

val accessory = UsbManager.getAccessory(intent)

জাভা

UsbAccessory accessory = UsbManager.getAccessory(intent);

অথবা এইভাবে (প্ল্যাটফর্ম API-এর মাধ্যমে):

Kotlin

val accessory = intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY) as UsbAccessory

জাভা

UsbAccessory accessory = (UsbAccessory)intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY);

অ্যাক্সেসরি গণনা করুন

আপনার অ্যাপ্লিকেশন চলাকালীন, আপনার অ্যাপ্লিকেশনটি এমন অ্যাক্সেসরিজ গণনা করতে পারে যা নিজেদের শনাক্ত করেছে।

কানেক্ট করা সব USB অ্যাক্সেসরির অ্যারে পেতে getAccessoryList() পদ্ধতি ব্যবহার করুন:

Kotlin

val manager = getSystemService(Context.USB_SERVICE) as UsbManager
val accessoryList: Array<out UsbAccessory> = manager.accessoryList

জাভা

UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);
UsbAccessory[] accessoryList = manager.getAccessoryList();

মনে রাখবেন: একবারে শুধুমাত্র একটি কানেক্ট করা অ্যাক্সেসরি ব্যবহার করা যায়।

কোনও অ্যাক্সেসরির সাথে যোগাযোগ করার অনুমতি পাওয়া

USB অ্যাক্সেসরির সাথে যোগাযোগ করার আগে, আপনার অ্যাপ্লিকেশনকে অবশ্যই আপনার ব্যবহারকারীদের কাছ থেকে অনুমতি নিতে হবে।

মনে রাখবেন: আপনার অ্যাপ্লিকেশন কানেক্ট করা অ্যাক্সেসরি শনাক্ত করার জন্য ইনটেন্ট ফিল্টার ব্যবহার করলে, ব্যবহারকারী আপনার অ্যাপ্লিকেশনকে ইনটেন্ট ম্যানেজ করার অনুমতি দিলে, এটি অটোমেটিক অনুমতি পেয়ে যায়। যদি না হয়, তাহলে অ্যাক্সেসরির সাথে কানেক্ট করার আগে আপনার অ্যাপ্লিকেশনে স্পষ্টভাবে অনুমতি চাইতে হবে।

কিছু পরিস্থিতিতে স্পষ্টভাবে অনুমতি চাওয়ার প্রয়োজন হতে পারে, যেমন আপনার অ্যাপ্লিকেশন যখন আগে থেকেই কানেক্ট করা অ্যাক্সেসরিকে তালিকাভুক্ত করে এবং তারপর সেটির সাথে যোগাযোগ করতে চায়। কোনও অ্যাক্সেসরির সাথে যোগাযোগ করার চেষ্টা করার আগে আপনাকে অবশ্যই সেটি অ্যাক্সেস করার অনুমতি চেক করতে হবে। যদি না হয়, তাহলে ব্যবহারকারী অ্যাক্সেসরি অ্যাক্সেস করার অনুমতি না দিলে আপনি রানটাইম সমস্যা পাবেন।

স্পষ্টভাবে অনুমতি পেতে, প্রথমে একটি ব্রডকাস্ট রিসিভার তৈরি করুন। আপনি requestPermission()-এ কল করলে, ব্রডকাস্ট করা ইনটেন্ট এই রিসিভার শোনে। requestPermission()-এ কল করলে ব্যবহারকারীকে একটি ডায়ালগ দেখানো হয় যেখানে অ্যাক্সেসরির সাথে কানেক্ট করার অনুমতি চাওয়া হয়। নিম্নলিখিত স্যাম্পেল কোড থেকে জানা যায় কীভাবে ব্রডকাস্ট রিসিভার তৈরি করতে হয়:

Kotlin

private const val ACTION_USB_PERMISSION = "com.android.example.USB_PERMISSION"

private val usbReceiver = object : BroadcastReceiver() {

    override fun onReceive(context: Context, intent: Intent) {
        if (ACTION_USB_PERMISSION == intent.action) {
            synchronized(this) {
                val accessory: UsbAccessory? = intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY)

                if (intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)) {
                    accessory?.apply {
                        // call method to set up accessory communication
                    }
                } else {
                    Log.d(TAG, "permission denied for accessory $accessory")
                }
            }
        }
    }
}

জাভা

private static final String ACTION_USB_PERMISSION =
    "com.android.example.USB_PERMISSION";
private final BroadcastReceiver usbReceiver = new BroadcastReceiver() {

    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        if (ACTION_USB_PERMISSION.equals(action)) {
            synchronized (this) {
                UsbAccessory accessory = (UsbAccessory) intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY);

                if (intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)) {
                    if(accessory != null){
                        // call method to set up accessory communication
                    }
                }
                else {
                    Log.d(TAG, "permission denied for accessory " + accessory);
                }
            }
        }
    }
};

ব্রডকাস্ট রিসিভার রেজিস্টার করতে, আপনার অ্যাক্টিভিটিতে onCreate() পদ্ধতিতে এটি যোগ করুন:

Kotlin

private const val ACTION_USB_PERMISSION = "com.android.example.USB_PERMISSION"
...
val manager = getSystemService(Context.USB_SERVICE) as UsbManager
...
permissionIntent = PendingIntent.getBroadcast(this, 0, Intent(ACTION_USB_PERMISSION), 0)
val filter = IntentFilter(ACTION_USB_PERMISSION)
registerReceiver(usbReceiver, filter)

জাভা

UsbManager usbManager = (UsbManager) getSystemService(Context.USB_SERVICE);
private static final String ACTION_USB_PERMISSION =
    "com.android.example.USB_PERMISSION";
...
permissionIntent = PendingIntent.getBroadcast(this, 0, new Intent(ACTION_USB_PERMISSION), 0);
IntentFilter filter = new IntentFilter(ACTION_USB_PERMISSION);
registerReceiver(usbReceiver, filter);

অ্যাক্সেসরির সাথে কানেক্ট করার জন্য ব্যবহারকারীর থেকে অনুমতি চাওয়ার ডায়ালগ দেখাতে, requestPermission() মেথড কল করুন:

Kotlin

lateinit var accessory: UsbAccessory
...
usbManager.requestPermission(accessory, permissionIntent)

জাভা

UsbAccessory accessory;
...
usbManager.requestPermission(accessory, permissionIntent);

ব্যবহারকারী ডায়ালগের উত্তর দিলে, আপনার ব্রডকাস্ট রিসিভার সেই ইনটেন্ট পায় যাতে EXTRA_PERMISSION_GRANTED অতিরিক্ত থাকে, যা হল উত্তরকে উপস্থাপন করা বুলিয়ান। অ্যাক্সেসরির সাথে কানেক্ট করার আগে, এই অতিরিক্ত ভ্যালু সত্য কিনা তা চেক করুন।

অ্যাক্সেসরির সাথে যোগাযোগ করা

আপনি UsbManager ব্যবহার করে অ্যাক্সেসরির সাথে যোগাযোগ করতে পারেন যাতে একটি ফাইল ডেসক্রিপটর পাওয়া যায়, যার মাধ্যমে আপনি ইনপুট ও আউটপুট স্ট্রিম সেট-আপ করে ডেসক্রিপটরে ডেটা পড়তে ও লিখতে পারেন। স্ট্রিমগুলি অ্যাক্সেসরির ইনপুট এবং আউটপুট বাল্ক এন্ডপয়েন্টকে উপস্থাপন করে। আপনাকে অন্য থ্রেডে ডিভাইস ও অ্যাক্সেসরির মধ্যে কমিউনিকেশন সেট-আপ করতে হবে, যাতে আপনি মূল UI থ্রেড লক না করেন। নিম্নলিখিত উদাহরণে দেখানো হয়েছে যে কীভাবে কোনও অ্যাক্সেসরি খুলে তার সাথে যোগাযোগ করতে হয়:

Kotlin

private lateinit var accessory: UsbAccessory
private var fileDescriptor: ParcelFileDescriptor? = null
private var inputStream: FileInputStream? = null
private var outputStream: FileOutputStream? = null
...

private fun openAccessory() {
    Log.d(TAG, "openAccessory: $mAccessory")
    fileDescriptor = usbManager.openAccessory(accessory)
    fileDescriptor?.fileDescriptor?.also { fd ->
        inputStream = FileInputStream(fd)
        outputStream = FileOutputStream(fd)
        val thread = Thread(null, this, "AccessoryThread")
        thread.start()
    }
}

জাভা

UsbAccessory accessory;
ParcelFileDescriptor fileDescriptor;
FileInputStream inputStream;
FileOutputStream outputStream;
...

private void openAccessory() {
    Log.d(TAG, "openAccessory: " + accessory);
    fileDescriptor = usbManager.openAccessory(accessory);
    if (fileDescriptor != null) {
        FileDescriptor fd = fileDescriptor.getFileDescriptor();
        inputStream = new FileInputStream(fd);
        outputStream = new FileOutputStream(fd);
        Thread thread = new Thread(null, this, "AccessoryThread");
        thread.start();
    }
}

থ্রেডের run() পদ্ধতিতে, আপনি FileInputStream বা FileOutputStream অবজেক্ট ব্যবহার করে অ্যাক্সেসরিতে পড়তে ও লিখতে পারবেন। FileInputStream অবজেক্ট সহ কোনও অ্যাক্সেসরি থেকে ডেটা পড়ার সময়, আপনি যে বাফার ব্যবহার করছেন সেটি USB প্যাকেট ডেটা স্টোর করার জন্য যথেষ্ট বড় কিনা তা নিশ্চিত করুন। Android অ্যাক্সেসরি প্রোটোকল ১৬৩৮৪ বাইট পর্যন্ত প্যাকেট বাফার সাপোর্ট করে, তাই আপনি সরলতার জন্য সবসময় এই সাইজের বাফার ঘোষণা করতে পারেন।

মনে রাখবেন: লোয়ার লেভেলে, USB ফুল-স্পিড অ্যাক্সেসরির জন্য প্যাকেটগুলি ৬৪ বাইট এবং USB হাই-স্পিড অ্যাক্সেসরির জন্য ৫১২ বাইট। Android অ্যাক্সেসরি প্রোটোকল, দুটি স্পিডের জন্য প্যাকেটগুলিকে একসাথে একটি লজিক্যাল প্যাকেটে বান্ডিল করে যাতে এটি সহজ হয়।

Android-এ থ্রেড ব্যবহার করার ব্যাপারে আরও জানতে, প্রসেস ও থ্রেড দেখুন।

অ্যাক্সেসরির সাথে যোগাযোগ বন্ধ করুন

কোনও অ্যাক্সেসরির সাথে যোগাযোগ করা হয়ে গেলে বা অ্যাক্সেসরি বিচ্ছিন্ন হয়ে গেলে, close() কল করে আপনি যে ফাইল ডেসক্রিপটর খুলেছিলেন, সেটি বন্ধ করুন। ডিটাচ করা ইভেন্ট শোনার জন্য, নিচে দেখানো উদাহরণের মতো একটি ব্রডকাস্ট রিসিভার তৈরি করুন:

Kotlin

var usbReceiver: BroadcastReceiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {

        if (UsbManager.ACTION_USB_ACCESSORY_DETACHED == intent.action) {
            val accessory: UsbAccessory? = intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY)
            accessory?.apply {
                // call your method that cleans up and closes communication with the accessory
            }
        }
    }
}

জাভা

BroadcastReceiver usbReceiver = new BroadcastReceiver() {
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();

        if (UsbManager.ACTION_USB_ACCESSORY_DETACHED.equals(action)) {
            UsbAccessory accessory = (UsbAccessory)intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY);
            if (accessory != null) {
                // call your method that cleans up and closes communication with the accessory
            }
        }
    }
};

ম্যানিফেস্টের মধ্যে নয়, অ্যাপ্লিকেশনের মধ্যে ব্রডকাস্ট রিসিভার তৈরি করলে, আপনার অ্যাপ্লিকেশন শুধুমাত্র সেটি চলাকালীন বিচ্ছিন্ন ইভেন্টগুলি ম্যানেজ করতে পারে। এইভাবে, ডিটাচ করা ইভেন্টগুলি শুধুমাত্র বর্তমানে চলছে এমন অ্যাপ্লিকেশনে পাঠানো হয় এবং সমস্ত অ্যাপ্লিকেশনে ব্রডকাস্ট করা হয় না।