chrome.usb

الوصف

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

الأذونات

usb

الأنواع

ConfigDescriptor

أماكن إقامة

  • نشطة

    boolean

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

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

  • configurationValue

    الرقم

    رقم الإعداد

  • الوصف

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

    وصف الإعداد.

  • extra_data

    ArrayBuffer

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

  • واجهات

    InterfaceDescriptor[]

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

  • maxPower

    الرقم

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

  • remoteWakeup

    boolean

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

  • selfPowered

    boolean

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

ConnectionHandle

أماكن إقامة

  • اسم الحساب

    الرقم

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

  • productId

    الرقم

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

  • vendorId

    الرقم

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

ControlTransferInfo

أماكن إقامة

  • البيانات

    ArrayBuffer اختيارية

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

  • direction

    الاتجاه

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

  • المؤشر

    الرقم

    الحقل wIndex، اطّلِع على المرجع السابق.

  • length

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

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

  • مستلم

    المستلِم

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

  • طلب

    الرقم

    الحقل bRequest، راجع مراجعة مواصفات الناقل التسلسلي العالمي 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

ترتبط كل أنواع الاتجاهات والمستلم وRequestType و TransferType بأسمائها استنادًا إلى مواصفات USB.

التعداد

"out"

EndpointDescriptor

أماكن إقامة

  • معالجة

    الرقم

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

  • direction

    الاتجاه

    اتجاه النقل.

  • extra_data

    ArrayBuffer

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

  • maximumPacketSize

    الرقم

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

  • pollingInterval

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

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

  • المزامنة

    SynchronizationType اختيارية

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

  • كتابة

    TransferType

    نوع التحويل

  • الاستخدام

    UsageType اختيارية

    تلميح بشأن استخدام نقطة النهاية

EnumerateDevicesAndRequestAccessOptions

أماكن إقامة

  • interfaceId

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

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

  • productId

    الرقم

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

  • vendorId

    الرقم

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

EnumerateDevicesOptions

أماكن إقامة

  • الفلاتر

    DeviceFilter[] اختيارية

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

  • productId

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

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

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

  • vendorId

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

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

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

GenericTransferInfo

أماكن إقامة

  • البيانات

    ArrayBuffer اختيارية

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

  • direction

    الاتجاه

    اتجاه النقل ("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

التعداد

RequestType

التعداد

"class"

SynchronizationType

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

التعداد

TransferResultInfo

أماكن إقامة

  • البيانات

    ArrayBuffer اختيارية

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

  • resultCode

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

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

TransferType

التعداد

"control"

UsageType

التعداد

"data"

"explicitFeedback"

الطُرق

bulkTransfer()

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

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

المَعلمات

المرتجعات

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

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

claimInterface()

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

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

يجب طلب releaseInterface عند عدم الحاجة إلى الواجهة.

المَعلمات

  • اسم الحساب

    ConnectionHandle

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

  • interfaceNumber

    الرقم

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

closeDevice()

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

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

المَعلمات

  • اسم الحساب

    ConnectionHandle

    يتم إغلاق ConnectionHandle.

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

controlTransfer()

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

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

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

المَعلمات

المرتجعات

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

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

findDevices()

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

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

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

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

المَعلمات

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (handles: ConnectionHandle[])=>void

المرتجعات

  • Promise<ConnectionHandle[]>

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

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

getConfiguration()

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

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

المَعلمات

  • اسم الحساب

    ConnectionHandle

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (config: ConfigDescriptor)=>void

المرتجعات

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

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

getConfigurations()

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

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

المَعلمات

  • جهاز

    الجهاز

    سمة Device التي يتم جلب أدوات الوصف منها.

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (configs: ConfigDescriptor[])=>void

المرتجعات

  • Promise<ConfigDescriptor[]>

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

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

getDevices()

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

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

المَعلمات

  • الخيارات

    EnumerateDevicesOptions

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (devices: Device[])=>void

المرتجعات

  • تقديم وعود بإرسال<الجهاز[]>

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

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

getUserSelectedDevices()

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

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

المَعلمات

  • الخيارات

    DevicePromptOptions

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (devices: Device[])=>void

المرتجعات

  • تقديم وعود بإرسال<الجهاز[]>

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

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

interruptTransfer()

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

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

المَعلمات

المرتجعات

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

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

isochronousTransfer()

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

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

المَعلمات

المرتجعات

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

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

listInterfaces()

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

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

المَعلمات

  • اسم الحساب

    ConnectionHandle

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (descriptors: InterfaceDescriptor[])=>void

المرتجعات

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

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

openDevice()

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

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

المَعلمات

  • جهاز

    الجهاز

    Device التي سيتم فتحها.

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (handle: ConnectionHandle)=>void

المرتجعات

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

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

releaseInterface()

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

إصدار واجهة تمّت المطالبة بملكيتها

المَعلمات

  • اسم الحساب

    ConnectionHandle

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

  • interfaceNumber

    الرقم

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

requestAccess()

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

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

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

المَعلمات

  • جهاز

    الجهاز

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

  • interfaceId

    الرقم

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (success: boolean)=>void

    • نجاح

      boolean

المرتجعات

  • Promise<boolean>

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

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

resetDevice()

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

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

المَعلمات

  • اسم الحساب

    ConnectionHandle

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (success: boolean)=>void

    • نجاح

      boolean

المرتجعات

  • Promise<boolean>

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

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

setConfiguration()

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

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

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

المَعلمات

  • اسم الحساب

    ConnectionHandle

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

  • configurationValue

    الرقم

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

setInterfaceAlternateSetting()

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

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

المَعلمات

  • اسم الحساب

    ConnectionHandle

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

  • interfaceNumber

    الرقم

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

  • alternateSetting

    الرقم

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

    لا تتوفّر الوعود إلا في الإصدار 3 من 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