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 والإصدارات الأحدث

    مستوى شحن البطارية المتبقي في الجهاز

  • connectable

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

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

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

  • تم الربط

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

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

  • رحلة ربط

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

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

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

  • deviceClass

    number اختيارية

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

  • deviceId

    number اختيارية

  • inquiryRssi

    number اختيارية

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

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

  • inquiryTxPower

    number اختيارية

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

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

  • الاسم

    string اختياري

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

  • مقترن

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

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

  • productId

    number اختيارية

  • النقل

    Transport اختيارية

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

    نوع النقل للجهاز الذي يتضمّن بلوتوث

  • النوع

    DeviceType اختياري

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

  • uuids

    string[] اختياري

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

  • vendorId

    number اختيارية

  • vendorIdSource

    VendorIdSource اختيارية

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

DeviceType

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

Enum

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

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

أنواع لفلترة الأجهزة التي تتضمّن بلوتوث

Enum

"all"

"known"

Transport

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

نوع النقل لجهاز يتضمّن بلوتوث

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

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

Enum

"bluetooth"

"usb"

الطُرق

getAdapterState()

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

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

المعلمات

  • callback

    function اختياري

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

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

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

المرتجعات

  • Promise<AdapterState>

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

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

getDevice()

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

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

المعلمات

  • deviceAddress

    سلسلة

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

  • callback

    function اختياري

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

    (deviceInfo: Device) => void

    • deviceInfo

      الجهاز

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

المرتجعات

  • Promise<Device>

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

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

getDevices()

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

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

المعلمات

  • تصفية

    BluetoothFilter اختياري

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

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

  • callback

    function اختياري

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

    (deviceInfos: Device[]) => void

    • deviceInfos

      الجهاز[]

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

المرتجعات

  • Promise<Device[]>

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

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

startDiscovery()

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

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

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

المعلمات

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

stopDiscovery()

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

أوقِف ميزة "اكتشاف".

المعلمات

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

الفعاليات

onAdapterStateChanged

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

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

المعلمات

  • callback

    دالة

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

    (state: AdapterState) => void

onDeviceAdded

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

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

المعلمات

  • callback

    دالة

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

    (device: Device) => void

onDeviceChanged

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

يتم تفعيل هذا الحدث عند تغيير معلومات عن جهاز يتضمّن بلوتوث معروف.

المعلمات

  • callback

    دالة

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

    (device: Device) => void

onDeviceRemoved

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

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

المعلمات

  • callback

    دالة

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

    (device: Device) => void