الوصف
استخدِم واجهة برمجة التطبيقات chrome.bluetooth
API للاتصال بجهاز يتضمّن بلوتوث. تُبلغ جميع الوظائف عن تعذُّر العثور على الملفات من خلال chrome.runtime.lastError.
البيان
يجب الإعلان عن المفاتيح التالية في ملف البيان كي تتمكّن من استخدام واجهة برمجة التطبيقات هذه.
"bluetooth"
الأنواع
AdapterState
أماكن إقامة
-
معالجة
سلسلة
تمثّل هذه السمة عنوان المحوّل بالتنسيق "XX:XX:XX:XX:XX:XX".
-
متوفر
boolean
يشير إلى ما إذا كان المحوّل متاحًا أم لا (أي مفعَّل).
-
اكتشاف
boolean
تشير هذه القيمة إلى ما إذا كان المحوّل يرصد حاليًا أي أجهزة.
-
اسم
سلسلة
تمثّل هذه السمة اسم المحوِّل الذي يمكن لشخص عادي قراءته.
-
تم التشغيل
boolean
تشير هذه العلامة إلى ما إذا كان المحوّل لديه طاقة أم لا.
BluetoothFilter
أماكن إقامة
-
filterType
FilterType اختيارية
نوع الفلتر المطلوب تطبيقه على قائمة الأجهزة. الإعداد التلقائي هو الكل.
-
الحدّ الأقصى المسموح به
الرقم اختياري
الحد الأقصى لعدد الأجهزة التي تتضمّن بلوتوث المطلوب إرجاعها وتكون القيمة التلقائية 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
أنواع فلترة الأجهزة التي تتضمّن بلوتوث
التعداد
"known"
Transport
نوع نقل الجهاز الذي يتضمّن بلوتوث
التعداد
"le"
VendorIdSource
جهات التخصيص لمعرّفات المورّدين.
التعداد
"usb"
الطُرق
getAdapterState()
chrome.bluetooth.getAdapterState(
callback?: function,
)
يمكنك الحصول على معلومات حول محوّل البلوتوث.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(adapterInfo: AdapterState) => void
-
adapterInfo
عنصر يحتوي على معلومات المحوّل.
-
المرتجعات
-
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
-
state
-
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,
)
يتم تشغيله عندما يكون جهاز بلوتوث تم اكتشافه سابقًا خارج النطاق لفترة كافية ليتم اعتباره غير متاح مرة أخرى، وعند إزالة جهاز مقترن.