chrome.usb

الوصف

يمكنك استخدام واجهة برمجة التطبيقات chrome.usb للتفاعل مع أجهزة USB المتصلة. توفّر واجهة برمجة التطبيقات هذه إمكانية الوصول إلى عمليات USB من داخل سياق التطبيق. باستخدام واجهة برمجة التطبيقات هذه، يمكن للتطبيقات العمل كبرامج تشغيل للأجهزة. يتم الإبلاغ عن الأخطاء التي تنتج عن واجهة برمجة التطبيقات هذه من خلال ضبط runtime.lastError وتنفيذ طلب معاودة الاتصال العادي للدالة. وستكون المعلمات العادية لمعاودة الاتصال غير محدّدة في هذه الحالة.

الأذونات

usb

الأنواع

ConfigDescriptor

أماكن إقامة

• نشطة

  منطقي

  الإصدار 47 من Chrome أو الإصدارات الأحدث

  هل هذه هي الإعدادات النشطة؟

• configurationValue

  الرقم

  رقم الضبط.

• الوصف

  سلسلة اختيارية

  وصف الإعدادات.

• extra_data

  مخزن المصفوفات

  بيانات الواصف الإضافية المرتبطة بهذه الإعدادات

• واجهات

  InterfaceDescriptor[]

  الواجهات المتاحة

• maxPower

  الرقم

  يشير ذلك المصطلح إلى الحد الأقصى للطاقة التي يحتاجها هذا الجهاز بالمللي أمبير.

• remoteWakeup

  منطقي

  يتوافق الجهاز مع ميزة التنشيط عن بُعد.

• selfPowered

  منطقي

  يعمل الجهاز ذاتيًا.

ConnectionHandle

أماكن إقامة

• مؤشر

  الرقم

  مقبض مبهم يمثّل هذا الاتصال بجهاز USB وجميع الواجهات التي تمت المطالبة بها وعمليات النقل المعلّقة يتم إنشاء اسم معرِّف جديد في كل مرة يتم فيها فتح الجهاز. يختلف مقبض الاتصال عن Device.device.

• productId

  الرقم

  معرّف المنتج.

• vendorId

  الرقم

  رقم تعريف مورِّد الجهاز

ControlTransferInfo

أماكن إقامة

• البيانات

  ArrayBuffer اختيارية

  البيانات المراد نقلها (مطلوبة فقط لعمليات نقل الإخراج).

• اتجاه

  الاتجاه

  اتجاه النقل ("in" أو "out")

• المؤشر

  الرقم

  حقل wIndex، راجع المرجع السابق.

• length

  الرقم اختياري

  الحد الأقصى لعدد وحدات البايت المراد استلامها (مطلوب فقط من خلال عمليات نقل الإدخال).

• مستلم

  المستلِم

  هدف النقل. يجب المطالبة بالهدف الذي تم تحديده من خلال index إذا كانت السمة "interface" أو "endpoint".

• طلب

  الرقم

  الحقل bRequest، اطّلِع على المراجعة 1.1 لمواصفات الناقل التسلسلي العالمي الفقرة 9.3.

• requestType

  RequestType

  نوع الطلب

• وقت مستقطع

  الرقم اختياري

  الإصدار 43 من Chrome أو الإصدارات الأحدث

  انتهت مهلة الطلب (بالمللي ثانية). تشير القيمة التلقائية 0 إلى عدم وجود مهلة.

• القيمة

  الرقم

  حقل wValue، راجع المرجع السابق.

Device

أماكن إقامة

• جهاز

  الرقم

  معرّف مبهم لجهاز USB. يظل الجهاز بدون تغيير إلى أن يتم فصل الجهاز عن مصدر الطاقة.

• manufacturerName

  سلسلة

  الإصدار 46 من Chrome أو الإصدارات الأحدث

  سلسلة iManufacturer التي تتم قراءتها من الجهاز، إذا كانت متاحة.

• productId

  الرقم

  معرّف المنتج.

