chrome.bluetoothLowEnergy

الوصف

يتم استخدام واجهة برمجة التطبيقات chrome.bluetoothLowEnergy للتواصل مع أجهزة Bluetooth Smart (المنخفضة الطاقة) باستخدام ملف تعريف السمات العامة (GATT).

مدى التوفّر

نظام التشغيل ChromeOS فقط

البيان

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

"bluetooth"

الأنواع

Advertisement

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

الخصائص

  • manufacturerData

    ManufacturerData[] اختيارية

    قائمة بالبيانات الخاصة بالشركة المصنّعة والتي يجب تضمينها في حقول "البيانات الخاصة بالشركة المصنّعة" ضمن بيانات الإعلان

  • serviceData

    ServiceData[] اختياري

    قائمة ببيانات الخدمة التي سيتم تضمينها في حقول "بيانات الخدمة" ضمن البيانات الإعلانية

  • serviceUuids

    string[] اختياري

    قائمة بالمعرّفات الفريدة العامة (UUID) التي سيتم تضمينها في حقل "المعرّفات الفريدة العامة للخدمة" ضمن بيانات الإعلان يمكن أن تكون هذه المعرّفات الفريدة العامة بتنسيقات 16 أو 32 أو 128 بت.

  • solicitUuids

    string[] اختياري

    قائمة بمعرّفات UUID المطلوب تضمينها في حقل "طلب معرّفات UUID" ضمن "البيانات الإعلانية" يمكن أن تكون هذه المعرّفات الفريدة العامة بتنسيقات 16 أو 32 أو 128 بت.

  • النوع

    AdvertisementType

    نوع الإعلان

AdvertisementType

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

نوع الإعلان في حال اختيار "البث"، سيكون نوع الإعلان المُرسَل هو ADV_NONCONN_IND وسيبث الجهاز باستخدام عنوان MAC عشوائي. في حال ضبطها على "peripheral"، سيكون نوع الإعلان ADV_IND أو ADV_SCAN_IND وسيبث الجهاز باستخدام عنوان MAC الحقيقي لمحوّل البلوتوث.

تعداد

"broadcast"

"peripheral"

Characteristic

الخصائص

  • instanceId

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

    تعرِض هذه السمة المعرّف المخصّص لهذه السمة. استخدِم معرّف المثيل للتمييز بين الخصائص من جهاز طرفي له معرِّف فريد عالمي (UUID) نفسه ولإجراء استدعاءات الدالة التي تتضمّن معرّف خاصية. يجب تقديم هذه السمة إذا كان هذا العنصر يمثّل سمة عن بُعد.

  • أماكن الإقامة

    CharacteristicProperty[]

    خصائص هذه السمة

  • الخدمة

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

    خدمة GATT التي تنتمي إليها هذه السمة

  • uuid

    سلسلة

    المعرّف الفريد العالمي (UUID) للسمة، مثلاً 00002a37-0000-1000-8000-00805f9b34fb.

  • القيمة

    ‫ArrayBuffer اختياري

    قيمة السمة المخزّنة مؤقتًا حاليًا. يتم تعديل هذه القيمة عند قراءة قيمة السمة أو تعديلها من خلال إشعار أو مؤشر.

CharacteristicProperty

قيم تمثّل الخصائص المحتملة لإحدى السمات يتم استنتاج أذونات الخصائص من هذه السمات. يُرجى الاطّلاع على مواصفات Bluetooth 4.x لمعرفة معنى كل خاصية على حدة.

تعداد

"broadcast"

"read"

"writeWithoutResponse"

"كتابة"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

الخصائص

  • مستمرة

    قيمة منطقية

    علامة تشير إلى ما إذا كان سيتم إبقاء الاتصال بالجهاز مفتوحًا عند إلغاء تحميل صفحة حدث التطبيق (راجِع إدارة مراحل نشاط التطبيق). القيمة التلقائية هي false.

Descriptor

الخصائص

  • السمة

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

    سمة GATT التي ينتمي إليها هذا الواصف

  • instanceId

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

    تعرِض هذه السمة المعرّف المخصّص لهذا الواصف. استخدِم معرّف المثيل للتمييز بين واصفات من جهاز طرفي له المعرّف الفريد العالمي (UUID) نفسه ولإجراء استدعاءات الدوال التي تتضمّن معرّف واصف. يجب تقديم هذه السمة إذا كان هذا العنصر يمثّل سمة عن بُعد.

  • أذونات

    DescriptorPermission[]

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

    أذونات هذا الواصف.

  • uuid

    سلسلة

    رقم التعريف الفريد العالمي (UUID) لوصف السمة، مثل 00002902-0000-1000-8000-00805f9b34fb.

  • القيمة

    ‫ArrayBuffer اختياري

    قيمة الواصف المخزّنة مؤقتًا حاليًا. يتم تعديل هذه القيمة عند قراءة قيمة الواصف.

