chrome.bluetooth

الوصف

استخدِم واجهة برمجة التطبيقات chrome.bluetooth للاتصال بجهاز يتضمّن بلوتوث. تُبلغ جميع الدوالّ عن الأخطاء من خلال chrome.runtime.lastError.

البيان

يجب الإفصاح عن المفاتيح التالية في البيان لاستخدام واجهة برمجة التطبيقات هذه.

"bluetooth"

الأنواع

AdapterState

أماكن إقامة

• معالجة

  سلسلة

  عنوان المحوِّل بالتنسيق "XX:XX:XX:XX:XX:XX"

• متوفر

  قيمة منطقية

  يشير إلى ما إذا كان المحوِّل متاحًا أم لا (أي مفعَّلاً).

• الاستكشاف

  قيمة منطقية

  يشير إلى ما إذا كان المحوِّل يجري عملية اكتشاف حاليًا أم لا.

• الاسم

  سلسلة

  اسم المحوِّل السهل القراءة

• مدعوم

  قيمة منطقية

  يشير إلى ما إذا كان محوِّل الطاقة متصلاً بالطاقة أم لا.

BluetoothFilter

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

أماكن إقامة

• filterType

  ‫FilterType اختياري

  نوع الفلتر الذي سيتم تطبيقه على قائمة الأجهزة الإعداد التلقائي هو "الكل".

• الحدّ الأقصى المسموح به

  رقم اختياري

  الحد الأقصى لعدد أجهزة البلوتوث التي سيتم عرضها القيمة التلقائية هي 0 (بدون حدّ) في حال عدم تحديدها.

Device

أماكن إقامة

• معالجة

  سلسلة

  عنوان الجهاز بالتنسيق "XX:XX:XX:XX:XX:XX"

• batteryPercentage

  رقم اختياري

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

  الطاقة المتبقية في بطارية الجهاز

• قابلة للربط

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

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

  يشير إلى ما إذا كان الجهاز قابلاً للاتصال.

• تم الربط

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

  يشير إلى ما إذا كان الجهاز متصلاً حاليًا بالنظام.

• رحلة ربط

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

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

  يشير إلى ما إذا كان الجهاز يتصل حاليًا بالنظام.

• deviceClass

  رقم اختياري

  فئة الجهاز، وهي حقل بتات محدّد من خلال http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

• deviceId

  رقم اختياري

• inquiryRssi

  رقم اختياري

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

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

• inquiryTxPower

  رقم اختياري

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

  مستوى الطاقة المُرسَلة لا يتوفّر هذا الحقل إلا لأجهزة LE التي تتضمّن هذا الحقل في AD. ولا يتوفّر هذا الخيار إلا أثناء التصفّح.

• الاسم

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

  اسم الجهاز الذي يمكن لشخص عادي قراءته

• مقترن

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

  يشير إلى ما إذا كان الجهاز مقترنًا بالنظام أم لا.

• productId

  رقم اختياري

• النقل

  النقل اختياري

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

  نوع النقل لجهاز البلوتوث

• كتابة

  ‫DeviceType اختياري

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

• uuids

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

  أرقام تعريف UUID الخاصة بالبروتوكولات والملفات الشخصية والخدمات التي يُعلِن عنها الجهاز بالنسبة إلى أجهزة البلوتوث الكلاسيكية، يتم الحصول على هذه القائمة من بيانات EIR وجداول SDP. بالنسبة إلى الأجهزة ذات الطاقة المنخفضة، يتم الحصول على هذه القائمة من الخدمات الأساسية لبروتوكول AD وGATT. بالنسبة إلى الأجهزة المزوّدة بوضعَين، يمكن الحصول على هذا الرقم من كلا الوضعَين.

• vendorId

  رقم اختياري

• vendorIdSource

  ‫VendorIdSource اختيارية

  سجلّ رقم تعريف الجهاز، إن توفّر.

DeviceType

أنواع الأجهزة الشائعة التي يتعرّف عليها Chrome

Enum

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

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

أنواع لفلترة أجهزة البلوتوث

Enum

"all"

"known"

Transport

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

نوع النقل لجهاز البلوتوث

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

جهات التخصيص لمعرّفات المورّدين

Enum

"bluetooth"

"usb"

الطُرق

getAdapterState()

الوعد