• productName

  سلسلة

  الإصدار 46 من Chrome أو الإصدارات الأحدث

  تتم قراءة سلسلة iProduct من الجهاز، إذا كانت متاحة.

• serialNumber

  سلسلة

  الإصدار 46 من Chrome أو الإصدارات الأحدث

  سلسلة iSerialNumber التي تتم قراءتها من الجهاز، إذا كانت متاحة.

• vendorId

  الرقم

  رقم تعريف مورِّد الجهاز

• إصدار

  الرقم

  الإصدار 51 من Chrome أو الإصدارات الأحدث

  إصدار الجهاز (حقل bcdDevice).

DeviceFilter

أماكن إقامة

• interfaceClass

  الرقم اختياري

  فئة واجهة USB، تتطابق مع أي واجهة على الجهاز.

• interfaceProtocol

  الرقم اختياري

  بروتوكول واجهة USB، يتم التحقق منه فقط في حال تطابق الفئة الفرعية للواجهة.

• interfaceSubclass

  الرقم اختياري

  فئة فرعية لواجهة USB، يتم التحقّق منها فقط في حال تطابق فئة الواجهة.

• productId

  الرقم اختياري

  معرّف منتج الجهاز، يتم التحقّق منه فقط في حال تطابق رقم تعريف المورّد.

• vendorId

  الرقم اختياري

  رقم تعريف مورِّد الجهاز

DevicePromptOptions

أماكن إقامة

• الفلاتر

  DeviceFilter[] اختيارية

  فلترة قائمة الأجهزة المعروضة للمستخدم في حال توفير فلاتر متعدّدة، سيتم عرض أجهزة تطابق أي فلتر.

• متعددة

  قيمة منطقية اختيارية

  السماح للمستخدم باختيار أجهزة متعددة

Direction

يرتبط كل من "الاتجاه" و"المستلِم" و"نوع الطلب" و"نوع النقل" بالأسماء التي تحمل أسماءها ضمن مواصفات USB.

Enum

بوصة

"خرج"

EndpointDescriptor

أماكن إقامة

• معالجة

  الرقم

  عنوان نقطة النهاية.

• اتجاه

  الاتجاه

  اتجاه التحويل

• extra_data

  مخزن المصفوفات

  بيانات الواصف الإضافية المرتبطة بنقطة النهاية هذه.

• maximumPacketSize

  الرقم

  الحد الأقصى لحجم الحزمة

• pollingInterval

  الرقم اختياري

  الفاصل الزمني للاستفتاء (مقاطعة ومتساوية زمنية فقط).

• مزامنة

  SynchronizationType اختيارية

  وضع مزامنة النقل (متساويان فقط)

• كتابة

  TransferType

  نوع عملية النقل

• الاستخدام

  UsageType اختيارية

  تلميح حول استخدام نقطة النهاية

EnumerateDevicesAndRequestAccessOptions

أماكن إقامة

• interfaceId

  الرقم اختياري

  رقم تعريف الواجهة المطلوب طلب الوصول إليها. لا تتوفّر هذه الميزة إلا على نظام التشغيل ChromeOS. وليس له أي تأثير على المنصات الأخرى.

• productId

  الرقم

  معرّف المنتج.

• vendorId

  الرقم

  رقم تعريف مورِّد الجهاز

EnumerateDevicesOptions

أماكن إقامة

• الفلاتر

  DeviceFilter[] اختيارية

  سيتم عرض جهاز يطابق أي فلتر معيَّن. ستعرض قائمة فلاتر فارغة جميع الأجهزة التي تم منح التطبيق الإذن لها.

• productId

  الرقم اختياري

  متوقّفة نهائيًا

  يعادل الإعداد DeviceFilter.productId.

• vendorId

  الرقم اختياري

  متوقّفة نهائيًا

  يعادل الإعداد DeviceFilter.vendorId.

GenericTransferInfo

أماكن إقامة

• البيانات

  ArrayBuffer اختيارية

  البيانات المراد نقلها (مطلوبة فقط لعمليات نقل الإخراج).

