chrome.bluetooth

الوصف

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

البيان

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

"bluetooth"

الأنواع

AdapterState

أماكن إقامة

  • معالجة

    سلسلة

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

  • متوفر

    boolean

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

  • اكتشاف

    boolean

    تشير هذه القيمة إلى ما إذا كان المحوّل يرصد حاليًا أي أجهزة.

  • اسم

    سلسلة

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

  • تم التشغيل

    boolean

    تشير هذه العلامة إلى ما إذا كان المحوّل لديه طاقة أم لا.

BluetoothFilter

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

أماكن إقامة

  • filterType

    FilterType اختيارية

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

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

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

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

Device

أماكن إقامة

  • معالجة

    سلسلة

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

  • batteryPercentage

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

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

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

  • قابلة للربط

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

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

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

  • تم الربط

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

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

  • رحلة ربط

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

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

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

  • deviceClass

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

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

  • deviceId

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

  • inquiryRssi

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

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

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

  • inquiryTxPower

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

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

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

  • اسم

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

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

  • زوجية

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

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

  • productId

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

  • طبقة النقل

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

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

    تشير هذه السمة إلى نوع عملية نقل الجهاز الذي يتضمّن بلوتوث.

  • كتابة

    DeviceType اختيارية

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

  • Uuids

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

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

  • vendorId

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

  • vendorIdSource

    VendorIdSource اختياري

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

DeviceType

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

التعداد

"phone"

"modem"

"audio"

FilterType

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

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

التعداد

"known"

Transport

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

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

التعداد

"le"

VendorIdSource

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

التعداد

"usb"

الطُرق

getAdapterState()

وعد 
chrome.bluetooth.getAdapterState(
  callback?: function,
)

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

المَعلمات

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (adapterInfo: AdapterState)=>void

    • adapterInfo

      AdapterState

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

المرتجعات

  • Promise<AdapterState>

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

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

getDevice()

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

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

المَعلمات

  • deviceAddress

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (deviceInfo: Device)=>void

    • deviceInfo

      الجهاز

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

المرتجعات

  • اعرض تعهدًا باستخدام<الجهاز>.

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

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

getDevices()

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

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

المَعلمات

  • filter

    BluetoothFilter اختياري

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

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (deviceInfos: Device[])=>void

    • deviceInfos

      الجهاز[]

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

المرتجعات

  • تقديم وعود بإرسال<الجهاز[]>

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

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

startDiscovery()

وعد 
chrome.bluetooth.startDiscovery(
  callback?: function,
)

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

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

المَعلمات

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

stopDiscovery()

وعد 
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

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

المَعلمات

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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