chrome.hid

شرح

از chrome.hid API برای تعامل با دستگاه های HID متصل استفاده کنید. این API دسترسی به عملیات HID را از درون زمینه یک برنامه فراهم می کند. با استفاده از این API، برنامه ها می توانند به عنوان درایور برای دستگاه های سخت افزاری عمل کنند. خطاهای ایجاد شده توسط این API با تنظیم runtime.lastError و اجرای فراخوان معمولی تابع گزارش می شود. در این مورد، پارامترهای عادی تماس برگشتی تعریف نشده خواهند بود.

مجوزها

hid

انواع

DeviceFilter

خواص

  • شناسه محصول

    شماره اختیاری

    شناسه محصول دستگاه، فقط در صورتی بررسی می‌شود که شناسه فروشنده مطابقت داشته باشد.

  • استفاده

    شماره اختیاری

    شناسه استفاده از HID، فقط در صورتی بررسی می‌شود که صفحه استفاده از HID مطابقت داشته باشد.

  • صفحه استفاده

    شماره اختیاری

    شناسه صفحه استفاده HID.

  • شناسه فروشنده

    شماره اختیاری

    شناسه فروشنده دستگاه

GetDevicesOptions

خواص

  • فیلترها

    DeviceFilter [] اختیاری است

    دستگاهی که با هر فیلتری مطابقت داشته باشد بازگردانده می شود. یک لیست فیلتر خالی، همه دستگاه‌هایی را که برنامه برای آنها مجوز دارد، برمی‌گرداند.

  • شناسه محصول

    شماره اختیاری

    منسوخ

    معادل تنظیم DeviceFilter.productId .

  • شناسه فروشنده

    شماره اختیاری

    منسوخ

    معادل تنظیم DeviceFilter.vendorId .

HidCollectionInfo

خواص

  • شناسه های گزارش

    عدد[]

    شناسه های مربوط به مجموعه و فرزندان آن را گزارش دهید.

  • استفاده

    عدد

    شناسه استفاده از صفحه تعریف شده است.

  • صفحه استفاده

    عدد

    شناسه صفحه استفاده HID.

HidConnectInfo

خواص

  • شناسه اتصال

    عدد

    شناسه مات برای شناسایی این اتصال در همه عملکردهای دیگر استفاده می شود.

HidDeviceInfo

خواص

  • مجموعه ها

    HidCollectionInfo []

    مجموعه های سطح بالا از توصیفگرهای گزارش این دستگاه.

  • شناسه دستگاه

    عدد

    شناسه دستگاه غیر شفاف

  • maxFeatureReportSize

    عدد

    حداکثر اندازه گزارش ویژگی مجموعه سطح بالا.

  • maxInputReportSize

    عدد

    حداکثر اندازه گزارش ورودی مجموعه سطح بالا.

  • maxOutputReportSize

    عدد

    حداکثر اندازه گزارش خروجی مجموعه سطح بالا.

  • شناسه محصول

    عدد

    شناسه محصول.

  • نام محصول

    رشته

    Chrome 46+

    در صورت موجود بودن، نام محصول از دستگاه خوانده می شود.

  • گزارش توصیفگر

    ArrayBuffer

    توصیفگر گزارش دستگاه خام (در ویندوز موجود نیست).

  • شماره سریال

    رشته

    Chrome 46+

    شماره سریال خوانده شده از دستگاه، در صورت وجود.

  • شناسه فروشنده

    عدد

    شناسه فروشنده

مواد و روش ها

connect()

وعده
chrome.hid.connect(
  deviceId: number,
  callback?: function,
)

برای برقراری ارتباط، اتصال به دستگاه HID را باز کنید.

مولفه های

  • شناسه دستگاه

    عدد

    HidDeviceInfo.deviceId دستگاه برای باز کردن.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (connection: HidConnectInfo)=>void

برمی گرداند

  • Promise< HidConnectInfo >

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، پلتفرم های دیگر نیاز به استفاده از callback دارند.

disconnect()

وعده
chrome.hid.disconnect(
  connectionId: number,
  callback?: function,
)

اتصال را از یک دستگاه قطع کنید. فراخوانی عملیات روی یک دستگاه پس از تماس با آن بی خطر است اما هیچ تاثیری ندارد.

مولفه های

  • شناسه اتصال

    عدد

    connectionId توسط connect برگردانده شد.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، پلتفرم های دیگر نیاز به استفاده از callback دارند.

getDevices()

وعده
chrome.hid.getDevices(
  options: GetDevicesOptions,
  callback?: function,
)

دستگاه های HID متصل را برشمارید.

مولفه های

  • گزینه ها

    GetDevicesOptions

    ویژگی هایی که باید در دستگاه های مورد نظر جستجو کنید.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (devices: HidDeviceInfo[])=>void

برمی گرداند

  • Promise< HidDeviceInfo []>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، پلتفرم های دیگر نیاز به استفاده از callback دارند.

receive()

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

گزارش ورودی بعدی را از دستگاه دریافت کنید.

مولفه های

  • شناسه اتصال

    عدد

    connectionId توسط connect برگردانده شد.

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

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

    • شناسه گزارش

      عدد

      شناسه گزارش یا 0 در صورت عدم وجود.

    • داده ها

      ArrayBuffer

      داده های گزارش، پیشوند شناسه گزارش (در صورت وجود) حذف می شود.

receiveFeatureReport()

وعده
chrome.hid.receiveFeatureReport(
  connectionId: number,
  reportId: number,
  callback?: function,
)

درخواست گزارش ویژگی از دستگاه.

مولفه های

  • شناسه اتصال

    عدد

    connectionId توسط connect برگردانده شد.

  • شناسه گزارش

    عدد

    شناسه گزارش یا 0 در صورت عدم وجود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (data: ArrayBuffer)=>void

    • داده ها

      ArrayBuffer

      داده های گزارش، از جمله پیشوند شناسه گزارش اگر توسط دستگاه ارسال شود.

برمی گرداند

  • Promise<ArrayBuffer>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، پلتفرم های دیگر نیاز به استفاده از callback دارند.

send()

وعده
chrome.hid.send(
  connectionId: number,
  reportId: number,
  data: ArrayBuffer,
  callback?: function,
)

یک گزارش خروجی به دستگاه ارسال کنید.

توجه: پیشوند شناسه گزارش را در data وارد نکنید. در صورت لزوم اضافه خواهد شد.

مولفه های

  • شناسه اتصال

    عدد

    connectionId توسط connect برگردانده شد.

  • شناسه گزارش

    عدد

    شناسه گزارش برای استفاده، یا 0 در صورت عدم وجود.

  • داده ها

    ArrayBuffer

    داده های گزارش

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، پلتفرم های دیگر نیاز به استفاده از callback دارند.

sendFeatureReport()

وعده
chrome.hid.sendFeatureReport(
  connectionId: number,
  reportId: number,
  data: ArrayBuffer,
  callback?: function,
)

گزارش ویژگی را به دستگاه ارسال کنید.

توجه: پیشوند شناسه گزارش را در data وارد نکنید. در صورت لزوم اضافه خواهد شد.

مولفه های

  • شناسه اتصال

    عدد

    connectionId توسط connect برگردانده شد.

  • شناسه گزارش

    عدد

    شناسه گزارش برای استفاده، یا 0 در صورت عدم وجود.

  • داده ها

    ArrayBuffer

    داده های گزارش

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 117+

    Promises فقط برای Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، پلتفرم های دیگر نیاز به استفاده از callback دارند.

مناسبت ها

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

    • شناسه دستگاه

      عدد