• اتجاه

  الاتجاه

  اتجاه النقل ("in" أو "out")

• نقطة نهاية

  الرقم

  عنوان نقطة النهاية المستهدفة. يجب المطالبة بالواجهة التي تحتوي على نقطة النهاية هذه.

• length

  الرقم اختياري

  الحد الأقصى لعدد وحدات البايت المراد استلامها (مطلوب فقط من خلال عمليات نقل الإدخال).

• وقت مستقطع

  الرقم اختياري

  الإصدار 43 من Chrome أو الإصدارات الأحدث

  انتهت مهلة الطلب (بالمللي ثانية). تشير القيمة التلقائية 0 إلى عدم وجود مهلة.

InterfaceDescriptor

أماكن إقامة

• alternateSetting

  الرقم

  رقم الإعداد البديل للواجهة (القيمة التلقائية هو 0)

• الوصف

  سلسلة اختيارية

  وصف الواجهة.

• نقاط نهاية

  EndpointDescriptor[]

  نقاط النهاية المتاحة.

• extra_data

  مخزن المصفوفات

  بيانات الواصف الإضافية المرتبطة بهذه الواجهة

• interfaceClass

  الرقم

  فئة واجهة USB.

• interfaceNumber

  الرقم

  رقم الواجهة.

• interfaceProtocol

  الرقم

  بروتوكول واجهة USB.

• interfaceSubclass

  الرقم

  الفئة الفرعية لواجهة USB.

IsochronousTransferInfo

أماكن إقامة

• packetLength

  الرقم

  طول كل حزمة من الحزم في عملية النقل هذه.

• الحزم

  الرقم

  إجمالي عدد حزم البيانات في عملية النقل هذه.

• transferInfo

  GenericTransferInfo

  معلمات النقل يتم تقسيم مدة النقل أو المخزن المؤقت للبيانات المحدّد في مجموعة المَعلَمات هذه بموازاة حدود packetLength لتكوين حِزَم فردية لعملية النقل.

Recipient

Enum

"الجهاز"

"الواجهة"

"نقطة النهاية"

"other"

RequestType

Enum

"عادي"

"الفئة"

"المورِّد"

"محجوزة"

SynchronizationType

بالنسبة إلى وضعَي المقاطعة والمتناظرة، يتم ربط SynchronizationType وUsageType بأسماءهما ضِمن مواصفات USB.

Enum

"غير متزامن"

"تكيّفي"

"متزامن"

TransferResultInfo

أماكن إقامة

• البيانات

  ArrayBuffer اختيارية

  البيانات التي يتم عرضها من خلال نقل الإدخال. undefined لعمليات نقل النتائج.

• resultCode

  الرقم اختياري

  تشير القيمة 0 إلى أنّ عملية النقل تمت بنجاح. تشير القيم الأخرى إلى الفشل.

TransferType

Enum

"control"

"مقاطعة"

"متساوي الوقت"

"مجمّعة"

UsageType

Enum

"البيانات"

"الملاحظات"

"explicitFeedback"

"دورية"

"الإشعار"

الطُرق

bulkTransfer()

وعود

chrome.usb.bulkTransfer(
  handle: ConnectionHandle,
  transferInfo: GenericTransferInfo,
  callback?: function,
)

تُجري عملية نقل مجمّعة على الجهاز المحدّد.

المعلمات

• مؤشر

  ConnectionHandle

  اتصال مفتوح بالجهاز.

• transferInfo

  GenericTransferInfo

  مَعلمات النقل

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (info: TransferResultInfo) => void

  • معلومات

    TransferResultInfo

المرتجعات

• Promise<TransferResultInfo>

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

claimInterface()

وعود

chrome.usb.claimInterface(
  handle: ConnectionHandle,
  interfaceNumber: number,
  callback?: function,
)

