chrome.bluetooth

الوصف

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

البيان

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

"bluetooth"

الأنواع

AdapterState

أماكن إقامة

• معالجة

  سلسلة

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

• متوفر

  منطقي

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

• اكتشاف

  منطقي

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

• الاسم

  سلسلة

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

• مشغَّل

  منطقي

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

BluetoothFilter

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

أماكن إقامة

• filterType

  FilterType اختياري

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

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

  الرقم اختياري

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

Device

أماكن إقامة

• معالجة

  سلسلة

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

• batteryPercentage

  الرقم اختياري

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

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

• قابل للاتصال

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

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

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

• تم الربط

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

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

• رحلة ربط

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

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

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

• deviceClass

  الرقم اختياري

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

• deviceId

  الرقم اختياري

• inquiryRssi

  الرقم اختياري

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

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

• inquiryTxPower

  الرقم اختياري

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

  مستوى الطاقة المنقولة. هذا الحقل متاح فقط لأجهزة LE التي تتضمن هذا الحقل في AD. وهو متاح وصالح فقط خلال فترة الاكتشاف.

• الاسم

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

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

• مقترن

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

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

• productId

  الرقم اختياري

• طبقة النقل

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

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

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

• كتابة

  DeviceType اختيارية

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

• uuids

  string[] اختيارية

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

• vendorId

  الرقم اختياري

• vendorIdSource

  VendorIdSource اختيارية

  سجلّ رقم تعريف الجهاز الخاص بالجهاز، حيثما كان ذلك متاحًا

DeviceType

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

Enum

"جهاز الكمبيوتر"

"الهاتف"

"modem"

"audio"

"carAudio"

"الفيديو"

"ملحق"

"ذراع التحكّم"

"gamepad"

"لوحة المفاتيح"

"ماوس"

"الجهاز اللوحي"

"لوحة المفاتيحMouseCombo"

FilterType

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

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

Enum

"الكل"

"معروف"

Transport

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

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

Enum

"غير صالح"

"كلاسيكي"

"le"

"ثنائي"

VendorIdSource

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

Enum

"البلوتوث"

"usb"

الطُرق

getAdapterState()

وعود

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

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

المعلمات

• رد الاتصال

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

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

  (adapterInfo: AdapterState) => void

  • adapterInfo

    AdapterState

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

المرتجعات

• Promise<AdapterState>

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

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

getDevice()

وعود

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

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

المعلمات

• deviceAddress

  سلسلة

  عنوان الجهاز الذي تريد الحصول عليه.

• رد الاتصال

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

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

  (deviceInfo: Device) => void

  • deviceInfo

    الجهاز

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

المرتجعات

• Promise<Device>

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

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

getDevices()

وعود

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

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

المعلمات

• تصفية

  BluetoothFilter اختياري

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

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

• رد الاتصال

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

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

  (deviceInfos: Device[]) => void

  • deviceInfos

    الجهاز[]

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

المرتجعات

• الوعد<Device[]>

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

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

startDiscovery()

وعود

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

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

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

المعلمات

• رد الاتصال

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

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

  () => void

المرتجعات

• وعود <باطلة>

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

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

stopDiscovery()

وعود

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

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

المعلمات

• رد الاتصال

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

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

  () => void

المرتجعات

• وعود <باطلة>

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

  لا تتوفّر الوعود إلا مع إصدار 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

  • جهاز

    الجهاز