chrome.hid

توضیحات

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

مجوزها

hid

انواع

DeviceFilter

خواص

  • شناسه محصول

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

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

  • کاربرد

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

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

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

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

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

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

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

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

GetDevicesOptions

خواص

  • فیلترها

    فیلتر دستگاه [] اختیاری

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

  • شناسه محصول

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

    منسوخ شده

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

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

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

    منسوخ شده

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

HidCollectionInfo

خواص

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

    شماره[]

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

  • کاربرد

    شماره

    شناسه‌ی کاربرد تعریف‌شده توسط صفحه.

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

    شماره

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

HidConnectInfo

خواص

  • شناسه اتصال

    شماره

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

HidDeviceInfo

خواص

  • مجموعه‌ها

    اطلاعات مجموعه مخفی []

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

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

    شماره

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

  • حداکثر اندازه گزارش ویژگی

    شماره

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

  • حداکثر اندازه ورودی گزارش

    شماره

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

  • حداکثر اندازه خروجی گزارش

    شماره

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

  • شناسه محصول

    شماره

    شناسه محصول.

  • نام محصول

    رشته

    کروم ۴۶+

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

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

    آرایه بافر

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

  • شماره سریال

    رشته

    کروم ۴۶+

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

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

    شماره

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

روش‌ها

connect()

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

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

پارامترها

بازگشت‌ها

  • قول< HidConnectInfo >

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

disconnect()

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

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

پارامترها

  • شناسه اتصال

    شماره

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

getDevices()

وعده
chrome.hid.getDevices(
  options: GetDevicesOptions,
  callback?: function,
): Promise<HidDeviceInfo[]>

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

پارامترها

بازگشت‌ها

  • قول بده< HidDeviceInfo []>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

receive()

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

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

پارامترها

  • شناسه اتصال

    شماره

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

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

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

    • شناسه گزارش

      شماره

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

    • داده‌ها

      آرایه بافر

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

receiveFeatureReport()

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

درخواست گزارش عملکرد از دستگاه.

پارامترها

  • شناسه اتصال

    شماره

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

  • شناسه گزارش

    شماره

    شناسه گزارش، یا اگر هیچ کدام وجود ندارد، 0 .

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    (data: ArrayBuffer) => void

    • داده‌ها

      آرایه بافر

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

بازگشت‌ها

  • قول <ArrayBuffer>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

send()

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

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

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

پارامترها

  • شناسه اتصال

    شماره

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

  • شناسه گزارش

    شماره

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

  • داده‌ها

    آرایه بافر

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

sendFeatureReport()

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

ارسال گزارش عملکرد به دستگاه

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

پارامترها

  • شناسه اتصال

    شماره

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

  • شناسه گزارش

    شماره

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

  • داده‌ها

    آرایه بافر

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

رویدادها

onDeviceAdded

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

رویدادی که هنگام اضافه شدن یک دستگاه به سیستم ایجاد می‌شود. رویدادها فقط به برنامه‌ها و افزونه‌هایی که مجوز دسترسی به دستگاه را دارند، پخش می‌شوند. این مجوز ممکن است در زمان نصب یا زمانی که کاربر یک مجوز اختیاری را پذیرفته است، اعطا شده باشد (به permissions.request مراجعه کنید).

پارامترها

onDeviceRemoved

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

رویدادی که هنگام حذف دستگاه از سیستم ایجاد می‌شود. برای اطلاع از رویدادهای ارائه شده، onDeviceAdded مراجعه کنید.

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

    (deviceId: number) => void

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

      شماره

،

توضیحات

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

مجوزها

hid

انواع

DeviceFilter

خواص

  • شناسه محصول

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

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

  • کاربرد

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

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

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

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

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

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

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

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

GetDevicesOptions

خواص

  • فیلترها

    فیلتر دستگاه [] اختیاری

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

  • شناسه محصول

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

    منسوخ شده

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

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

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

    منسوخ شده

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

HidCollectionInfo

خواص

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

    شماره[]

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

  • کاربرد

    شماره

    شناسه‌ی کاربرد تعریف‌شده توسط صفحه.

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

    شماره

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

HidConnectInfo

خواص

  • شناسه اتصال

    شماره

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

HidDeviceInfo

خواص

  • مجموعه‌ها

    اطلاعات مجموعه مخفی []

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

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

    شماره

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

  • حداکثر اندازه گزارش ویژگی

    شماره

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

  • حداکثر اندازه ورودی گزارش

    شماره

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

  • حداکثر اندازه خروجی گزارش

    شماره

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

  • شناسه محصول

    شماره

    شناسه محصول.

  • نام محصول

    رشته

    کروم ۴۶+

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

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

    آرایه بافر

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

  • شماره سریال

    رشته

    کروم ۴۶+

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

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

    شماره

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

روش‌ها

connect()

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

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

پارامترها

بازگشت‌ها

  • قول< HidConnectInfo >

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

disconnect()

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

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

پارامترها

  • شناسه اتصال

    شماره

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

getDevices()

وعده
chrome.hid.getDevices(
  options: GetDevicesOptions,
  callback?: function,
): Promise<HidDeviceInfo[]>

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

پارامترها

بازگشت‌ها

  • قول بده< HidDeviceInfo []>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

receive()

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

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