المطالبة بواجهة على جهاز USB. قبل نقل البيانات إلى واجهة أو نقاط نهاية مرتبطة، يجب المطالبة بالواجهة. يمكن لمقبض اتصال واحد فقط المطالبة بأي واجهة في أي وقت. إذا سبق أن تمت المطالبة بالواجهة، سيتعذّر إجراء هذه المكالمة.

يجب استدعاء releaseInterface عندما لا تكون هناك حاجة إلى الواجهة بعد الآن.

المعلمات

• مؤشر

  ConnectionHandle

  اتصال مفتوح بالجهاز.

• interfaceNumber

  الرقم

  الواجهة المطلوب المطالبة بها.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• وعود <باطلة>

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

closeDevice()

وعود

chrome.usb.closeDevice(
  handle: ConnectionHandle,
  callback?: function,
)

لإغلاق مقبض اتصال. إنّ استدعاء العمليات على اسم معرِّف بعد إغلاقه هي عملية آمنة، ولكنها لا تؤدي إلى اتخاذ أي إجراء.

المعلمات

• مؤشر

  ConnectionHandle

  سيتم إغلاق ConnectionHandle.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• وعود <باطلة>

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

controlTransfer()

وعود

chrome.usb.controlTransfer(
  handle: ConnectionHandle,
  transferInfo: ControlTransferInfo,
  callback?: function,
)

لنقل عنصر التحكّم على الجهاز المحدّد.

وتشير عمليات نقل عناصر التحكم إما إلى الجهاز أو الواجهة أو نقطة النهاية. تتطلّب عمليات النقل إلى واجهة أو نقطة نهاية المطالبة بالواجهة.

المعلمات

• مؤشر

  ConnectionHandle

  اتصال مفتوح بالجهاز.

• transferInfo

  ControlTransferInfo

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (info: TransferResultInfo) => void

  • معلومات

    TransferResultInfo

المرتجعات

• Promise&lt;TransferResultInfo&gt;

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

findDevices()

وعود

chrome.usb.findDevices(
  options: EnumerateDevicesAndRequestAccessOptions,
  callback?: function,
)

يعثر على أجهزة USB التي يحدِّدها المورِّد والمنتج ومعرّفات الواجهة (اختياريًا) وما إذا كانت الأذونات تسمح باستخدامها.

إذا تم رفض طلب الوصول أو تعذّر فتح مؤشر الاتصال، لن يتم إنشاء أو إعادته.

يعادل استدعاء هذه الطريقة استدعاء getDevices ثم openDevice لكل جهاز.

المعلمات

• الخيارات

  EnumerateDevicesAndRequestAccessOptions

  السمات المطلوب البحث عنها على الأجهزة المستهدَفة.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (handles: ConnectionHandle[]) => void

  • الأسماء المعرِّفة

    ConnectionHandle[]

المرتجعات

• Promise&lt;ConnectionHandle[]&gt;

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getConfiguration()

وعود

chrome.usb.getConfiguration(
  handle: ConnectionHandle,
  callback?: function,
)

الحصول على واصف الإعدادات للإعدادات المحددة حاليًا

المعلمات

• مؤشر

  ConnectionHandle

  اتصال مفتوح بالجهاز.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (config: ConfigDescriptor) => void

  • config

    ConfigDescriptor

المرتجعات

• Promise&lt;ConfigDescriptor&gt;

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getConfigurations()

وعود الإصدار 47 من Chrome أو الإصدارات الأحدث

chrome.usb.getConfigurations(
  device: Device,
  callback?: function,
)

تعرض المجموعة الكاملة من أدوات وصف إعداد الجهاز.

المعلمات

• جهاز

  الجهاز

  تمثّل هذه السمة Device المطلوب جلب الكلمات الوصفية منه.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (configs: ConfigDescriptor[]) => void

  • الإعدادات

    ConfigDescriptor[]

المرتجعات

• Promise&lt;ConfigDescriptor[]&gt;

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getDevices()

وعود

chrome.usb.getDevices(
  options: EnumerateDevicesOptions,
  callback?: function,
)