chrome.bluetooth.getAdapterState(
  callback?: function,
)

الحصول على معلومات عن محوِّل البلوتوث

المعلمات

• ردّ الاتصال

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

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

  (adapterInfo: AdapterState) => void

  • adapterInfo

    AdapterState

    عنصر يحتوي على معلومات المحوِّل

المرتجعات

• Promise<AdapterState>

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

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

getDevice()

الوعد

chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

الحصول على معلومات عن جهاز بلوتوث معروف للنظام

المعلمات

• deviceAddress

  سلسلة

  عنوان الجهاز المطلوب الحصول عليه

• ردّ الاتصال

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

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

  (deviceInfo: Device) => void

  • deviceInfo

    الجهاز

    عنصر يحتوي على معلومات الجهاز

المرتجعات

• Promise<Device>

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

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

getDevices()

الوعد

chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

الحصول على قائمة بأجهزة البلوتوث المعروفة للنظام، بما في ذلك الأجهزة المقترنة والأجهزة التي تم اكتشافها مؤخرًا

المعلمات

• تصفية

  ‫BluetoothFilter اختياري

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

  بعض المعايير لفلترة قائمة أجهزة البلوتوث التي تم إرجاعها إذا لم يتم ضبط الفلتر أو تم ضبطه على {}، ستتضمّن قائمة الأجهزة المعروضة جميع الأجهزة التي تتضمّن بلوتوث. لا تتوفّر هذه الميزة حاليًا إلا في نظام التشغيل ChromeOS، ولكن يتم عرض قائمة كاملة للأنظمة الأساسية الأخرى.

• ردّ الاتصال

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

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

  (deviceInfos: Device[]) => void

  • deviceInfos

    الجهاز[]

    صفيف من العناصر التي تحتوي على معلومات الجهاز

المرتجعات

• Promise<Device[]>

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

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

startDiscovery()

الوعد

chrome.bluetooth.startDiscovery(
  callback?: function,
)

ابدأ الاستكشاف. سيتم عرض الأجهزة التي تم اكتشافها مؤخرًا من خلال الحدث onDeviceAdded. يجب الحصول على الأجهزة التي تم اكتشافها سابقًا والتي يعرفها المحوِّل باستخدام getDevices ولن يتم تعديلها إلا باستخدام الحدث onDeviceChanged في حال تغيّرت المعلومات عنها.

لن يتمكّن تطبيقك من بدء ميزة "التصفّح" إذا سبق له استدعاء startDiscovery. يمكن أن تستهلك عملية الاكتشاف موارد كثيرة، لذا يجب استدعاء stopDiscovery في أقرب وقت ممكن.

المعلمات

• ردّ الاتصال

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

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

  () => void

المرتجعات

• Promise<void>

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

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

stopDiscovery()

الوعد

chrome.bluetooth.stopDiscovery(
  callback?: function,
)

إيقاف ميزة "اقتراحات"

المعلمات

• ردّ الاتصال

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

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

  () => void

المرتجعات

• Promise<void>

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

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

الفعاليات

onAdapterStateChanged

chrome.bluetooth.onAdapterStateChanged.addListener(
  callback: function,
)

يتم تشغيله عند تغيير حالة محوِّل البلوتوث.

المعلمات

• ردّ الاتصال

  دالة

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

  (state: AdapterState) => void

  • الولاية

    AdapterState

onDeviceAdded

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

يتم تشغيله عند توفُّر معلومات عن جهاز بلوتوث جديد.

المعلمات

• ردّ الاتصال

  دالة

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

  (device: Device) => void

  • جهاز

    الجهاز

onDeviceChanged

chrome.bluetooth.onDeviceChanged.addListener(
  callback: function,
)

يتم تشغيله عند تغيير معلومات عن جهاز بلوتوث معروف.

المعلمات

• ردّ الاتصال

  دالة

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

  (device: Device) => void

  • جهاز

    الجهاز

onDeviceRemoved

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

يتم تشغيله عندما يكون جهاز بلوتوث تم اكتشافه سابقًا خارج النطاق لفترة طويلة بما يكفي ليُعتبر غير متاح مرة أخرى، وعند إزالة جهاز مقترن.

المعلمات

• ردّ الاتصال

  دالة

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

  (device: Device) => void

  • جهاز

    الجهاز