chrome.usb

الوصف

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

الأذونات

usb

الأنواع

ConfigDescriptor

أماكن إقامة

  • نشطة

    قيمة منطقية

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

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

  • configurationValue

    الرقم

    رقم الضبط

  • الوصف

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

    وصف الإعداد

  • extra_data

    ArrayBuffer

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

  • واجهات

    InterfaceDescriptor[]

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

  • maxPower

    الرقم

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

  • remoteWakeup

    قيمة منطقية

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

  • selfPowered

    قيمة منطقية

    الجهاز مزوّد بمصدر طاقة ذاتي.

ConnectionHandle

أماكن إقامة

  • مؤشر

    الرقم

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

  • productId

    الرقم

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

  • vendorId

    الرقم

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

ControlTransferInfo

أماكن إقامة

  • البيانات

    ArrayBuffer اختياري

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

  • اتجاه

    الاتجاه

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

  • المؤشر

    الرقم

    الحقل wIndex، يُرجى الاطّلاع على المرجع نفسه.

  • length

    رقم اختياري

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

  • مستلم

    المستلم

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

  • طلب

    الرقم

    الحقل bRequest، راجِع Universal Serial Bus Specification Revision 1.1 § 9.3.

  • requestType

    RequestType

    نوع الطلب

  • وقت مستقطع

    رقم اختياري

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

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

  • القيمة

    الرقم

    الحقل wValue، يُرجى الاطّلاع على المرجع نفسه.

Device

أماكن إقامة

  • جهاز

    الرقم

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

  • manufacturerName

    سلسلة

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

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

  • productId

    الرقم

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

  • productName

    سلسلة

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

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

  • serialNumber

    سلسلة

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

    سلسلة iSerialNumber التي تم قراءتها من الجهاز، في حال توفّرها

  • vendorId

    الرقم

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

  • إصدار

    الرقم

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

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

DeviceFilter

أماكن إقامة

  • interfaceClass

    رقم اختياري

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

  • interfaceProtocol

    رقم اختياري

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

  • interfaceSubclass

    رقم اختياري

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

  • productId

    رقم اختياري

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

  • vendorId

    رقم اختياري

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

DevicePromptOptions

أماكن إقامة

  • الفلاتر

    DeviceFilter[] اختياري

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

  • متعددة

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

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

Direction

يتم ربط Direction وRecipient وRequestType وTransferType بأسماء مماثلة لها في مواصفات USB.

Enum

"in"

"out"

EndpointDescriptor

أماكن إقامة

  • معالجة

    الرقم

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

  • اتجاه

    الاتجاه

    اتجاه النقل

  • extra_data

    ArrayBuffer

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

  • maximumPacketSize

    الرقم

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

  • pollingInterval

    رقم اختياري

    فاصل الاستطلاع (الاستراحة والوقت الفاصل نفسه فقط)

  • المزامنة

    ‫SynchronizationType اختياري

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

  • كتابة

    TransferType

    نوع النقل

  • الاستخدام

    ‫UsageType اختياري

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

EnumerateDevicesAndRequestAccessOptions

أماكن إقامة

  • interfaceId

    رقم اختياري

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

  • productId

    الرقم

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

  • vendorId

    الرقم

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

EnumerateDevicesOptions

أماكن إقامة

  • الفلاتر

    DeviceFilter[] اختيارية

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

  • productId

    رقم اختياري

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

    يعادل ضبط DeviceFilter.productId.

  • vendorId

    رقم اختياري

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

    يعادل ضبط DeviceFilter.vendorId.

GenericTransferInfo

أماكن إقامة

  • البيانات

    ArrayBuffer اختياري

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

  • اتجاه

    الاتجاه

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

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

    الرقم

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

  • length

    رقم اختياري

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

  • وقت مستقطع

    رقم اختياري

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

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

InterfaceDescriptor

أماكن إقامة

  • alternateSetting

    الرقم

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

  • الوصف

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

    وصف الواجهة

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

    EndpointDescriptor[]

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

  • extra_data

    ArrayBuffer

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

  • interfaceClass

    الرقم

    فئة واجهة USB

  • interfaceNumber

    الرقم

    رقم الواجهة.

  • interfaceProtocol

    الرقم

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

  • interfaceSubclass

    الرقم

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

IsochronousTransferInfo

أماكن إقامة

  • packetLength

    الرقم

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

  • الحِزم

    الرقم

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

  • transferInfo

    GenericTransferInfo

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

Recipient

Enum

"device"

"interface"

"endpoint"

"other"

RequestType

Enum

"standard"

"class"

"vendor"

"reserved"

SynchronizationType

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

Enum

"asynchronous"

"متكيّف"

"synchronous"

TransferResultInfo

أماكن إقامة

  • البيانات

    ArrayBuffer اختياري

    البيانات التي يعرضها نقل الإدخال ‫undefined لنقل البيانات

  • resultCode

    رقم اختياري

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

TransferType

Enum

"control"

"interrupt"

"isochronous"

"bulk"

UsageType

Enum

"data"

"feedback"