لتعداد أجهزة USB المتصلة.

المعلمات

• الخيارات

  EnumerateDevicesOptions

  السمات المطلوب البحث عنها على الأجهزة المستهدَفة.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (devices: Device[]) => void

  • الأجهزة

    الجهاز[]

المرتجعات

• الوعد<Device[]>

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getUserSelectedDevices()

وعود

chrome.usb.getUserSelectedDevices(
  options: DevicePromptOptions,
  callback?: function,
)

تعرض هذه السمة أداة اختيار الأجهزة للمستخدم وتعرض عناصر Device المحددة. إذا ألغى المستخدم، ستكون أجهزة الاختيار فارغة. يجب استخدام إيماءة المستخدم لعرض مربّع الحوار. وبدون استخدام إيماءة المستخدم، سيتم تنفيذ رد الاتصال كما لو كان المستخدم قد ألغى.

المعلمات

• الخيارات

  DevicePromptOptions

  إعدادات مربّع حوار منتقي الجهاز

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (devices: Device[]) => void

  • الأجهزة

    الجهاز[]

المرتجعات

• الوعد<Device[]>

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

interruptTransfer()

وعود

chrome.usb.interruptTransfer(
  handle: ConnectionHandle,
  transferInfo: GenericTransferInfo,
  callback?: function,
)

لإجراء عملية نقل مقاطعة على الجهاز المحدّد.

المعلمات

• مؤشر

  ConnectionHandle

  اتصال مفتوح بالجهاز.

• transferInfo

  GenericTransferInfo

  مَعلمات النقل

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (info: TransferResultInfo) => void

  • معلومات

    TransferResultInfo

المرتجعات

• Promise&lt;TransferResultInfo&gt;

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

isochronousTransfer()

وعود

chrome.usb.isochronousTransfer(
  handle: ConnectionHandle,
  transferInfo: IsochronousTransferInfo,
  callback?: function,
)

يجري عملية نقل متناسقة الوقت على الجهاز المحدد.

المعلمات

• مؤشر

  ConnectionHandle

  اتصال مفتوح بالجهاز.

• transferInfo

  IsochronousTransferInfo

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (info: TransferResultInfo) => void

  • معلومات

    TransferResultInfo

المرتجعات

• Promise&lt;TransferResultInfo&gt;

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

listInterfaces()

وعود

chrome.usb.listInterfaces(
  handle: ConnectionHandle,
  callback?: function,
)

يتم إدراج جميع الواجهات على جهاز USB.

المعلمات

• مؤشر

  ConnectionHandle

  اتصال مفتوح بالجهاز.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (descriptors: InterfaceDescriptor[]) => void

  • واصفات

    InterfaceDescriptor[]

المرتجعات

• Promise&lt;InterfaceDescriptor[]&gt;

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

openDevice()

وعود

chrome.usb.openDevice(
  device: Device,
  callback?: function,
)

يؤدي هذا الاختصار إلى فتح جهاز USB تم إرجاعه من خلال getDevices.

المعلمات

• جهاز

  الجهاز

  Device المراد فتحه.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (handle: ConnectionHandle) => void

  • مؤشر

    ConnectionHandle

المرتجعات

• Promise&lt;ConnectionHandle&gt;

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

releaseInterface()

وعود

chrome.usb.releaseInterface(
  handle: ConnectionHandle,
  interfaceNumber: number,
  callback?: function,
)

إصدار واجهة تمت المطالبة بها.

المعلمات

• مؤشر

  ConnectionHandle

  اتصال مفتوح بالجهاز.

• interfaceNumber

  الرقم

  الواجهة التي سيتم إصدارها.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• وعود <باطلة>

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

requestAccess()

وعود متوقّفة نهائيًا

chrome.usb.requestAccess(
  device: Device,
  interfaceId: number,
  callback?: function,
)

