chrome.usb

الوصف

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

الأذونات

usb

مدى التوفّر

نظام التشغيل ChromeOS فقط

الأنواع

ConfigDescriptor

الخصائص

  • نشطة

    قيمة منطقية

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

    هل هذا هو الإعداد النشط؟

  • configurationValue

    الرقم

    رقم الإعداد

  • الوصف

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

    وصف الإعداد

  • extra_data

    ArrayBuffer

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

  • واجهات

    InterfaceDescriptor[]

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

  • maxPower

    الرقم

    الحدّ الأقصى للطاقة التي يحتاجها هذا الجهاز بالملّي أمبير (mA)

  • remoteWakeup

    قيمة منطقية

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

  • selfPowered

    قيمة منطقية

    الجهاز يعمل ببطارية.

ConnectionHandle

الخصائص

  • مؤشر

    الرقم

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

  • productId

    الرقم

    معرّف المنتج

  • vendorId

    الرقم

    معرّف مورّد الجهاز

ControlTransferInfo

الخصائص

  • البيانات

    ‫ArrayBuffer اختياري

    البيانات المطلوب إرسالها (مطلوبة فقط لعمليات النقل إلى وجهة)

  • اتجاه

    الاتجاه

    تمثّل هذه السمة اتجاه النقل ("in" أو "out").

  • الفهرس

    الرقم

    الحقل wIndex، راجِع Ibid.

  • length

    number اختيارية

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

  • مستلم

    المستلِم

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

  • طلب

    الرقم

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

  • requestType

    RequestType

    نوع الطلب

  • وقت مستقطع

    number اختيارية

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

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

  • القيمة

    الرقم

    الحقل wValue، راجِع Ibid.

Device

الخصائص

  • جهاز

    الرقم

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

  • manufacturerName

    سلسلة

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

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

  • productId

    الرقم

    معرّف المنتج

  • productName

    سلسلة

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

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

  • serialNumber

    سلسلة

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

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

  • vendorId

    الرقم

    معرّف مورّد الجهاز

  • إصدار

    الرقم

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

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

DeviceFilter

الخصائص

  • interfaceClass

    number اختيارية

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

  • interfaceProtocol

    number اختيارية

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

  • interfaceSubclass

    number اختيارية

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

  • productId

    number اختيارية

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

  • vendorId

    number اختيارية

    معرّف مورّد الجهاز

DevicePromptOptions

الخصائص

  • الفلاتر

    DeviceFilter[] اختياري

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

  • متعددة

    boolean اختياري

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

Direction

يتم ربط كل من Direction وRecipient وRequestType وTransferType بنظائرها ضمن مواصفات USB.

تعداد

"in"

"out"

EndpointDescriptor

الخصائص

  • معالجة

    الرقم

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

  • اتجاه

    الاتجاه

    اتجاه النقل

  • extra_data

    ArrayBuffer

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

  • maximumPacketSize

    الرقم

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

  • pollingInterval

    number اختيارية

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

  • المزامنة

    SynchronizationType اختياري

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

  • النوع

    TransferType

    نوع النقل

  • الاستخدام

    UsageType اختيارية

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

EnumerateDevicesAndRequestAccessOptions

الخصائص

  • interfaceId

    number اختيارية

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

  • productId

    الرقم

    معرّف المنتج

  • vendorId

    الرقم

    معرّف مورّد الجهاز

EnumerateDevicesOptions

الخصائص

  • الفلاتر

    DeviceFilter[] اختياري

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

  • productId

    number اختيارية

    تم إيقافها نهائيًا

    هذا التوجيه مكافئ لضبط DeviceFilter.productId.

  • vendorId

    number اختيارية

    تم إيقافها نهائيًا

    هذا التوجيه مكافئ لضبط DeviceFilter.vendorId.

GenericTransferInfo

