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,
)

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

المعلمات

المرتجعات

  • 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,
)

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

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

المعلمات

المرتجعات

  • Promise&lt;TransferResultInfo&gt;

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

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

findDevices()

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

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

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

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

المعلمات

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

  • رد الاتصال

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

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

    (handles: ConnectionHandle[]) => void

المرتجعات

  • Promise&lt;ConnectionHandle[]&gt;

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

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

getConfiguration()

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

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

المعلمات

  • مؤشر

    ConnectionHandle

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

  • رد الاتصال

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

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

    (config: ConfigDescriptor) => void

المرتجعات

  • Promise&lt;ConfigDescriptor&gt;

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

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

getConfigurations()

وعود الإصدار 47 من Chrome أو الإصدارات الأحدث 
chrome.usb.getConfigurations(
  device: Device,
  callback?: function,
)

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

المعلمات

  • جهاز

    الجهاز

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

  • رد الاتصال

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

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

    (configs: ConfigDescriptor[]) => void

المرتجعات

  • 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,
)

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

المعلمات

المرتجعات

  • Promise&lt;TransferResultInfo&gt;

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

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

isochronousTransfer()

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

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

المعلمات

المرتجعات

  • Promise&lt;TransferResultInfo&gt;

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

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

listInterfaces()

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

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

المعلمات

المرتجعات

  • Promise&lt;InterfaceDescriptor[]&gt;

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

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

openDevice()

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

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

المعلمات

المرتجعات

  • 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