الوصف
تُستخدَم واجهة برمجة التطبيقات chrome.bluetoothLowEnergy
للتواصل مع الأجهزة التي تتضمّن بلوتوث ذكية (منخفضة الطاقة) باستخدام الملف الشخصي للسمة العامة (GATT).
البيان
يجب الإعلان عن المفاتيح التالية في ملف البيان كي تتمكّن من استخدام واجهة برمجة التطبيقات هذه.
"bluetooth"
الأنواع
Advertisement
أماكن إقامة
-
manufacturerData
ManufacturerData[] اختيارية
قائمة بالبيانات الخاصة بالشركة المصنّعة التي سيتم تضمينها في حقول "البيانات الخاصة بالشركة المصنّعة" ضمن بيانات الإعلانات.
-
serviceData
ServiceData[] اختيارية
قائمة بيانات الخدمة التي سيتم تضمينها في حقول "بيانات الخدمة" الخاصة بالبيانات الإعلانية.
-
serviceUuids
سلسلة[] اختيارية
قائمة بمعرّفات UUID المطلوب تضمينها في حقل "معرّفات UUID للخدمة" في بيانات الإعلانات. ويمكن أن تكون أرقام التعريف الفريدة العالمية (UUID) هذه بتنسيقات 16 بت أو 32 بت أو 128.
-
solicitUuids
سلسلة[] اختيارية
قائمة أرقام التعريف الفريدة العالمية (UUID) المطلوب تضمينها في حقل "طلب معرّفات UUID" ضمن بيانات الإعلانات ويمكن أن تكون أرقام التعريف الفريدة العالمية (UUID) هذه بتنسيقات 16 بت أو 32 بت أو 128.
-
كتابة
نوع الإعلان
AdvertisementType
نوع الإعلان في حال اختيار "البث"، سيكون نوع الإعلان المُرسَل ADV_NONCONN_IND وسيتم بث الجهاز باستخدام عنوان MAC عشوائي. في حال ضبط السياسة على "جهاز ملحق"، سيكون نوع الإعلان ADV_IND أو ADV_SCAN_IND، وسيتم بث الجهاز باستخدام عنوان MAC لمحوّل بلوتوث الحقيقي.
التعداد
"broadcast"
Characteristic
أماكن إقامة
-
instanceId
سلسلة اختيارية
تعرض المعرّف المعيّن لهذه السمة. استخدِم رقم تعريف المثيل للتمييز بين الخصائص من جهاز ملحق يحمل المعرّف الفريد العالمي نفسه (UUID) وإجراء استدعاءات دالة تأخذ معرِّفًا مميزًا. إذا كان هذا المثيل يمثل خاصية بعيدة.
-
المواقع
تمثّل هذه السمة خصائص هذه السمة.
-
الخدمة
الخدمة اختيارية
خدمة GATT التي تنتمي إليها هذه السمة.
-
uuid
سلسلة
تمثّل هذه السمة المعرّف الفريد العالمي للسمة، مثل 00002a37-0000-1000-8000-00805f9b34fb.
-
القيمة
ArrayBuffer اختيارية
قيمة السمة المخزّنة مؤقتًا حاليًا. يتم تعديل هذه القيمة عند قراءة قيمة السمة أو تعديلها من خلال إشعار أو مؤشر.
CharacteristicProperty
يشير ذلك المصطلح إلى القيم التي تمثّل الخصائص المحتمَلة لإحدى السمات. يتم استنتاج الأذونات الخاصة بالخصائص من هذه السمات. يُرجى الاطّلاع على مواصفات Bluetooth 4.x لمعرفة معنى كل موقع فردي.
التعداد
"broadcast"
"writeWithoutResponse"
"reliableWrite"
"writableAuxiliaries"
"encryptRead"
"encryptWrite"
"encryptAuthenticatedRead"
"encryptAuthenticatedWrite"
ConnectProperties
أماكن إقامة
-
ثابت
boolean
علامة تشير إلى ترك الاتصال بالجهاز مفتوحًا عند إلغاء تحميل صفحة الحدث في التطبيق (راجِع إدارة مراحل نشاط التطبيق). القيمة التلقائية هي
false.
.
Descriptor
أماكن إقامة
-
خاصية
السمة اختيارية
تمثّل هذه السمة خاصية GATT التي ينتمي إليها الوصف.
-
instanceId
سلسلة اختيارية
تعرض المعرّف الذي تم تعيينه لهذا الوصف. استخدِم رقم تعريف المثيل للتمييز بين أدوات الوصف من جهاز ملحق يحمل المعرّف الفريد العالمي نفسه (UUID)، ولإجراء استدعاءات دالة تتطلّب معرِّفًا واصفًا. إذا كان هذا المثيل يمثل خاصية بعيدة.
-
الأذوناتChrome 52 والإصدارات الأحدث
تمثّل هذه السمة أذونات أداة الوصف هذه.
-
uuid
سلسلة
تمثّل هذه السمة المعرّف الفريد العالمي لوصف الميزة، مثل 00002902-0000-1000-8000-00805f9b34fb.
-
القيمة
ArrayBuffer اختيارية
قيمة أداة الوصف المخزّنة مؤقتًا حاليًا. يتم تعديل هذه القيمة عند قراءة قيمة الواصف.
DescriptorPermission
تمثّل هذه السمة القيم التي تمثّل الأذونات المحتمَلة للواصف. يُرجى الاطّلاع على مواصفات Bluetooth 4.x لمعرفة معنى كل إذن فردي.
التعداد
Device
أماكن إقامة
-
معالجة
سلسلة
عنوان الجهاز بالتنسيق "XX:XX:XX:XX:XX:XX"
-
deviceClass
الرقم اختياري
فئة الجهاز، وهي حقل بت يتم تحديده بواسطة http://www.Bluetooth.org/en-us/specification/assigned-numbers/base Band.
-
اسم
سلسلة اختيارية
تمثّل هذه السمة اسم الجهاز الذي يمكن لشخص عادي قراءته.
ManufacturerData
أماكن إقامة
-
البيانات
الرقم[]
-
id
الرقم
Notification
أماكن إقامة
-
shouldIndicate
منطقية اختيارية
علامة اختيارية لإرسال إشارة بدلاً من إشعار
-
القيمة
ArrayBuffer
القيمة الجديدة للسمة.
NotificationProperties
أماكن إقامة
-
ثابت
boolean
علامة تشير إلى ما إذا كان يجب أن يتلقّى التطبيق إشعارات عند إلغاء تحميل صفحة الحدث للتطبيق (راجِع إدارة مراحل نشاط التطبيق). القيمة التلقائية هي
false
.
Request
أماكن إقامة
-
جهاز
الجهاز الذي أرسل هذا الطلب
-
requestId
الرقم
معرّف فريد لهذا الطلب يمكنك استخدام هذا المعرّف عند الاستجابة لهذا الطلب.
-
القيمة
ArrayBuffer اختيارية
القيمة المكتوبة (إذا كان هذا طلب كتابة)
Response
أماكن إقامة
-
isError
boolean
إذا كانت هذه استجابة خطأ، يجب أن يكون ذلك صحيحًا.
-
requestId
الرقم
معرّف الطلب الذي تم الردّ عليه.
-
القيمة
ArrayBuffer اختيارية
قيمة الردّ ستتجاهل طلبات الكتابة والردود عن الأخطاء هذه المَعلمة.
Service
أماكن إقامة
-
deviceAddress
سلسلة اختيارية
عنوان الجهاز للجهاز الملحق البعيد الذي تنتمي إليه خدمة GATT. الحالي، إذا كان هذا المثيل يمثل خدمة عن بُعد.
-
instanceId
سلسلة اختيارية
تعرض المعرّف الذي تم تعيينه لهذه الخدمة. استخدِم رقم تعريف المثيل للتمييز بين الخدمات من جهاز ملحق يحمل المعرّف الفريد العالمي نفسه (UUID)، ولإجراء استدعاءات دالة تستقبل معرِّف خدمة. الحالي، إذا كان هذا المثيل يمثل خدمة عن بُعد.
-
isPrimary
boolean
يشير هذا العمود إلى ما إذا كان نوع هذه الخدمة أساسيًا أو ثانويًا.
-
uuid
سلسلة
المعرِّف الفريد العالمي للخدمة، مثل 0000180d-0000-1000-8000-00805f9b34fb.
ServiceData
أماكن إقامة
-
البيانات
الرقم[]
-
uuid
سلسلة
الطُرق
connect()
chrome.bluetoothLowEnergy.connect(
deviceAddress: string,
properties?: ConnectProperties,
callback?: function,
)
ينشئ اتصالاً بين التطبيق والجهاز بالعنوان المحدّد. قد يكون هناك جهاز متصل وتوفُّر خدمات GATT بدون الاتصال بـ connect
، ومع ذلك، على التطبيق الذي يريد الوصول إلى خدمات GATT على أحد الأجهزة استدعاء هذه الوظيفة للتأكّد من الحفاظ على الاتصال بالجهاز. في حال لم يكن الجهاز متصلاً، سيتم اكتشاف جميع خدمات GATT على الجهاز بعد إجراء مكالمة ناجحة إلى connect
.
المَعلمات
-
deviceAddress
سلسلة
عنوان البلوتوث للجهاز البعيد الذي يجب فتح اتصال GATT عليه
-
المواقع
ConnectProperties اختياري
خصائص الربط (اختياري)
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
createCharacteristic()
chrome.bluetoothLowEnergy.createCharacteristic(
characteristic: Characteristic,
serviceId: string,
callback?: function,
)
إنشاء سمة GATT مستضافة محليًا يجب استضافة هذه السمة ضمن خدمة صالحة. إذا كان معرّف الخدمة غير صالح، سيتم ضبط lastError. لا تتوفّر هذه الوظيفة إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"بلوتوث:الجهاز الملحق" للتطبيق على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
خاصية
خاصية الإنشاء.
-
serviceId
سلسلة
معرّف الخدمة لإنشاء هذه السمة من أجلها.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(characteristicId: string) => void
-
characteristicId
سلسلة
-
المرتجعات
-
وعد<string>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
createDescriptor()
chrome.bluetoothLowEnergy.createDescriptor(
descriptor: Descriptor,
characteristicId: string,
callback?: function,
)
إنشاء واصف GATT تتم استضافته محليًا. يجب استضافة هذا الوصف ضمن سمة صالحة. إذا كان رقم تعريف السمة غير صالح، سيتم ضبط lastError. لا تتوفّر هذه الوظيفة إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"بلوتوث:الجهاز الملحق" للتطبيق على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
واصف
الوصف المطلوب إنشاؤه
-
characteristicId
سلسلة
رقم تعريف السمة لإنشاء هذا الوصف لها.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(descriptorId: string) => void
-
descriptorId
سلسلة
-
المرتجعات
-
وعد<string>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
createService()
chrome.bluetoothLowEnergy.createService(
service: Service,
callback?: function,
)
إنشاء خدمة GATT مستضافة محليًا. يمكن تسجيل هذه الخدمة لتكون متاحة على خادم GATT محلي. لا تتوفّر هذه الوظيفة إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"بلوتوث:الجهاز الملحق" للتطبيق على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
الخدمة
الخدمة التي يتم إنشاؤها.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(serviceId: string) => void
-
serviceId
سلسلة
-
المرتجعات
-
وعد<string>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
disconnect()
chrome.bluetoothLowEnergy.disconnect(
deviceAddress: string,
callback?: function,
)
لإغلاق اتصال التطبيق بالجهاز باستخدام العنوان المحدّد. يُرجى العِلم أنّ هذا الإجراء لن يؤدي دائمًا إلى إتلاف الرابط الفعلي نفسه، لأنّه قد تكون هناك تطبيقات أخرى مزوّدة باتصالات مفتوحة.
المَعلمات
-
deviceAddress
سلسلة
عنوان البلوتوث للجهاز البعيد.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getCharacteristic()
chrome.bluetoothLowEnergy.getCharacteristic(
characteristicId: string,
callback?: function,
)
احصل على خاصية GATT برقم تعريف المثيل المحدد الذي ينتمي إلى خدمة GATT المحددة، إذا كانت السمة موجودة.
المَعلمات
-
characteristicId
سلسلة
رقم تعريف المثيل لخاصية GATT المطلوبة.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: Characteristic) => void
-
نتيجة
-
المرتجعات
-
Promise<Characteristic>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getCharacteristics()
chrome.bluetoothLowEnergy.getCharacteristics(
serviceId: string,
callback?: function,
)
احصل على قائمة بجميع خصائص GATT التي تم اكتشافها التي تنتمي إلى الخدمة المحددة.
المَعلمات
-
serviceId
سلسلة
معرِّف المثيل لخدمة GATT التي يجب عرض خصائصها.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: Characteristic[]) => void
-
نتيجة
السمة[]
-
المرتجعات
-
Promise<Characteristic[]>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getDescriptor()
chrome.bluetoothLowEnergy.getDescriptor(
descriptorId: string,
callback?: function,
)
احصل على واصف خاصية GATT مع رقم تعريف المثيل المعني.
المَعلمات
-
descriptorId
سلسلة
رقم تعريف المثيل لوصف سمة GATT المطلوب
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: Descriptor) => void
-
نتيجة
-
المرتجعات
-
Promise<Descriptor>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getDescriptors()
chrome.bluetoothLowEnergy.getDescriptors(
characteristicId: string,
callback?: function,
)
احصل على قائمة بواصفات سمات GATT التي تنتمي إلى السمة المحدّدة.
المَعلمات
-
characteristicId
سلسلة
رقم تعريف المثيل الخاص بسمة GATT التي يجب عرض واصفها.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: Descriptor[]) => void
-
نتيجة
-
المرتجعات
-
Promise<Descriptor[]>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getIncludedServices()
chrome.bluetoothLowEnergy.getIncludedServices(
serviceId: string,
callback?: function,
)
احصل على قائمة بخدمات GATT المضمّنة في الخدمة المقدمة.
المَعلمات
المرتجعات
-
تقديم وعود<الخدمة[]>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getService()
chrome.bluetoothLowEnergy.getService(
serviceId: string,
callback?: function,
)
احصل على خدمة GATT برقم تعريف المثيل المحدَّد.
المَعلمات
-
serviceId
سلسلة
رقم تعريف المثيل لخدمة GATT المطلوبة.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: Service) => void
-
نتيجة
-
المرتجعات
-
تقديم وعود<الخدمة>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getServices()
chrome.bluetoothLowEnergy.getServices(
deviceAddress: string,
callback?: function,
)
احصُل على جميع خدمات GATT التي تم اكتشافها على الجهاز البعيد باستخدام عنوان الجهاز المحدّد.
ملاحظة: إذا لم تكتمل عملية اكتشاف الخدمة على الجهاز بعد، ستعرض واجهة برمجة التطبيقات هذه مجموعة فرعية (من المحتمل أن تكون فارغة) من الخدمات. يتمثل الحل في إضافة تأخير مستند إلى الوقت و/أو الاتصال بشكل متكرر حتى يظهر العدد المتوقع من الخدمات.
المَعلمات
المرتجعات
-
تقديم وعود<الخدمة[]>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
notifyCharacteristicValueChanged()
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
characteristicId: string,
notification: Notification,
callback?: function,
)
يمكنك إشعار جهاز بعيد بقيمة جديدة لإحدى الميزات. إذا كانت علامة shouldschema في كائن الإشعار "صحيحة"، سيتم إرسال إشارة بدلاً من إشعار. ملاحظة: يجب أن تضبط الخاصية خاصية "notify" أو "الإشارة" بشكل صحيح أثناء عملية الإنشاء لنجاح هذا الاستدعاء. لا تتوفّر هذه الوظيفة إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"بلوتوث:الجهاز الملحق" للتطبيق على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
characteristicId
سلسلة
السمة المطلوب إرسال الإشعار بشأنها.
-
إشعار
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
readCharacteristicValue()
chrome.bluetoothLowEnergy.readCharacteristicValue(
characteristicId: string,
callback?: function,
)
استرداد قيمة سمة محدّدة من جهاز ملحق بعيد
المَعلمات
-
characteristicId
سلسلة
رقم تعريف المثيل الخاص بسمة GATT التي يجب قراءة قيمتها من الجهاز البعيد.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: Characteristic) => void
-
نتيجة
-
المرتجعات
-
Promise<Characteristic>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
readDescriptorValue()
chrome.bluetoothLowEnergy.readDescriptorValue(
descriptorId: string,
callback?: function,
)
يمكنك استرداد قيمة أداة وصف مميّزة محدَّدة من جهاز ملحق بعيد.
المَعلمات
-
descriptorId
سلسلة
رقم تعريف المثيل لوصف سمة GATT التي يجب قراءة قيمتها من الجهاز البعيد.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: Descriptor) => void
-
نتيجة
-
المرتجعات
-
Promise<Descriptor>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
registerAdvertisement()
chrome.bluetoothLowEnergy.registerAdvertisement(
advertisement: Advertisement,
callback?: function,
)
إنشاء إعلان وتسجيله للإعلان. لاستدعاء هذه الوظيفة، يجب ضبط إذنَي Bluetooth:low_energy و Bluetooth:peripheral على "صحيح"، بالإضافة إلى ذلك، لا تتوفر واجهة برمجة التطبيقات هذه إلا للتطبيقات التي يتم تشغيلها تلقائيًا في وضع Kiosk أو من خلال ضبط مفتاح سطر الأوامر " --enable-ble-advertising-in-apps". يمكنك الاطّلاع على https://developer.chrome.com/apps/manifest/Bluetooth ملاحظة: تتوفّر في بعض الأجهزة، والأوضاع المركزية والملحقة في الوقت نفسه، ولكن على الأجهزة التي لا توفّر ذلك، سيؤدي هذا الاتصال إلى تبديل الجهاز إلى وضع الأجهزة الملحقة. في حالة الأجهزة التي لا تتوافق مع الوضع المركزي والملحق، ستؤدي محاولة استخدام الجهاز في كلا الوضعين إلى سلوك غير محدّد أو إلى منع تطبيقات الدور المركزي الأخرى من التصرف بشكل صحيح (بما في ذلك اكتشاف أجهزة بلوتوث منخفضة الطاقة).
المَعلمات
-
إعلان
الإعلان المراد الإعلان عنه.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(advertisementId: number) => void
-
advertisementId
الرقم
-
المرتجعات
-
وعد<الرقم>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
registerService()
chrome.bluetoothLowEnergy.registerService(
serviceId: string,
callback?: function,
)
سجّل الخدمة المحددة في خادم GATT المحلي. إذا كان معرّف الخدمة غير صالح، سيتم ضبط lastError. لا تتوفّر هذه الوظيفة إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"بلوتوث:الجهاز الملحق" للتطبيق على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
serviceId
سلسلة
المعرّف الفريد لخدمة تم إنشاؤها.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
removeService()
chrome.bluetoothLowEnergy.removeService(
serviceId: string,
callback?: function,
)
إزالة الخدمة المحددة، وإلغاء تسجيلها إذا تم تسجيلها. إذا كان معرّف الخدمة غير صالح، سيتم ضبط lastError. لا تتوفّر هذه الوظيفة إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"بلوتوث:الجهاز الملحق" للتطبيق على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
serviceId
سلسلة
المعرّف الفريد لخدمة مسجّلة حالية.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
resetAdvertising()
chrome.bluetoothLowEnergy.resetAdvertising(
callback?: function,
)
إعادة ضبط الإعلانات على الجهاز الحالي. سيؤدي هذا الإجراء إلى إلغاء تسجيل جميع الإعلانات الحالية وإيقافها.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
sendRequestResponse()
chrome.bluetoothLowEnergy.sendRequestResponse(
response: Response,
)
يرسل استجابة لطلب قراءة/كتابة سمة أو واصف. لا تتوفّر هذه الوظيفة إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"بلوتوث:الجهاز الملحق" للتطبيق على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
رد
الردّ على الطلب.
setAdvertisingInterval()
chrome.bluetoothLowEnergy.setAdvertisingInterval(
minInterval: number,
maxInterval: number,
callback?: function,
)
هو الفاصل الزمني بين إعلانين متتاليين. ملاحظة: هذه هي أفضل جهد. قد يختلف الفاصل الزمني الفعلي بشكل غير محدود عن الفواصل الزمنية المطلوبة. على بعض الأجهزة، يبلغ الحد الأدنى للفاصل الزمني 100 ملي ثانية. لا يمكن أن تتجاوز القيم الدنيا والقصوى النطاق المسموح به في مواصفات Bluetooth 4.2.
المَعلمات
-
minInterval
الرقم
الحد الأدنى للفاصل الزمني بين الإعلانات (بالمللي ثانية) لا يمكن أن تكون هذه المدة أقل من 20 ملي ثانية (وفقًا للمواصفات).
-
maxInterval
الرقم
الحد الأقصى للفاصل الزمني بين الإعلانات (بالمللي ثانية) لا يمكن أن يتجاوز ذلك 10240 ملي ثانية (وفقًا للمواصفات).
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
startCharacteristicNotifications()
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
characteristicId: string,
properties?: NotificationProperties,
callback?: function,
)
يمكن تفعيل إشعارات/مؤشرات القيمة من السمة المحدّدة. بعد تفعيل هذا الإعداد، يمكن للتطبيق الاستماع إلى الإشعارات باستخدام حدث onCharacteristicValueChanged
.
المَعلمات
-
characteristicId
سلسلة
رقم تعريف المثيل لميزة GATT التي يجب تفعيل الإشعارات عليها.
-
المواقع
NotificationProperties اختيارية
خصائص جلسة الإشعار (اختيارية)
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
stopCharacteristicNotifications()
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
characteristicId: string,
callback?: function,
)
إيقاف الإشعارات/المؤشرات بشأن القيمة من السمة المحدّدة بعد إجراء المكالمة بنجاح، سيتوقف التطبيق عن تلقّي إشعارات أو مؤشرات من هذه السمة.
المَعلمات
-
characteristicId
سلسلة
رقم تعريف المثيل لميزة GATT التي يجب إيقاف جلسة إشعارات هذا التطبيق عليها.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
unregisterAdvertisement()
chrome.bluetoothLowEnergy.unregisterAdvertisement(
advertisementId: number,
callback?: function,
)
يؤدي هذا الإجراء إلى إلغاء تسجيل إعلان وإيقافه. إذا تعذّر إلغاء تسجيل الإعلان، قد تكون الطريقة الوحيدة لإيقاف الإعلان هي إعادة تشغيل الجهاز.
المَعلمات
-
advertisementId
الرقم
معرِّف الإعلان المطلوب إلغاء تسجيله.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
unregisterService()
chrome.bluetoothLowEnergy.unregisterService(
serviceId: string,
callback?: function,
)
إلغاء تسجيل الخدمة المقدمة على خادم GATT المحلي. إذا كان معرّف الخدمة غير صالح، سيتم ضبط lastError. لا تتوفّر هذه الوظيفة إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"بلوتوث:الجهاز الملحق" للتطبيق على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
serviceId
سلسلة
المعرّف الفريد لخدمة مسجّلة حالية.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
writeCharacteristicValue()
chrome.bluetoothLowEnergy.writeCharacteristicValue(
characteristicId: string,
value: ArrayBuffer,
callback?: function,
)
كتابة قيمة سمة محدّدة من جهاز ملحق بعيد
المَعلمات
-
characteristicId
سلسلة
رقم تعريف المثيل الخاص بسمة GATT التي يجب كتابة القيمة عليها.
-
القيمة
ArrayBuffer
القيمة التي يجب إرسالها إلى السمة البعيدة كجزء من طلب الكتابة.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
writeDescriptorValue()
chrome.bluetoothLowEnergy.writeDescriptorValue(
descriptorId: string,
value: ArrayBuffer,
callback?: function,
)
كتابة قيمة أداة وصف مميّزة محدَّدة من جهاز ملحق بعيد
المَعلمات
-
descriptorId
سلسلة
رقم تعريف المثيل واصف خاصية GATT الذي يجب كتابة القيمة إليه.
-
القيمة
ArrayBuffer
القيمة التي يجب إرسالها إلى أداة الوصف عن بُعد كجزء من طلب الكتابة.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
فعاليات
onCharacteristicReadRequest
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
callback: function,
)
يتم تنشيطها عندما يطلب جهاز مركزي متصل قراءة قيمة سمة مسجَّلة على خادم GATT المحلي. قد يؤدي عدم الاستجابة لهذا الطلب لفترة طويلة إلى قطع الاتصال بالإنترنت. لا يتوفّر هذا الحدث إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"Bluetooth:الأجهزة الطرفية" على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(request: Request, characteristicId: string) => void
-
طلب
-
characteristicId
سلسلة
-
onCharacteristicValueChanged
chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
callback: function,
)
يتم تنشيطها عندما تتغير قيمة سمة GATT عن بُعد، إما كنتيجة لطلب قراءة أو إشعار أو إشارة بتغيير القيمة. لن يتم إرسال هذا الحدث إلا إذا فعّل التطبيق الإشعارات من خلال طلب startCharacteristicNotifications
.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(characteristic: Characteristic) => void
-
خاصية
-
onCharacteristicWriteRequest
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
callback: function,
)
يتم تنشيطها عندما يطلب جهاز مركزي متصل كتابة قيمة سمة مسجَّلة على خادم GATT المحلي. قد يؤدي عدم الاستجابة لهذا الطلب لفترة طويلة إلى قطع الاتصال بالإنترنت. لا يتوفّر هذا الحدث إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"Bluetooth:الأجهزة الطرفية" على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(request: Request, characteristicId: string) => void
-
طلب
-
characteristicId
سلسلة
-
onDescriptorReadRequest
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
callback: function,
)
يتم تنشيطها عندما يطلب جهاز مركزي متصل قراءة قيمة أداة الوصف المسجَّلة على خادم GATT المحلي. قد يؤدي عدم الاستجابة لهذا الطلب لفترة طويلة إلى قطع الاتصال بالإنترنت. لا يتوفّر هذا الحدث إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"Bluetooth:الأجهزة الطرفية" على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(request: Request, descriptorId: string) => void
-
طلب
-
descriptorId
سلسلة
-
onDescriptorValueChanged
chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
callback: function,
)
يتم تنشيطها عندما تتغير قيمة واصف GATT عن بُعد، ويكون ذلك عادةً نتيجة لطلب قراءة. يهدف هذا الحدث في الغالب إلى تسهيل الاستخدام، وسيتم إرساله دائمًا بعد إجراء مكالمة ناجحة مع الرقم readDescriptorValue
.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(descriptor: Descriptor) => void
-
واصف
-
onDescriptorWriteRequest
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
callback: function,
)
يتم تنشيطها عندما يطلب جهاز مركزي متصل كتابة قيمة واصف مسجَّل على خادم GATT المحلي. قد يؤدي عدم الاستجابة لهذا الطلب لفترة طويلة إلى قطع الاتصال بالإنترنت. لا يتوفّر هذا الحدث إلا إذا تم ضبط إذنَي Bluetooth:low_energy على "البلوتوث" و"Bluetooth:الأجهزة الطرفية" على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(request: Request, descriptorId: string) => void
-
طلب
-
descriptorId
سلسلة
-
onServiceAdded
chrome.bluetoothLowEnergy.onServiceAdded.addListener(
callback: function,
)
يتم الإطلاق عند اكتشاف خدمة GATT جديدة على جهاز بعيد.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(service: Service) => void
-
الخدمة
-
onServiceChanged
chrome.bluetoothLowEnergy.onServiceChanged.addListener(
callback: function,
)
يتم تنشيطها عندما تتغير حالة خدمة GATT عن بُعد. ويتضمّن ذلك أي خصائص و/أو أوصاف تتم إضافتها أو إزالتها من الخدمة، بالإضافة إلى إشعارات "ServiceChanged" من الجهاز البعيد.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(service: Service) => void
-
الخدمة
-
onServiceRemoved
chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
callback: function,
)
يتم تنشيطها عند إزالة إحدى خدمات GATT التي تم اكتشافها سابقًا على جهاز بعيد.