الخصائص

  • البيانات

    ‫ArrayBuffer اختياري

    البيانات المطلوب إرسالها (مطلوبة فقط لعمليات النقل إلى وجهة)

  • اتجاه

    الاتجاه

    تمثّل هذه السمة اتجاه النقل ("in" أو "out").

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

    الرقم

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

  • length

    number اختيارية

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

  • وقت مستقطع

    number اختيارية

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

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

InterfaceDescriptor

الخصائص

  • alternateSetting

    الرقم

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

  • الوصف

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

    وصف الواجهة

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

    ‫EndpointDescriptor[]

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

  • extra_data

    ArrayBuffer

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

  • interfaceClass

    الرقم

    فئة واجهة USB

  • interfaceNumber

    الرقم

    رقم الواجهة

  • interfaceProtocol

    الرقم

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

  • interfaceSubclass

    الرقم

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

IsochronousTransferInfo

الخصائص

  • packetLength

    الرقم

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

  • الحِزم

    الرقم

    تمثّل هذه السمة إجمالي عدد الحِزم في عملية النقل هذه.

  • transferInfo

    GenericTransferInfo

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

Recipient

تعداد

"device"

"interface"

"endpoint"

"other"

RequestType

تعداد

"standard"

"class"

"vendor"

"reserved"

SynchronizationType

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

تعداد

"غير متزامن"

"adaptive"

"synchronous"

TransferResultInfo

الخصائص

  • البيانات

    ‫ArrayBuffer اختياري

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

  • resultCode

    number اختيارية

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

TransferType

تعداد

"control"

"interrupt"

"isochronous"

"bulk"

UsageType

تعداد

"data"

"feedback"

"explicitFeedback"

"periodic"

"notification"

الطُرق

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,
): Promise<void>

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

يجب استدعاء releaseInterface عندما لا تكون الواجهة مطلوبة.

المعلمات

  • مؤشر

    ConnectionHandle

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

  • interfaceNumber

    الرقم

    تمثّل هذه السمة الواجهة التي سيتمّ المطالبة بها.

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

closeDevice()

وعد 
chrome.usb.closeDevice(
  handle: ConnectionHandle,
  callback?: function,
): Promise<void>

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

المعلمات

  • مؤشر

    ConnectionHandle

    انقر على ConnectionHandle للإغلاق.

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

controlTransfer()

وعد 
chrome.usb.controlTransfer(
  handle: ConnectionHandle,
  transferInfo: ControlTransferInfo,
  callback?: function,
): Promise<TransferResultInfo>

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

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

المعلمات

المرتجعات

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

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

findDevices()

وعد 
chrome.usb.findDevices(
  options: EnumerateDevicesAndRequestAccessOptions,
  callback?: function,
): Promise<ConnectionHandle[]>

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

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

إنّ استدعاء هذه الطريقة يعادل استدعاء getDevices متبوعًا بـ openDevice لكل جهاز.

المعلمات

المرتجعات

  • Promise<ConnectionHandle[]>

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

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

getConfiguration()

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

تعرض هذه السمة واصف الإعدادات المحدّدة حاليًا.

المعلمات

المرتجعات

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

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

getConfigurations()

Promise Chrome 47 أو إصدار أحدث 
chrome.usb.getConfigurations(
  device: Device,
  callback?: function,
): Promise<ConfigDescriptor[]>

تعرض هذه الطريقة المجموعة الكاملة من واصفات إعدادات الجهاز.

المعلمات

  • جهاز

    الجهاز

    Device الذي سيتم جلب الأوصاف منه

  • callback

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

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

    (configs: ConfigDescriptor[]) => void

المرتجعات

  • Promise<ConfigDescriptor[]>

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

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

getDevices()

وعد 
chrome.usb.getDevices(
  options: EnumerateDevicesOptions,
  callback?: function,
): Promise<Device[]>

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

المعلمات

  • الخيارات

    EnumerateDevicesOptions

    الخصائص التي سيتم البحث عنها على الأجهزة المستهدَفة

  • callback

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

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

    (devices: Device[]) => void

المرتجعات

  • Promise<Device[]>

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

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

getUserSelectedDevices()

