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

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