DescriptorPermission

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

قيم تمثّل الأذونات المحتملة لأحد الواصفات. يُرجى الاطّلاع على مواصفات Bluetooth 4.x لمعرفة معنى كل إذن على حدة.

تعداد

"read"

"كتابة"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

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

الخصائص

  • معالجة

    سلسلة

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

  • deviceClass

    number اختيارية

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

  • الاسم

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

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

ManufacturerData

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

الخصائص

  • البيانات

    number[]

  • id

    الرقم

Notification

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

الخصائص

  • shouldIndicate

    boolean اختياري

    علامة اختيارية لإرسال إشارة بدلاً من إشعار

  • القيمة

    ArrayBuffer

    القيمة الجديدة للخاصية

NotificationProperties

الخصائص

  • مستمرة

    قيمة منطقية

    علامة تشير إلى ما إذا كان التطبيق سيتلقّى إشعارات عند إلغاء تحميل صفحة الحدث الخاصة بالتطبيق (راجِع إدارة مراحل نشاط التطبيق). القيمة التلقائية هي false.

Request

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

الخصائص

  • جهاز

    الجهاز

    الجهاز الذي أرسل هذا الطلب

  • requestId

    الرقم

    معرّف فريد لهذا الطلب. استخدِم هذا المعرّف عند الردّ على هذا الطلب.

  • القيمة

    ‫ArrayBuffer اختياري

    القيمة المطلوب كتابتها (إذا كان هذا طلب كتابة)

Response

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

الخصائص

  • isError

    قيمة منطقية

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

  • requestId

    الرقم

    معرّف الطلب الذي يمثّل هذا الردّ.

  • القيمة

    ‫ArrayBuffer اختياري

    قيمة الاستجابة سيتم تجاهل هذه المَعلمة في طلبات الكتابة وردود الخطأ.

Service

الخصائص

  • deviceAddress

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

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

  • instanceId

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

    تعرِض هذه السمة المعرّف المخصّص لهذه الخدمة. استخدِم معرّف المثيل للتمييز بين الخدمات من جهاز طرفي له رقم تعريف فريد عالمي (UUID) نفسه ولإجراء طلبات وظائف تتضمّن معرّف خدمة. يجب تقديم هذا الحقل إذا كان هذا العنصر يمثّل خدمة عن بُعد.

  • isPrimary

    قيمة منطقية

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

  • uuid

    سلسلة

    تمثّل هذه السمة المعرّف الفريد العالمي (UUID) للخدمة، مثل 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

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

الخصائص

  • البيانات

    number[]

  • uuid

    سلسلة

الطُرق

connect()

وعد 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
): Promise<void>

تُنشئ هذه السمة اتصالاً بين التطبيق والجهاز الذي يحمل العنوان المحدّد. قد يكون الجهاز متصلاً بالفعل وتكون خدمات GATT متاحة بدون استدعاء connect، ومع ذلك، يجب أن يستدعي التطبيق الذي يريد الوصول إلى خدمات GATT الخاصة بالجهاز هذه الدالة للتأكّد من الحفاظ على الاتصال بالجهاز. في حال عدم اتصال الجهاز، سيتم اكتشاف جميع خدمات GATT الخاصة بالجهاز بعد إجراء مكالمة ناجحة إلى connect.

المعلمات

  • deviceAddress

    سلسلة

    عنوان البلوتوث للجهاز البعيد الذي يجب فتح اتصال GATT معه.

  • أماكن الإقامة

    ‫ConnectProperties اختيارية

    سمات الاتصال (اختيارية)

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

createCharacteristic()

Promise Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

إنشاء سمة GATT مستضافة محليًا يجب استضافة هذه السمة ضمن خدمة صالحة. إذا كان معرّف الخدمة غير صالح، سيتم ضبط lastError. لا تتوفّر هذه الدالة إلا إذا تم ضبط كل من الإذنَين bluetooth:low_energy وbluetooth:peripheral على "صحيح". قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • السمة

    السمة

    السمة المطلوب إنشاؤها.

  • serviceId

    سلسلة

    معرّف الخدمة التي سيتم إنشاء هذه السمة لها.

  • callback

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

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

    (characteristicId: string) => void

    • characteristicId

      سلسلة