وعد 
chrome.usb.getUserSelectedDevices(
  options: DevicePromptOptions,
  callback?: function,
): Promise<Device[]>

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

المعلمات

  • الخيارات

    DevicePromptOptions

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

  • callback

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

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

    (devices: Device[]) => void

المرتجعات

  • Promise<Device[]>

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

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

interruptTransfer()

وعد 
chrome.usb.interruptTransfer(
  handle: ConnectionHandle,
  transferInfo: GenericTransferInfo,
  callback?: function,
): Promise<TransferResultInfo>

تنفيذ عملية نقل مقاطعة على الجهاز المحدّد

المعلمات

المرتجعات

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

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

isochronousTransfer()

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

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

المعلمات

المرتجعات

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

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

listInterfaces()

وعد 
chrome.usb.listInterfaces(
  handle: ConnectionHandle,
  callback?: function,
): Promise<InterfaceDescriptor[]>

تعرض هذه السمة جميع الواجهات على جهاز USB.

المعلمات

المرتجعات

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

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

openDevice()

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

يفتح هذا الإجراء جهاز USB تم عرضه من خلال getDevices.

المعلمات

المرتجعات

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

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

releaseInterface()

وعد 
chrome.usb.releaseInterface(
  handle: ConnectionHandle,
  interfaceNumber: number,
  callback?: function,
): Promise<void>

تؤدي هذه السمة إلى تحرير واجهة تمت المطالبة بها.

المعلمات

  • مؤشر

    ConnectionHandle

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

  • interfaceNumber

    الرقم

    الواجهة التي سيتم إيقافها

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

requestAccess()

Promise Deprecated
chrome.usb.requestAccess(
  device: Device,
  interfaceId: number,
  callback?: function,
): Promise<boolean>

كانت هذه الوظيفة خاصة بنظام التشغيل ChromeOS، وكان سيحدث خطأ عند طلبها على الأنظمة الأساسية الأخرى. يتم تنفيذ هذه العملية الآن ضمنيًا كجزء من openDevice، وستعرض هذه الدالة القيمة true على جميع المنصات.

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

المعلمات

  • جهاز

    الجهاز

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

  • interfaceId

    الرقم

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

  • callback

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

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

    (success: boolean) => void

    • نجاح

      قيمة منطقية

المرتجعات

  • Promise<boolean>

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

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

resetDevice()

وعد 
chrome.usb.resetDevice(
  handle: ConnectionHandle,
  callback?: function,
): Promise<boolean>

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

المعلمات

  • مؤشر

    ConnectionHandle

    مقبض اتصال لإعادة الضبط

  • callback

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

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

    (success: boolean) => void

    • نجاح

      قيمة منطقية

المرتجعات

  • Promise<boolean>

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

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

setConfiguration()

وعد 
chrome.usb.setConfiguration(
  handle: ConnectionHandle,
  configurationValue: number,
  callback?: function,
): Promise<void>

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

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

المعلمات

  • مؤشر

    ConnectionHandle

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

  • configurationValue

    الرقم

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

setInterfaceAlternateSetting()

وعد 
chrome.usb.setInterfaceAlternateSetting(
  handle: ConnectionHandle,
  interfaceNumber: number,
  alternateSetting: number,
  callback?: function,
): Promise<void>

يختار إعدادًا بديلاً على واجهة تمّت المطالبة بها سابقًا.

المعلمات

  • مؤشر

    ConnectionHandle

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

  • interfaceNumber

    الرقم

    واجهة الضبط

  • alternateSetting

    الرقم

    الإعداد البديل الذي تريد ضبطه.

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

الفعاليات

onDeviceAdded

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

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

المعلمات

  • callback

    دالة

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

    (device: Device) => void

onDeviceRemoved

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

حدث يتم إنشاؤه عند إزالة جهاز من النظام. اطّلِع على onDeviceAdded لمعرفة الأحداث التي يتمّ إرسالها.

المعلمات

  • callback

    دالة

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

    (device: Device) => void