chrome.hid

বর্ণনা

সংযুক্ত HID ডিভাইসগুলির সাথে ইন্টারঅ্যাক্ট করতে chrome.hid API ব্যবহার করুন৷ এই API একটি অ্যাপের প্রেক্ষাপট থেকে HID অপারেশনগুলিতে অ্যাক্সেস প্রদান করে। এই API ব্যবহার করে, অ্যাপগুলি হার্ডওয়্যার ডিভাইসের ড্রাইভার হিসাবে কাজ করতে পারে। এই API দ্বারা উত্পন্ন ত্রুটিগুলি runtime.lastError সেট করে এবং ফাংশনের নিয়মিত কলব্যাক চালানোর মাধ্যমে রিপোর্ট করা হয়। এই ক্ষেত্রে কলব্যাকের নিয়মিত পরামিতিগুলি অনির্ধারিত হবে৷

অনুমতি

hid

প্রকারভেদ

DeviceFilter

বৈশিষ্ট্য

  • পণ্য আইডি

    সংখ্যা ঐচ্ছিক

    ডিভাইস পণ্য আইডি, শুধুমাত্র বিক্রেতা আইডি মেলে শুধুমাত্র চেক করা হয়.

  • ব্যবহার

    সংখ্যা ঐচ্ছিক

    HID ব্যবহার শনাক্তকারী, শুধুমাত্র HID ব্যবহার পৃষ্ঠা মেলে তবেই পরীক্ষা করা হয়।

  • ব্যবহার পৃষ্ঠা

    সংখ্যা ঐচ্ছিক

    HID ব্যবহার পৃষ্ঠা শনাক্তকারী।

  • বিক্রেতা আইডি

    সংখ্যা ঐচ্ছিক

    ডিভাইস বিক্রেতা আইডি।

GetDevicesOptions

বৈশিষ্ট্য

  • ফিল্টার

    ডিভাইস ফিল্টার [] ঐচ্ছিক

    কোনো প্রদত্ত ফিল্টারের সাথে মেলে এমন একটি ডিভাইস ফেরত দেওয়া হবে। একটি খালি ফিল্টার তালিকা অ্যাপটির অনুমতি আছে এমন সমস্ত ডিভাইস ফিরিয়ে দেবে।

  • পণ্য আইডি

    সংখ্যা ঐচ্ছিক

    অবচয়

    DeviceFilter.productId সেট করার সমতুল্য।

  • বিক্রেতা আইডি

    সংখ্যা ঐচ্ছিক

    অবচয়

    DeviceFilter.vendorId সেট করার সমতুল্য।

HidCollectionInfo

বৈশিষ্ট্য

  • রিপোর্ট আইডি

    সংখ্যা[]

    প্রতিবেদন আইডি যা সংগ্রহের এবং তার সন্তানদের অন্তর্গত।

  • ব্যবহার

    সংখ্যা

    পৃষ্ঠা-সংজ্ঞায়িত ব্যবহার শনাক্তকারী।

  • ব্যবহার পৃষ্ঠা

    সংখ্যা

    HID ব্যবহার পৃষ্ঠা শনাক্তকারী।

HidConnectInfo

বৈশিষ্ট্য

  • সংযোগ আইডি

    সংখ্যা

    অন্যান্য সমস্ত ফাংশনে এই সংযোগ সনাক্ত করতে ব্যবহৃত অস্বচ্ছ ID।

HidDeviceInfo