المرتجعات

  • Promise<string>

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

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

createDescriptor()

Promise Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

أنشئ واصف GATT مستضافًا محليًا. يجب استضافة هذا الواصف ضمن سمة صالحة. إذا كان معرّف السمة غير صالح، سيتم ضبط lastError. لا تتوفّر هذه الدالة إلا إذا تم ضبط كل من الإذنَين bluetooth:low_energy وbluetooth:peripheral على "صحيح". قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • واصف

    الواصف

    الواصف المطلوب إنشاؤه

  • characteristicId

    سلسلة

    رقم تعريف السمة التي سيتم إنشاء واصف لها

  • callback

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

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

    (descriptorId: string) => void

    • descriptorId

      سلسلة

المرتجعات

  • Promise<string>

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

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

createService()

Promise Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

إنشاء خدمة GATT مستضافة محليًا يمكن تسجيل هذه الخدمة لتكون متاحة على خادم GATT محلي. لا تتوفّر هذه الدالة إلا إذا تم ضبط كل من الإذنَين bluetooth:low_energy وbluetooth:peripheral على "صحيح". قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • الخدمة

    الخدمة

    الخدمة المطلوب إنشاؤها

  • callback

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

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

    (serviceId: string) => void

    • serviceId

      سلسلة

المرتجعات

  • Promise<string>

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

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

disconnect()

وعد 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
): Promise<void>

يُغلِق هذا الإجراء اتصال التطبيق بالجهاز الذي يحمل العنوان المحدّد. يُرجى العِلم أنّ هذا الإجراء لن يؤدي دائمًا إلى إيقاف الرابط الفعلي نفسه، لأنّه قد تكون هناك تطبيقات أخرى تتضمّن اتصالات مفتوحة.

المعلمات

  • deviceAddress

    سلسلة

    عنوان البلوتوث للجهاز البعيد

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

getCharacteristic()

وعد 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

احصل على سمة GATT مع رقم تعريف المثيل المحدّد الذي ينتمي إلى خدمة GATT المحدّدة، إذا كانت السمة متوفّرة.

المعلمات

  • characteristicId

    سلسلة

    معرّف مثيل سمة GATT المطلوبة

  • callback

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

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

    (result: Characteristic) => void

المرتجعات

  • Promise<Characteristic>

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

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

getCharacteristics()

وعد 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
): Promise<Characteristic[]>

الحصول على قائمة بجميع سمات GATT التي تم اكتشافها والتي تنتمي إلى الخدمة المحدّدة

المعلمات

  • serviceId

    سلسلة

    معرّف مثيل خدمة GATT التي يجب عرض خصائصها.

  • callback

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

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

    (result: Characteristic[]) => void

المرتجعات

  • Promise<Characteristic[]>

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

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

getDescriptor()

وعد 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

احصل على واصف سمة GATT باستخدام رقم تعريف المثيل المحدّد.

المعلمات

  • descriptorId

    سلسلة

    معرّف مثيل واصف سمة GATT المطلوب.

  • callback

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

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

    (result: Descriptor) => void

المرتجعات

  • Promise<Descriptor>

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

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

getDescriptors()

وعد 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
): Promise<Descriptor[]>

الحصول على قائمة بأوصاف سمات GATT التي تنتمي إلى السمة المحدّدة

المعلمات

  • characteristicId

    سلسلة

    رقم تعريف مثيل سمة GATT التي يجب إرجاع واصفاتها.

  • callback

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

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

    (result: Descriptor[]) => void

المرتجعات

  • Promise<Descriptor[]>

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

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

getIncludedServices()

وعد 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
): Promise<Service[]>

الحصول على قائمة بخدمات GATT التي تتضمّنها الخدمة المحدّدة

المعلمات

  • serviceId

    سلسلة

    معرّف مثيل خدمة GATT التي يجب إرجاع الخدمات المضمّنة فيها.

  • callback

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

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

    (result: Service[]) => void

المرتجعات

  • Promise<Service[]>

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

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

getService()

وعد 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
): Promise<Service>

احصل على خدمة GATT باستخدام معرّف المثيل المحدّد.

المعلمات

  • serviceId

    سلسلة

    معرّف مثيل خدمة GATT المطلوبة.

  • callback

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

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

    (result: Service) => void

