الوصف
استخدام واجهة برمجة التطبيقات chrome.usb
API للتفاعل مع أجهزة USB المتصلة توفر واجهة برمجة التطبيقات هذه إمكانية الوصول إلى عمليات USB من داخل سياق التطبيق. وباستخدام واجهة برمجة التطبيقات هذه، يمكن أن تعمل التطبيقات كبرامج تشغيل للأجهزة. يتم الإبلاغ عن الأخطاء التي تنشأ من خلال واجهة برمجة التطبيقات هذه من خلال ضبط runtime.lastError
وتنفيذ رد الاتصال العادي للدالة. ستكون المعلَمات العادية لمعاودة الاتصال غير معرَّفة في هذه الحالة.
الأذونات
usb
الأنواع
ConfigDescriptor
أماكن إقامة
-
نشطة
boolean
Chrome 47 والإصدارات الأحدثهل هذه هي الإعدادات النشطة؟
-
configurationValue
الرقم
رقم الإعداد
-
الوصف
سلسلة اختيارية
وصف الإعداد.
-
extra_data
ArrayBuffer
بيانات الواصف الإضافية المرتبطة بهذه الإعدادات.
-
واجهات
الواجهات المتاحة
-
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
نوع الطلب
-
وقت مستقطع
الرقم اختياري
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 اختيارية
نقل وضع المزامنة (متساوي التباين فقط).
-
كتابة
نوع التحويل
-
الاستخدام
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
) -
الوصف
سلسلة اختيارية
وصف الواجهة.
-
نقاط النهاية
نقاط النهاية المتاحة.
-
extra_data
ArrayBuffer
بيانات وصفية إضافية مرتبطة بهذه الواجهة
-
interfaceClass
الرقم
فئة واجهة USB.
-
interfaceNumber
الرقم
رقم الواجهة
-
interfaceProtocol
الرقم
بروتوكول واجهة USB.
-
interfaceSubclass
الرقم
الفئة الفرعية لواجهة USB.
IsochronousTransferInfo
أماكن إقامة
-
packetLength
الرقم
طول كل حزمة من الحزم في عملية النقل هذه.
-
الحزم
الرقم
إجمالي عدد الحزم في عملية النقل هذه.
-
transferInfo
معلمات النقل. يتم تقسيم مدة النقل أو المخزن المؤقت للبيانات المحدّد في مجموعة المعلمات على طول حدود
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,
)
إجراء عملية نقل مُجمَّعة على الجهاز المحدَّد.
المَعلمات
-
اسم الحساب
اتصال مفتوح بالجهاز.
-
transferInfo
معلَمات النقل.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(info: TransferResultInfo) => void
-
معلومات
-
المرتجعات
-
Promise<TransferResultInfo>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
claimInterface()
chrome.usb.claimInterface(
handle: ConnectionHandle,
interfaceNumber: number,
callback?: function,
)
للمطالبة بواجهة على جهاز USB. يجب المطالبة بالواجهة قبل نقل البيانات إلى واجهة أو نقاط نهاية مرتبطة بها. يمكن مؤشر اتصال واحد فقط المطالبة بواجهة في أي وقت. سيتعذّر إتمام هذا الطلب إذا سبق أن تمت المطالبة بالواجهة.
يجب طلب releaseInterface
عند عدم الحاجة إلى الواجهة.
المَعلمات
-
اسم الحساب
اتصال مفتوح بالجهاز.
-
interfaceNumber
الرقم
الواجهة المطلوب المطالبة بها
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
closeDevice()
chrome.usb.closeDevice(
handle: ConnectionHandle,
callback?: function,
)
لإغلاق مؤشر الاتصال. إنّ استدعاء عمليات على الاسم المعرِّف بعد إغلاقه هو عملية آمنة ولكنها لا تؤدي إلى اتخاذ أي إجراء.
المَعلمات
-
اسم الحساب
يتم إغلاق
ConnectionHandle
. -
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
controlTransfer()
chrome.usb.controlTransfer(
handle: ConnectionHandle,
transferInfo: ControlTransferInfo,
callback?: function,
)
تتيح لك هذه السياسة نقل عناصر التحكّم على الجهاز المحدّد.
تشير عمليات نقل التحكم إلى الجهاز أو الواجهة أو نقطة النهاية. تتطلّب عمليات النقل إلى واجهة أو نقطة نهاية المطالبة بالواجهة.
المَعلمات
-
اسم الحساب
اتصال مفتوح بالجهاز.
-
transferInfo
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(info: TransferResultInfo) => void
-
معلومات
-
المرتجعات
-
Promise<TransferResultInfo>
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,
)
الحصول على واصف الإعدادات للإعدادات المحدّدة حاليًا.
المَعلمات
-
اسم الحساب
اتصال مفتوح بالجهاز.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(config: ConfigDescriptor) => void
-
config
-
المرتجعات
-
Promise<ConfigDescriptor>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getConfigurations()
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 المتصلة.
المَعلمات
المرتجعات
-
تقديم وعود بإرسال<الجهاز[]>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getUserSelectedDevices()
chrome.usb.getUserSelectedDevices(
options: DevicePromptOptions,
callback?: function,
)
تعرض هذه السياسة أداة اختيار الجهاز للمستخدم وتعرض Device
التي تم اختيارها. وإذا ألغى المستخدم أداة الاختيار، ستكون أجهزة الاختيار فارغة. يجب استخدام إيماءة المستخدم حتى يتم عرض مربّع الحوار. بدون إيماءة المستخدم، ستتم إعادة الاتصال كما لو كان المستخدم قد ألغى الاتصال.
المَعلمات
المرتجعات
-
تقديم وعود بإرسال<الجهاز[]>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
interruptTransfer()
chrome.usb.interruptTransfer(
handle: ConnectionHandle,
transferInfo: GenericTransferInfo,
callback?: function,
)
يجري نقل مقاطعة على الجهاز المحدد.
المَعلمات
-
اسم الحساب
اتصال مفتوح بالجهاز.
-
transferInfo
معلَمات النقل.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(info: TransferResultInfo) => void
-
معلومات
-
المرتجعات
-
Promise<TransferResultInfo>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
isochronousTransfer()
chrome.usb.isochronousTransfer(
handle: ConnectionHandle,
transferInfo: IsochronousTransferInfo,
callback?: function,
)
وتُجري عملية نقل متساوية الوقت على الجهاز المحدد.
المَعلمات
-
اسم الحساب
اتصال مفتوح بالجهاز.
-
transferInfo
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(info: TransferResultInfo) => void
-
معلومات
-
المرتجعات
-
Promise<TransferResultInfo>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
listInterfaces()
chrome.usb.listInterfaces(
handle: ConnectionHandle,
callback?: function,
)
يسرد جميع الواجهات على جهاز USB.
المَعلمات
-
اسم الحساب
اتصال مفتوح بالجهاز.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(descriptors: InterfaceDescriptor[]) => void
-
descriptors
-
المرتجعات
-
Promise<InterfaceDescriptor[]>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
openDevice()
chrome.usb.openDevice(
device: Device,
callback?: function,
)
لفتح جهاز USB تم إرجاعه من خلال getDevices
.
المَعلمات
-
جهاز
Device
التي سيتم فتحها. -
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(handle: ConnectionHandle) => void
-
اسم الحساب
-
المرتجعات
-
Promise<ConnectionHandle>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
releaseInterface()
chrome.usb.releaseInterface(
handle: ConnectionHandle,
interfaceNumber: number,
callback?: function,
)
إصدار واجهة تمّت المطالبة بملكيتها
المَعلمات
-
اسم الحساب
اتصال مفتوح بالجهاز.
-
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
مرة أخرى للحصول على الجهاز.
المَعلمات
-
اسم الحساب
مؤشر اتصال لإعادة ضبطه.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(success: boolean) => void
-
نجاح
boolean
-
المرتجعات
-
Promise<boolean>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
setConfiguration()
chrome.usb.setConfiguration(
handle: ConnectionHandle,
configurationValue: number,
callback?: function,
)
اختَر أحد إعدادات الجهاز.
تؤدي هذه الوظيفة إلى إعادة ضبط الجهاز بفعالية من خلال اختيار إحدى الإعدادات المتاحة للجهاز. إنّ قيم الإعدادات الأكبر من 0
هي فقط صالحة للاستخدام، إلا أنّ بعض الأجهزة التي تحتوي على أخطاء تتضمّن ضبط 0
صالحًا، وبالتالي يُسمح باستخدام هذه القيمة.
المَعلمات
-
اسم الحساب
اتصال مفتوح بالجهاز.
-
configurationValue
الرقم
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 116 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
setInterfaceAlternateSetting()
chrome.usb.setInterfaceAlternateSetting(
handle: ConnectionHandle,
interfaceNumber: number,
alternateSetting: number,
callback?: function,
)
لاختيار إعداد بديل على واجهة تمت المطالبة بها سابقًا.
المَعلمات
-
اسم الحساب
اتصال مفتوح بالجهاز الذي تمت المطالبة بهذه الواجهة عليه.
-
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
لمعرفة الأحداث التي يتم تسليم الأحداث الخاصة بها.