বৈশিষ্ট্য

  • সংগ্রহ

    HidCollectionInfo []

    এই ডিভাইসের রিপোর্ট বর্ণনাকারীদের থেকে শীর্ষ-স্তরের সংগ্রহ।

  • ডিভাইস আইডি

    সংখ্যা

    অস্বচ্ছ ডিভাইস আইডি।

  • maxFeatureReportSize

    সংখ্যা

    শীর্ষ-স্তরের সংগ্রহের সর্বাধিক বৈশিষ্ট্য প্রতিবেদন আকার।

  • maxInputReportSize

    সংখ্যা

    শীর্ষ-স্তরের সংগ্রহের সর্বাধিক ইনপুট রিপোর্ট আকার।

  • maxOutputReportSize

    সংখ্যা

    শীর্ষ-স্তরের সংগ্রহের সর্বোচ্চ আউটপুট রিপোর্টের আকার।

  • পণ্য আইডি

    সংখ্যা

    পণ্য আইডি।

  • পণ্যের নাম

    স্ট্রিং

    Chrome 46+

    উপলভ্য থাকলে পণ্যের নাম ডিভাইস থেকে পড়া।

  • রিপোর্ট বর্ণনাকারী

    অ্যারেবাফার

    কাঁচা ডিভাইস রিপোর্ট বর্ণনাকারী (উইন্ডোজে উপলব্ধ নয়)।

  • সিরিয়াল নম্বর

    স্ট্রিং

    Chrome 46+

    ডিভাইস থেকে পড়া সিরিয়াল নম্বর, যদি উপলব্ধ হয়।

  • বিক্রেতা আইডি

    সংখ্যা

    বিক্রেতা আইডি।

পদ্ধতি

connect()

প্রতিশ্রুতি
chrome.hid.connect(
  deviceId: number,
  callback?: function,
)

যোগাযোগের জন্য একটি HID ডিভাইসের সাথে একটি সংযোগ খুলুন।

পরামিতি

  • ডিভাইস আইডি

    সংখ্যা

    ডিভাইসটির HidDeviceInfo.deviceId খুলতে হবে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (connection: HidConnectInfo) => void

রিটার্নস

  • প্রতিশ্রুতি <HidConnectInfo>

    Chrome 117+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

disconnect()

প্রতিশ্রুতি
chrome.hid.disconnect(
  connectionId: number,
  callback?: function,
)

একটি ডিভাইস থেকে সংযোগ বিচ্ছিন্ন করুন. এটি কল করার পরে একটি ডিভাইসে ক্রিয়াকলাপগুলি চালানো নিরাপদ তবে কোনও প্রভাব নেই৷

পরামিতি

  • সংযোগ আইডি

    সংখ্যা

    connect মাধ্যমে connectionId ফিরে এসেছে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    () => void

রিটার্নস

  • প্রতিশ্রুতি <void>

    Chrome 117+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

getDevices()

প্রতিশ্রুতি
chrome.hid.getDevices(
  options: GetDevicesOptions,
  callback?: function,
)

সংযুক্ত HID ডিভাইসগুলি গণনা করুন৷

পরামিতি

  • বিকল্প

    GetDevicesOptions

    লক্ষ্য ডিভাইসে অনুসন্ধান করার জন্য বৈশিষ্ট্য.

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (devices: HidDeviceInfo[]) => void

রিটার্নস

  • প্রতিশ্রুতি < HidDeviceInfo []>

    Chrome 117+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

receive()

chrome.hid.receive(
  connectionId: number,
  callback: function,
)

ডিভাইস থেকে পরবর্তী ইনপুট রিপোর্ট পান।

পরামিতি

  • সংযোগ আইডি

    সংখ্যা

    connect মাধ্যমে connectionId ফিরে এসেছে।

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (reportId: number, data: ArrayBuffer) => void

    • রিপোর্ট আইডি

      সংখ্যা

      রিপোর্ট আইডি বা 0 না থাকলে।

    • তথ্য

      অ্যারেবাফার

      রিপোর্ট ডেটা, রিপোর্ট আইডি উপসর্গ (যদি উপস্থিত থাকে) সরানো হয়।

receiveFeatureReport()

প্রতিশ্রুতি
chrome.hid.receiveFeatureReport(
  connectionId: number,
  reportId: number,
  callback?: function,
)

ডিভাইস থেকে একটি বৈশিষ্ট্য রিপোর্ট অনুরোধ.