المرتجعات

  • Promise<Service>

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

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

getServices()

وعد 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
): Promise<Service[]>

الحصول على جميع خدمات GATT التي تم رصدها على الجهاز البعيد باستخدام عنوان الجهاز المحدّد

ملاحظة: إذا لم يكتمل بعد اكتشاف الخدمات على الجهاز، ستعرض واجهة برمجة التطبيقات هذه مجموعة فرعية (قد تكون فارغة) من الخدمات. يمكنك حلّ هذه المشكلة عن طريق إضافة تأخير مستند إلى الوقت و/أو تكرار الطلب إلى أن يتم عرض العدد المتوقّع من الخدمات.

المعلمات

  • deviceAddress

    سلسلة

    عنوان البلوتوث للجهاز البعيد الذي يجب عرض خدمات GATT الخاصة به.

  • callback

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

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

    (result: Service[]) => void

المرتجعات

  • Promise<Service[]>

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

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

notifyCharacteristicValueChanged()

Promise Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

إشعار جهاز بعيد بقيمة جديدة لخاصية إذا كانت العلامة shouldIndicate في عنصر الإشعار صحيحة، سيتم إرسال إشارة بدلاً من إشعار. ملاحظة: يجب أن تضبط السمة "notify" أو "indicate" بشكل صحيح أثناء الإنشاء لكي تنجح عملية الاستدعاء هذه. لا تتوفّر هذه الدالة إلا إذا تم ضبط كل من الإذنَين bluetooth:low_energy وbluetooth:peripheral على "صحيح". قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • characteristicId

    سلسلة

    السمة التي سيتم إرسال الإشعار بشأنها.

  • إشعار

    الإشعار

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

readCharacteristicValue()

وعد 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

استرداد قيمة سمة محدّدة من جهاز طرفي بعيد

المعلمات

  • characteristicId

    سلسلة

    رقم تعريف مثيل سمة GATT التي يجب قراءة قيمتها من الجهاز البعيد.

  • callback

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

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

    (result: Characteristic) => void

المرتجعات

  • Promise<Characteristic>

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

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

readDescriptorValue()

وعد 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

استرداد قيمة واصف سمة محدّدة من جهاز طرفي بعيد

المعلمات

  • descriptorId

    سلسلة

    رقم تعريف مثيل واصف سمة GATT الذي يجب قراءة قيمته من الجهاز البعيد.

  • callback

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

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

    (result: Descriptor) => void

المرتجعات

  • Promise<Descriptor>

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

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

registerAdvertisement()

Promise Chrome 47 أو إصدار أحدث 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

أنشِئ إعلانًا وسجِّله لعرض الإعلانات. لاستدعاء هذه الدالة، يجب أن يكون التطبيق قد ضبط أذونات bluetooth:low_energy وbluetooth:peripheral على القيمة true. بالإضافة إلى ذلك، لا تتوفّر واجهة برمجة التطبيقات هذه إلا للتطبيقات التي يتم تشغيلها تلقائيًا في "وضع الكشك" أو من خلال ضبط خيار سطر الأوامر "--enable-ble-advertising-in-apps". راجِع https://developer.chrome.com/apps/manifest/bluetooth ملاحظة: على بعض الأجهزة، يمكن استخدام الوضعَين المركزي والطرفي في الوقت نفسه، ولكن على الأجهزة التي لا تتوافق مع ذلك، سيؤدي إجراء هذه المكالمة إلى تبديل الجهاز إلى الوضع الطرفي. في حال عدم توفّر الوضعَين المركزي والطرفي في الجهاز، ستؤدي محاولة استخدام الجهاز في كلا الوضعَين إلى سلوك غير محدّد أو ستمنع التطبيقات الأخرى التي تعمل في الوضع المركزي من العمل بشكل صحيح (بما في ذلك اكتشاف أجهزة بلوتوث منخفض الطاقة).

المعلمات

  • إعلان

    الإعلان

    الإعلان الذي سيتم عرضه

  • callback

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

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

    (advertisementId: number) => void

    • advertisementId

      الرقم

المرتجعات

  • Promise<number>

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

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

registerService()

Promise Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

تسجيل الخدمة المحدّدة لدى خادم GATT المحلّي إذا كان معرّف الخدمة غير صالح، سيتم ضبط lastError. لا تتوفّر هذه الدالة إلا إذا تم ضبط كل من الإذنَين bluetooth:low_energy وbluetooth:peripheral على "صحيح". قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • serviceId

    سلسلة

    المعرّف الفريد لخدمة تم إنشاؤها.

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

