chrome.bluetoothLowEnergy

الوصف

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

البيان

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

"bluetooth"

الأنواع

Advertisement

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

أماكن إقامة

  • manufacturerData

    ‫ManufacturerData[] اختيارية

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

  • serviceData

    ServiceData[] اختيارية

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

  • serviceUuids

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

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

  • solicitUuids

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

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

  • كتابة

    AdvertisementType

    نوع الإعلان

AdvertisementType

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

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

Enum

"broadcast"

"peripheral"

Characteristic

أماكن إقامة

  • instanceId

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

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

  • المواقع

    CharacteristicProperty[]

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

  • الخدمة

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

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

  • uuid

    سلسلة

    معرّف UUID للسمة، على سبيل المثال ‎00002a37-0000-1000-8000-00805f9b34fb.

  • القيمة

    ArrayBuffer اختياري

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

CharacteristicProperty

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

Enum

"broadcast"

"read"

"writeWithoutResponse"

"write"

"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 لمعرفة معنى كل إذن فردي.

Enum

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

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

أماكن إقامة

  • معالجة

    سلسلة

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

  • deviceClass

    رقم اختياري

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

  • الاسم

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

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

ManufacturerData

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

أماكن إقامة

  • البيانات

    number[]

  • id

    الرقم

Notification

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

أماكن إقامة

  • shouldIndicate

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

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

  • القيمة

    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,
)

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

المعلمات

  • deviceAddress

    سلسلة

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

  • المواقع

    ConnectProperties اختيارية

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

createCharacteristic()

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

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

المعلمات

  • سمة

    السمة

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

  • serviceId

    سلسلة

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

  • ردّ الاتصال

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

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

    (characteristicId: string) => void

    • characteristicId

      سلسلة

المرتجعات

  • Promise<string>

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

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

createDescriptor()

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

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

المعلمات

  • وصف

    الوصف

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

  • characteristicId

    سلسلة

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

  • ردّ الاتصال

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

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

    (descriptorId: string) => void

    • descriptorId

      سلسلة

المرتجعات

  • Promise<string>

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

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

createService()

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

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

المعلمات

  • الخدمة

    الخدمة

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

  • ردّ الاتصال

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

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

    (serviceId: string) => void

    • serviceId

      سلسلة

المرتجعات

  • Promise<string>

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

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

disconnect()

الوعد 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

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

المعلمات

  • deviceAddress

    سلسلة

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

getCharacteristic()

الوعد 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

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

المعلمات

  • characteristicId

    سلسلة

    معرّف النسخ من سمة GATT المطلوبة

  • ردّ الاتصال

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

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

    (result: Characteristic) => void

المرتجعات

  • Promise<Characteristic>

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

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

getCharacteristics()

الوعد 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

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

المعلمات

  • serviceId

    سلسلة

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

  • ردّ الاتصال

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

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

    (result: Characteristic[]) => void

المرتجعات

  • Promise<Characteristic[]>

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

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

getDescriptor()

الوعد 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

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

المعلمات

  • descriptorId

    سلسلة

    معرّف النسخة لوصف سمة GATT المطلوبة

  • ردّ الاتصال

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

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

    (result: Descriptor) => void

المرتجعات

  • Promise<Descriptor>

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

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

getDescriptors()

الوعد 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

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

المعلمات

  • characteristicId

    سلسلة

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

  • ردّ الاتصال

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

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

    (result: Descriptor[]) => void

المرتجعات

  • Promise<Descriptor[]>

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

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

getIncludedServices()

الوعد 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

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

المعلمات

  • serviceId

    سلسلة

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

  • ردّ الاتصال

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

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

    (result: Service[]) => void

المرتجعات

  • Promise<Service[]>

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

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

getService()

الوعد 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

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

المعلمات

  • serviceId

    سلسلة

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

  • ردّ الاتصال

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

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

    (result: Service) => void

المرتجعات

  • الوعد<الخدمة>

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

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

getServices()

الوعد 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

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

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

المعلمات

  • deviceAddress

    سلسلة

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

  • ردّ الاتصال

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

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

    (result: Service[]) => void

المرتجعات

  • Promise<Service[]>

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

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

notifyCharacteristicValueChanged()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • إشعار

    الإشعار

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

readCharacteristicValue()

الوعد 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

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

المعلمات

  • characteristicId

    سلسلة

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

  • ردّ الاتصال

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

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

    (result: Characteristic) => void

المرتجعات

  • Promise<Characteristic>

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

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

readDescriptorValue()

الوعد 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

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

المعلمات

  • descriptorId

    سلسلة

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

  • ردّ الاتصال

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

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

    (result: Descriptor) => void

المرتجعات

  • Promise<Descriptor>

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

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

registerAdvertisement()

الوعد Chrome 47 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

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

المعلمات

  • إعلان

    الإعلان

    الإعلان المطلوب عرضه

  • ردّ الاتصال

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

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

    (advertisementId: number) => void

    • advertisementId

      الرقم

المرتجعات

  • Promise<number>

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

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

registerService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

removeService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

resetAdvertising()

الوعد Chrome 61 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

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

المعلمات

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

sendRequestResponse()

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

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

المعلمات

setAdvertisingInterval()

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

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

المعلمات

  • minInterval

    الرقم

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

  • maxInterval

    الرقم

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

startCharacteristicNotifications()

الوعد 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

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

المعلمات

  • characteristicId

    سلسلة

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

  • المواقع

    NotificationProperties اختيارية

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

stopCharacteristicNotifications()

الوعد 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

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

المعلمات

  • characteristicId

    سلسلة

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

unregisterAdvertisement()

الوعد Chrome 47 والإصدارات الأحدث 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

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

المعلمات

  • advertisementId

    الرقم

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

unregisterService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

writeCharacteristicValue()

الوعد 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

المعلمات

  • characteristicId

    سلسلة

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

  • القيمة

    ArrayBuffer

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

writeDescriptorValue()

الوعد 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

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

المعلمات

  • descriptorId

    سلسلة

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

  • القيمة

    ArrayBuffer

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

  • ردّ الاتصال

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

الفعاليات

onCharacteristicReadRequest

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

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

المعلمات

  • ردّ الاتصال

    دالة

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

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

onCharacteristicValueChanged

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

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

المعلمات

  • ردّ الاتصال

    دالة

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

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

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

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

المعلمات

  • ردّ الاتصال

    دالة

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

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

onDescriptorReadRequest

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

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

المعلمات

  • ردّ الاتصال

    دالة

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

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

onDescriptorValueChanged

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

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

المعلمات

  • ردّ الاتصال

    دالة

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

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

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

المعلمات

  • ردّ الاتصال

    دالة

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

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

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 التي تم اكتشافها سابقًا على جهاز بعيد.

المعلمات

  • ردّ الاتصال

    دالة

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

    (service: Service) => void