chrome.bluetooth

الوصف

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

مدى التوفّر

نظام التشغيل ChromeOS فقط

البيان

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

"bluetooth"

الأنواع

AdapterState

الخصائص

  • معالجة

    سلسلة

    عنوان المحوّل بالتنسيق 'XX:XX:XX:XX:XX:XX'.

  • متوفر

    قيمة منطقية

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

  • اكتشاف

    قيمة منطقية

    توضّح هذه السمة ما إذا كان المحوّل يبحث حاليًا عن أجهزة.

  • الاسم

    سلسلة

    تمثّل هذه السمة اسم المحوّل الذي يمكن للمستخدمين قراءته.

  • بدعم من

    قيمة منطقية

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

BluetoothFilter

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

الخصائص

  • filterType

    ‫FilterType اختياري

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

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

    number اختيارية

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

Device

الخصائص

  • معالجة

    سلسلة

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

  • batteryPercentage

    number اختيارية

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

    تشير هذه السمة إلى الطاقة المتبقية في بطارية الجهاز.

  • قابلة للربط

    boolean اختياري

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

    يشير إلى ما إذا كان يمكن ربط الجهاز.

  • تم الربط

    boolean اختياري

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

  • رحلة ربط

    boolean اختياري

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

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

  • deviceClass

    number اختيارية

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

  • deviceId

    number اختيارية

  • inquiryRssi

    number اختيارية

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

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

  • inquiryTxPower

    number اختيارية

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

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

  • الاسم

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

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

  • مقترن

    boolean اختياري

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

  • productId

    number اختيارية

  • نقل

    وسيلة النقل اختيارية

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

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

  • النوع

    ‫DeviceType اختياري

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

  • uuids

    string[] اختياري

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

  • vendorId

    number اختيارية

  • vendorIdSource

    VendorIdSource اختيارية

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

DeviceType

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

تعداد

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

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

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

تعداد

"all"

"known"

Transport

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

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

تعداد

"invalid"

"classic"

"le"

"dual"

VendorIdSource

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

تعداد

"bluetooth"

"usb"

الطُرق

getAdapterState()

وعد 
chrome.bluetooth.getAdapterState(
  callback?: function,
): Promise<AdapterState>

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

المعلمات

  • callback

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

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

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

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

المرتجعات

  • Promise<AdapterState>

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

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

getDevice()

وعد 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
): Promise<Device>

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

المعلمات

  • deviceAddress

    سلسلة

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

  • callback

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

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

    (deviceInfo: Device) => void

    • deviceInfo

      الجهاز

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

المرتجعات

  • Promise<Device>

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

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

getDevices()

وعد 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
): Promise<Device[]>

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

المعلمات

  • تصفية

    BluetoothFilter اختياري

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

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

  • callback

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

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

    (deviceInfos: Device[]) => void

    • deviceInfos

      Device[]

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

المرتجعات

  • Promise<Device[]>

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

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

startDiscovery()

وعد 
chrome.bluetooth.startDiscovery(
  callback?: function,
): Promise<void>

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

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

المعلمات

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

stopDiscovery()

وعد 
chrome.bluetooth.stopDiscovery(
  callback?: function,
): Promise<void>

إيقاف الاستكشاف

المعلمات

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

الفعاليات

onAdapterStateChanged

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

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

المعلمات

  • callback

    دالة

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

    (state: AdapterState) => void

onDeviceAdded

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

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

المعلمات

  • callback

    دالة

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

    (device: Device) => void

onDeviceChanged

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

يتم تنشيط هذا الحدث عند تغيير معلومات حول جهاز Bluetooth معروف.

المعلمات

  • callback

    دالة

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

    (device: Device) => void

onDeviceRemoved

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

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

المعلمات

  • callback

    دالة

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

    (device: Device) => void