removeService()

Promise Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

إزالة الخدمة المحدّدة وإلغاء تسجيلها إذا كانت مسجّلة إذا كان معرّف الخدمة غير صالح، سيتم ضبط lastError. لا تتوفّر هذه الدالة إلا إذا تم ضبط كل من الإذنَين bluetooth:low_energy وbluetooth:peripheral على "صحيح". قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • serviceId

    سلسلة

    المعرّف الفريد لخدمة مسجَّلة حاليًا.

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

resetAdvertising()

Promise الإصدار 61 من Chrome والإصدارات الأحدث 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

تعمل هذه الطريقة على إعادة ضبط الإعلانات على الجهاز الحالي. سيؤدي ذلك إلى إلغاء التسجيل وإيقاف جميع الإعلانات الحالية.

المعلمات

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

sendRequestResponse()

Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
): void

يرسل ردًا على طلب قراءة/كتابة سمة أو وصف. لا تتوفّر هذه الدالة إلا إذا تم ضبط كل من الإذنَين bluetooth:low_energy وbluetooth:peripheral على "صحيح". قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

setAdvertisingInterval()

Promise Chrome 55 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

تضبط هذه السمة الفاصل الزمني بين إعلانَين متتاليَين. ملاحظة: هذا هو أفضل ما يمكن تقديمه. قد يختلف الفاصل الزمني الفعلي بشكل كبير عن الفواصل الزمنية المطلوبة. في بعض الأجهزة، يكون الحد الأدنى للفاصل الزمني 100 ملي ثانية. لا يمكن أن تتجاوز القيمتان الدنيا والقصوى النطاق المسموح به بموجب مواصفات Bluetooth 4.2.

المعلمات

  • minInterval

    الرقم

    الحدّ الأدنى للفاصل الزمني بين الإعلانات (بالمللي ثانية). لا يمكن أن تكون هذه القيمة أقل من 20 ملي ثانية (وفقًا للمواصفات).

  • maxInterval

    الرقم

    الحد الأقصى للفاصل الزمني بين الإعلانات (بالمللي ثانية) لا يمكن أن تزيد هذه القيمة عن 10240 ملي ثانية (وفقًا للمواصفات).

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

startCharacteristicNotifications()

وعد 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
): Promise<void>

تفعيل إشعارات/مؤشرات القيمة من السمة المحدّدة بعد تفعيل هذا الإذن، يمكن لأي تطبيق الاستماع إلى الإشعارات باستخدام حدث onCharacteristicValueChanged.

المعلمات

  • characteristicId

    سلسلة

    معرّف مثيل سمة GATT التي يجب تفعيل الإشعارات عليها.

  • أماكن الإقامة

    NotificationProperties اختياري

    سمات جلسة الإشعارات (اختيارية)

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

stopCharacteristicNotifications()

وعد 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
): Promise<void>

إيقاف إشعارات/مؤشرات القيمة من السمة المحدّدة بعد إجراء مكالمة ناجحة، سيتوقف التطبيق عن تلقّي الإشعارات أو المؤشرات من هذه السمة.

المعلمات

  • characteristicId

    سلسلة

    معرّف مثيل سمة GATT التي يجب إيقاف جلسة إشعارات هذا التطبيق عليها.

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

unregisterAdvertisement()

Promise Chrome 47 أو إصدار أحدث 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

لإلغاء تسجيل إعلان وإيقاف عرضه إذا تعذّر إلغاء تسجيل الإعلان، قد تكون إعادة تشغيل الجهاز هي الطريقة الوحيدة لإيقاف عرض الإعلانات.

المعلمات

  • advertisementId

    الرقم

    معرّف الإعلان المطلوب إلغاء تسجيله.

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

unregisterService()

Promise Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

إلغاء تسجيل الخدمة المحدّدة في خادم GATT المحلي إذا كان معرّف الخدمة غير صالح، سيتم ضبط lastError. لا تتوفّر هذه الدالة إلا إذا تم ضبط كل من الإذنَين bluetooth:low_energy وbluetooth:peripheral على "صحيح". قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • serviceId

    سلسلة

    المعرّف الفريد لخدمة مسجَّلة حاليًا.

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

writeCharacteristicValue()

وعد 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

كتابة قيمة سمة محدّدة من جهاز طرفي بعيد