كانت هذه الوظيفة خاصة بنظام التشغيل Chrome وسيتعذّر استدعاؤها على الأنظمة الأساسية الأخرى. يتم تنفيذ هذه العملية ضمنيًا الآن كجزء من openDevice وستعرض هذه الدالة true على جميع الأنظمة الأساسية.

يطلب هذا الإذن الوصول من وسيط الأذونات إلى جهاز يطالب به نظام التشغيل Chrome في حال عدم المطالبة بالواجهة المحدّدة على الجهاز.

المعلمات

• جهاز

  الجهاز

  Device الذي تريد طلب الوصول إليه

• interfaceId

  الرقم

  الواجهة المحدّدة المطلوبة.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (success: boolean) => void

  • النجاح

    منطقي

المرتجعات

• Promise&lt;boolean&gt;

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

resetDevice()

وعود

chrome.usb.resetDevice(
  handle: ConnectionHandle,
  callback?: function,
)

يحاول إعادة ضبط جهاز USB. إذا تعذّرت إعادة الضبط، سيتم إغلاق مقبض الاتصال المحدَّد وسيظهر جهاز USB غير متصل ثم إعادة توصيله. في هذه الحالة، يجب استدعاء getDevices أو findDevices مرة أخرى للحصول على الجهاز.

المعلمات

• مؤشر

  ConnectionHandle

  مؤشر اتصال ستتم إعادة ضبطه.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (success: boolean) => void

  • النجاح

    منطقي

المرتجعات

• Promise&lt;boolean&gt;

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

setConfiguration()

وعود

chrome.usb.setConfiguration(
  handle: ConnectionHandle,
  configurationValue: number,
  callback?: function,
)

اختَر إعداد الجهاز.

تؤدي هذه الوظيفة إلى إعادة ضبط الجهاز بفعالية من خلال اختيار إحدى الإعدادات المتاحة للجهاز. صالحة فقط لقيم الإعداد التي تزيد عن 0، إلا أنّ بعض الأجهزة التي تتضمّن أعطالاً تتضمّن 0 إعداد صالح، ولذلك يُسمح بهذه القيمة.

المعلمات

• مؤشر

  ConnectionHandle

  اتصال مفتوح بالجهاز.

• configurationValue

  الرقم

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• وعود <باطلة>

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

setInterfaceAlternateSetting()

وعود

chrome.usb.setInterfaceAlternateSetting(
  handle: ConnectionHandle,
  interfaceNumber: number,
  alternateSetting: number,
  callback?: function,
)

اختيار إعداد بديل على واجهة سبق أن تمت المطالبة بها

المعلمات

• مؤشر

  ConnectionHandle

  اتصال مفتوح بالجهاز الذي تمت المطالبة بملكية هذه الواجهة عليه.

• interfaceNumber

  الرقم

  الواجهة المطلوب إعدادها.

• alternateSetting

  الرقم

  الإعداد البديل المطلوب ضبطه

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• وعود <باطلة>

  الإصدار 116 من Chrome أو الإصدارات الأحدث

  لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

فعاليات

onDeviceAdded

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

يشير ذلك المصطلح إلى الحدث الذي يتم إنشاؤه عندما تتم إضافة جهاز إلى النظام. لا يتم بث الأحداث إلا للتطبيقات والإضافات التي لديها إذن بالوصول إلى الجهاز. ربما تم منح الإذن في وقت التثبيت أو عندما يقبل المستخدم إذنًا اختيارياً (يُرجى الاطّلاع على permissions.request) أو من خلال getUserSelectedDevices.

المعلمات

• رد الاتصال

  دالة

  تظهر المَعلمة callback على النحو التالي:

  (device: Device) => void

  • جهاز

    الجهاز

onDeviceRemoved

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

الحدث الذي يتم إنشاؤه عند إزالة جهاز من النظام يمكنك الاطّلاع على onDeviceAdded التي يتم عرض الأحداث الخاصة بها.

المعلمات

• رد الاتصال

  دالة

  تظهر المَعلمة callback على النحو التالي:

  (device: Device) => void

  • جهاز

    الجهاز