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، راجِع Ibid.

  • length

    number اختياري

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

  • مستلم

    المستلِم

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

  • طلب

    الرقم

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

  • requestType

    RequestType

    نوع الطلب

  • وقت مستقطع

    number اختياري

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

    مهلة الطلب (بالمللي ثانية) تشير القيمة التلقائية 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.

Enum

"in"

"out"

EndpointDescriptor

الخصائص

  • معالجة

    الرقم

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

  • اتجاه

    الاتجاه

    اتجاه النقل

  • extra_data

    ArrayBuffer

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

  • maximumPacketSize

    الرقم

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

  • pollingInterval

    number اختياري

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

  • المزامنة

    SynchronizationType اختياري

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

  • النوع

    TransferType

    نوع النقل

  • الاستخدام

    UsageType اختياري

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

EnumerateDevicesAndRequestAccessOptions

الخصائص

  • interfaceId

    number اختياري

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

  • productId

    الرقم

    معرّف المنتج

  • vendorId

    الرقم

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

EnumerateDevicesOptions

الخصائص

  • الفلاتر

    DeviceFilter[] اختياري

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

  • productId

    number اختياري

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

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

  • vendorId

    number اختياري

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

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

GenericTransferInfo

الخصائص

  • البيانات

    ArrayBuffer اختياري

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

  • اتجاه

    الاتجاه

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

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

    الرقم

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

  • length

    number اختياري

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

  • وقت مستقطع

    number اختياري

    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"

"adaptive"

"synchronous"

TransferResultInfo

الخصائص

  • البيانات

    ArrayBuffer اختياري

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

  • resultCode

    number اختياري

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

TransferType

Enum

"control"

"interrupt"

"isochronous"

"bulk"

UsageType

Enum

"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