"explicitFeedback"

"periodic"

"notification"

الطُرق

bulkTransfer()

الوعد 
chrome.usb.bulkTransfer(
  handle: ConnectionHandle,
  transferInfo: GenericTransferInfo,
  callback?: function,
)

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

المعلمات

المرتجعات

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

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

claimInterface()

الوعد 
chrome.usb.claimInterface(
  handle: ConnectionHandle,
  interfaceNumber: number,
  callback?: function,
)

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

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

المعلمات

  • مؤشر

    ConnectionHandle

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

  • interfaceNumber

    الرقم

    الواجهة المطلوب المطالبة بملكيتها

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

closeDevice()

الوعد 
chrome.usb.closeDevice(
  handle: ConnectionHandle,
  callback?: function,
)

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

المعلمات

  • مؤشر

    ConnectionHandle

    ConnectionHandle للإغلاق

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

controlTransfer()

الوعد 
chrome.usb.controlTransfer(
  handle: ConnectionHandle,
  transferInfo: ControlTransferInfo,
  callback?: function,
)

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

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

المعلمات

المرتجعات

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

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

findDevices()

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

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

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

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

المعلمات

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

  • ردّ الاتصال

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

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

    (handles: ConnectionHandle[]) => void

المرتجعات

  • Promise<ConnectionHandle[]>

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

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

getConfiguration()

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

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

المعلمات

  • مؤشر

    ConnectionHandle

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

  • ردّ الاتصال

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

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

    (config: ConfigDescriptor) => void

المرتجعات

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

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

getConfigurations()

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

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

المعلمات

  • جهاز

    الجهاز

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

  • ردّ الاتصال

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

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

    (configs: ConfigDescriptor[]) => void

المرتجعات

  • Promise<ConfigDescriptor[]>

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

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

getDevices()

الوعد 
chrome.usb.getDevices(
  options: EnumerateDevicesOptions,
  callback?: function,
)

يُدرِج أجهزة USB المتصلة.

المعلمات

  • الخيارات

    EnumerateDevicesOptions

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

  • ردّ الاتصال

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

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

    (devices: Device[]) => void

المرتجعات

  • Promise<Device[]>

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

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

getUserSelectedDevices()

الوعد 
chrome.usb.getUserSelectedDevices(
  options: DevicePromptOptions,
  callback?: function,
)

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

المعلمات

  • الخيارات

    DevicePromptOptions

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

  • ردّ الاتصال

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

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

    (devices: Device[]) => void

المرتجعات

  • Promise<Device[]>

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

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

interruptTransfer()

الوعد 
chrome.usb.interruptTransfer(
  handle: ConnectionHandle,
  transferInfo: GenericTransferInfo,
  callback?: function,
)

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

المعلمات

المرتجعات

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

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

isochronousTransfer()

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

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

المعلمات

المرتجعات

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

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

listInterfaces()

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

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

المعلمات

  • مؤشر

    ConnectionHandle

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

  • ردّ الاتصال

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

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

    (descriptors: InterfaceDescriptor[]) => void

المرتجعات

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

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

openDevice()

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

لفتح جهاز USB تم إرجاعه من خلال getDevices

المعلمات

المرتجعات

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

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

releaseInterface()

الوعد 
chrome.usb.releaseInterface(
  handle: ConnectionHandle,
  interfaceNumber: number,
  callback?: function,
)

إزالة واجهة تمّت المطالبة بملكيتها

المعلمات

  • مؤشر

    ConnectionHandle

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

  • interfaceNumber

    الرقم

    الواجهة التي سيتم طرحها

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

requestAccess()

Promise تم إيقافه نهائيًا
chrome.usb.requestAccess(
  device: Device,
  interfaceId: number,
  callback?: function,
)

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

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

المعلمات

  • جهاز

    الجهاز

    Device لطلب الوصول إليها.

  • interfaceId

    الرقم

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

  • ردّ الاتصال

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

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

    (success: boolean) => void

    • النجاح

      قيمة منطقية

المرتجعات

  • Promise<boolean>

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

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

resetDevice()

الوعد 
chrome.usb.resetDevice(
  handle: ConnectionHandle,
  callback?: function,
)

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

المعلمات

  • مؤشر

    ConnectionHandle

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

  • ردّ الاتصال

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

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

    (success: boolean) => void

    • النجاح

      قيمة منطقية

المرتجعات

  • Promise<boolean>

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

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

setConfiguration()

الوعد 
chrome.usb.setConfiguration(
  handle: ConnectionHandle,
  configurationValue: number,
  callback?: function,
)

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

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

المعلمات

  • مؤشر

    ConnectionHandle

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

  • configurationValue

    الرقم

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

setInterfaceAlternateSetting()

الوعد 
chrome.usb.setInterfaceAlternateSetting(
  handle: ConnectionHandle,
  interfaceNumber: number,
  alternateSetting: number,
  callback?: function,
)

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

المعلمات

  • مؤشر

    ConnectionHandle

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

  • interfaceNumber

    الرقم

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

  • alternateSetting

    الرقم

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<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