chrome.bluetooth

الوصف

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

البيان

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

"bluetooth"

الأنواع

AdapterState

الخصائص

  • معالجة

    سلسلة

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

  • متوفر

    قيمة منطقية

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

  • اكتشاف

    قيمة منطقية

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

  • الاسم

    سلسلة

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

  • يتم التشغيل بواسطة

    قيمة منطقية

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

BluetoothFilter

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

الخصائص

  • 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

Enum

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

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

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

Enum

"all"

"known"

Transport

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

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

Enum

"invalid"

"classic"

"le"

"dual"

VendorIdSource

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

Enum

"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>

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

المعلمات

  • deviceAddress

    سلسلة

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

  • callback

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

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

    (deviceInfo: Device) => void

    • deviceInfo

      الجهاز

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

المرتجعات

  • Promise<Device>

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

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

getDevices()

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

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

المعلمات

  • تصفية

    BluetoothFilter اختياري

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

    بعض المعايير لفلترة قائمة أجهزة البلوتوث التي تم إرجاعها إذا لم يتم ضبط الفلتر أو تم ضبطه على {}، ستتضمّن قائمة الأجهزة التي تم إرجاعها جميع أجهزة البلوتوث. في الوقت الحالي، لا تتوفّر هذه الميزة إلا في 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