পরামিতি

  • সংযোগ আইডি

    সংখ্যা

    connect মাধ্যমে connectionId ফিরে এসেছে।

  • রিপোর্ট আইডি

    সংখ্যা

    রিপোর্ট আইডি, অথবা 0 না থাকলে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (data: ArrayBuffer) => void

    • তথ্য

      অ্যারেবাফার

      রিপোর্টের ডেটা, একটি রিপোর্ট আইডি উপসর্গ সহ যদি একটি ডিভাইস দ্বারা পাঠানো হয়।

রিটার্নস

  • প্রতিশ্রুতি <ArrayBuffer>

    Chrome 117+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

send()

প্রতিশ্রুতি
chrome.hid.send(
  connectionId: number,
  reportId: number,
  data: ArrayBuffer,
  callback?: function,
)

ডিভাইসে একটি আউটপুট রিপোর্ট পাঠান।

দ্রষ্টব্য: data একটি রিপোর্ট আইডি উপসর্গ অন্তর্ভুক্ত করবেন না। প্রয়োজনে যোগ করা হবে।

পরামিতি

  • সংযোগ আইডি

    সংখ্যা

    connect মাধ্যমে connectionId ফিরে এসেছে।

  • রিপোর্ট আইডি

    সংখ্যা

    রিপোর্ট আইডি ব্যবহার করতে হবে, অথবা 0 না থাকলে।

  • তথ্য

    অ্যারেবাফার

    প্রতিবেদনের তথ্য।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    () => void

রিটার্নস

  • প্রতিশ্রুতি <void>

    Chrome 117+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

sendFeatureReport()

প্রতিশ্রুতি
chrome.hid.sendFeatureReport(
  connectionId: number,
  reportId: number,
  data: ArrayBuffer,
  callback?: function,
)

ডিভাইসে একটি বৈশিষ্ট্য প্রতিবেদন পাঠান।

দ্রষ্টব্য: data একটি রিপোর্ট আইডি উপসর্গ অন্তর্ভুক্ত করবেন না। প্রয়োজনে যোগ করা হবে।

পরামিতি

  • সংযোগ আইডি

    সংখ্যা

    connect মাধ্যমে connectionId ফিরে এসেছে।

  • রিপোর্ট আইডি

    সংখ্যা

    রিপোর্ট আইডি ব্যবহার করতে হবে, অথবা 0 না থাকলে।

  • তথ্য

    অ্যারেবাফার

    প্রতিবেদনের তথ্য।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    () => void

রিটার্নস

  • প্রতিশ্রুতি <void>

    Chrome 117+

    প্রতিশ্রুতি শুধুমাত্র ম্যানিফেস্ট V3 এর জন্য সমর্থিত এবং পরবর্তীতে, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

ঘটনা

onDeviceAdded

chrome.hid.onDeviceAdded.addListener(
  callback: function,
)

সিস্টেমে একটি ডিভাইস যোগ করা হলে ইভেন্ট তৈরি হয়। ইভেন্টগুলি শুধুমাত্র সেই অ্যাপ এবং এক্সটেনশনগুলিতে সম্প্রচার করা হয় যাদের ডিভাইস অ্যাক্সেস করার অনুমতি রয়েছে৷ অনুমতিটি ইনস্টল করার সময় বা ব্যবহারকারীর ঐচ্ছিক অনুমতি গ্রহণ করার সময় দেওয়া হতে পারে ( permissions.request দেখুন)।

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (device: HidDeviceInfo) => void

onDeviceRemoved

chrome.hid.onDeviceRemoved.addListener(
  callback: function,
)

সিস্টেম থেকে একটি ডিভাইস সরানো হলে ইভেন্ট তৈরি হয়। দেখুন onDeviceAdded যার জন্য ইভেন্ট বিতরণ করা হয়।

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (deviceId: number) => void

    • ডিভাইস আইডি

      সংখ্যা