پارامترها

  • شناسه اتصال

    شماره

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

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

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

    • شناسه گزارش

      شماره

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

    • داده‌ها

      آرایه بافر

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

receiveFeatureReport()

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

درخواست گزارش عملکرد از دستگاه.

پارامترها

  • شناسه اتصال

    شماره

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

  • شناسه گزارش

    شماره

    شناسه گزارش، یا اگر هیچ کدام وجود ندارد، 0 .

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    (data: ArrayBuffer) => void

    • داده‌ها

      آرایه بافر

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

بازگشت‌ها

  • قول <ArrayBuffer>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

send()

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

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

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

پارامترها

  • شناسه اتصال

    شماره

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

  • شناسه گزارش

    شماره

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

  • داده‌ها

    آرایه بافر

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

sendFeatureReport()

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

ارسال گزارش عملکرد به دستگاه

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

پارامترها

  • شناسه اتصال

    شماره

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

  • شناسه گزارش

    شماره

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

  • داده‌ها

    آرایه بافر

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

رویدادها

onDeviceAdded

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

رویدادی که هنگام اضافه شدن یک دستگاه به سیستم ایجاد می‌شود. رویدادها فقط به برنامه‌ها و افزونه‌هایی که مجوز دسترسی به دستگاه را دارند، پخش می‌شوند. این مجوز ممکن است در زمان نصب یا زمانی که کاربر یک مجوز اختیاری را پذیرفته است، اعطا شده باشد (به permissions.request مراجعه کنید).

پارامترها

onDeviceRemoved

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

رویدادی که هنگام حذف دستگاه از سیستم ایجاد می‌شود. برای اطلاع از رویدادهای ارائه شده، onDeviceAdded مراجعه کنید.

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

    (deviceId: number) => void

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

      شماره

،

توضیحات

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

مجوزها

hid

انواع

DeviceFilter

خواص

  • شناسه محصول

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

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

  • کاربرد

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

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

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

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

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

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

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

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

GetDevicesOptions

خواص

  • فیلترها

    فیلتر دستگاه [] اختیاری

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

  • شناسه محصول

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

    منسوخ شده

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

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

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

    منسوخ شده

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

HidCollectionInfo

خواص

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

    شماره[]

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

  • کاربرد

    شماره

    شناسه‌ی کاربرد تعریف‌شده توسط صفحه.

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

    شماره

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

HidConnectInfo

خواص

  • شناسه اتصال

    شماره

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

HidDeviceInfo

خواص

  • مجموعه‌ها

    اطلاعات مجموعه مخفی []

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

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

    شماره

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

  • حداکثر اندازه گزارش ویژگی

    شماره

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

  • حداکثر اندازه ورودی گزارش

    شماره

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

  • حداکثر اندازه خروجی گزارش

    شماره

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

  • شناسه محصول

    شماره

    شناسه محصول.

  • نام محصول

    رشته

    کروم ۴۶+

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

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

    آرایه بافر

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

  • شماره سریال

    رشته

    کروم ۴۶+

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

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

    شماره

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

روش‌ها

connect()

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

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

پارامترها

بازگشت‌ها

  • قول< HidConnectInfo >

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

disconnect()

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

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

پارامترها

  • شناسه اتصال

    شماره

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

getDevices()

وعده
chrome.hid.getDevices(
  options: GetDevicesOptions,
  callback?: function,
): Promise<HidDeviceInfo[]>

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

پارامترها

بازگشت‌ها

  • قول بده< HidDeviceInfo []>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

receive()

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

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

پارامترها

  • شناسه اتصال

    شماره

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

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

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

    • شناسه گزارش

      شماره

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

    • داده‌ها

      آرایه بافر

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

receiveFeatureReport()

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

درخواست گزارش عملکرد از دستگاه.

پارامترها

  • شناسه اتصال

    شماره

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

  • شناسه گزارش

    شماره

    شناسه گزارش، یا اگر هیچ کدام وجود ندارد، 0 .

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    (data: ArrayBuffer) => void

    • داده‌ها

      آرایه بافر

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

بازگشت‌ها

  • قول <ArrayBuffer>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

send()

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

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

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

پارامترها

  • شناسه اتصال

    شماره

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

  • شناسه گزارش

    شماره

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

  • داده‌ها

    آرایه بافر

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

sendFeatureReport()

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

ارسال گزارش عملکرد به دستگاه

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

پارامترها

  • شناسه اتصال

    شماره

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

  • شناسه گزارش

    شماره

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

  • داده‌ها

    آرایه بافر

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    () => void

بازگشت‌ها

  • قول<void>

    کروم ۱۱۷+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

رویدادها

onDeviceAdded

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

رویدادی که هنگام اضافه شدن یک دستگاه به سیستم ایجاد می‌شود. رویدادها فقط به برنامه‌ها و افزونه‌هایی که مجوز دسترسی به دستگاه را دارند، پخش می‌شوند. این مجوز ممکن است در زمان نصب یا زمانی که کاربر یک مجوز اختیاری را پذیرفته است، اعطا شده باشد (به permissions.request مراجعه کنید).

پارامترها

onDeviceRemoved

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

رویدادی که هنگام حذف دستگاه از سیستم ایجاد می‌شود. برای اطلاع از رویدادهای ارائه شده، onDeviceAdded مراجعه کنید.

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

    (deviceId: number) => void

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

      شماره