المعلمات

  • characteristicId

    سلسلة

    المعرّف المثيل لسمة GATT التي يجب كتابة قيمتها.

  • القيمة

    ArrayBuffer

    القيمة التي يجب إرسالها إلى السمة البعيدة كجزء من طلب الكتابة

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

writeDescriptorValue()

وعد 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

كتابة قيمة واصف مميّز محدّد من جهاز طرفي بعيد

المعلمات

  • descriptorId

    سلسلة

    المعرّف المثيل لواصف سمة GATT الذي يجب كتابة قيمته.

  • القيمة

    ArrayBuffer

    القيمة التي يجب إرسالها إلى واصف البيانات البعيد كجزء من طلب الكتابة

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

الفعاليات

onCharacteristicReadRequest

Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

يتم تشغيل هذا الحدث عندما يطلب جهاز مركزي متصل قراءة قيمة سمة مسجّلة على خادم GATT المحلي. قد يؤدي عدم الردّ على هذا الطلب لفترة طويلة إلى قطع الاتصال. لا يتوفّر هذا الحدث إلا إذا تم ضبط إذنَي bluetooth:low_energy وbluetooth:peripheral على "صحيح" في التطبيق. قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • callback

    دالة

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

    (request: Request, characteristicId: string) => void

onCharacteristicValueChanged

chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما تتغيّر قيمة سمة GATT بعيدة، إما نتيجة لطلب قراءة أو إشعار/إشارة بتغيير القيمة. ولن يتم إرسال هذا الحدث إلا إذا كان التطبيق قد فعّل الإشعارات من خلال استدعاء startCharacteristicNotifications.

المعلمات

  • callback

    دالة

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

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

يتم تشغيل هذا الحدث عندما يطلب جهاز مركزي متصل كتابة قيمة سمة مسجّلة على خادم GATT المحلي. قد يؤدي عدم الردّ على هذا الطلب لفترة طويلة إلى قطع الاتصال. لا يتوفّر هذا الحدث إلا إذا تم ضبط إذنَي bluetooth:low_energy وbluetooth:peripheral على "صحيح" في التطبيق. قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • callback

    دالة

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

    (request: Request, characteristicId: string) => void

onDescriptorReadRequest

Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما يطلب جهاز مركزي متصل قراءة قيمة واصف مسجَّل على خادم GATT المحلي. قد يؤدي عدم الردّ على هذا الطلب لفترة طويلة إلى قطع الاتصال. لا يتوفّر هذا الحدث إلا إذا تم ضبط إذنَي bluetooth:low_energy وbluetooth:peripheral على "صحيح" في التطبيق. قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • callback

    دالة

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

    (request: Request, descriptorId: string) => void

onDescriptorValueChanged

chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما تتغيّر قيمة واصف سمة GATT البعيدة، وعادةً ما يكون ذلك نتيجة لطلب قراءة. يتم إرسال هذا الحدث في الغالب لتوفير الراحة، وسيتم إرساله دائمًا بعد إجراء مكالمة ناجحة إلى readDescriptorValue.

المعلمات

  • callback

    دالة

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما يطلب جهاز مركزي متصل كتابة قيمة واصف مسجَّل على خادم GATT المحلي. قد يؤدي عدم الردّ على هذا الطلب لفترة طويلة إلى قطع الاتصال. لا يتوفّر هذا الحدث إلا إذا تم ضبط إذنَي bluetooth:low_energy وbluetooth:peripheral على "صحيح" في التطبيق. قد لا يكون إذن الجهاز الطرفي متاحًا لبعض التطبيقات.

المعلمات

  • callback

    دالة

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

    (request: Request, descriptorId: string) => void

onServiceAdded

chrome.bluetoothLowEnergy.onServiceAdded.addListener(
  callback: function,
)

يتم تشغيل هذا الحدث عند اكتشاف خدمة GATT جديدة على جهاز بعيد.

المعلمات

  • callback

    دالة

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

    (service: Service) => void

onServiceChanged

chrome.bluetoothLowEnergy.onServiceChanged.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عند تغيُّر حالة خدمة GATT بعيدة. ويشمل ذلك أي خصائص و/أو أوصاف تتم إضافتها أو إزالتها من الخدمة، بالإضافة إلى إشعارات "ServiceChanged" من الجهاز البعيد.

المعلمات

  • callback

    دالة

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

    (service: Service) => void

onServiceRemoved

chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عند إزالة خدمة GATT تم اكتشافها سابقًا على جهاز بعيد.

المعلمات

  • callback

    دالة

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

    (service: Service) => void