chrome.bluetoothLowEnergy

الوصف

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

مدى التوفّر

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

البيان

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

"bluetooth"

الأنواع

Advertisement

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

الخصائص

  • manufacturerData

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

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

  • serviceData

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

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

  • serviceUuids

    string[] اختياري

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

  • solicitUuids

    string[] اختياري

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

  • النوع

    AdvertisementType

    نوع الإعلان

AdvertisementType

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

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

Enum

"broadcast"

"peripheral"

Characteristic

الخصائص

  • instanceId

    string اختياري

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

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

    CharacteristicProperty[]

    The properties of this characteristic.

  • الخدمة

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

    خدمة 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

الخصائص

  • الخاصية

    Characteristic اختيارية

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

  • instanceId

    string اختياري

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

  • أذونات

    DescriptorPermission[]

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

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

  • uuid

    سلسلة

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

  • القيمة

    ‫ArrayBuffer اختياري

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

DescriptorPermission

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

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

Enum

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

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

الخصائص

  • معالجة

    سلسلة

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

  • deviceClass

    number اختيارية

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

  • الاسم

    string اختياري

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

ManufacturerData

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

الخصائص

  • البيانات

    number[]

  • id

    الرقم

Notification

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

الخصائص

  • shouldIndicate

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

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

  • القيمة

    ArrayBuffer

    القيمة الجديدة للسمة

NotificationProperties

الخصائص

  • ثابتة

    قيمة منطقية

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

Request

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

الخصائص

  • جهاز

    الجهاز

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

  • requestId

    الرقم

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

  • القيمة

    ‫ArrayBuffer اختياري

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

Response

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

الخصائص

  • isError

    قيمة منطقية

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

  • requestId

    الرقم

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

  • القيمة

    ‫ArrayBuffer اختياري

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

Service

الخصائص

  • deviceAddress

    string اختياري

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

  • instanceId

    string اختياري

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

  • isPrimary

    قيمة منطقية

    يشير هذا العمود إلى ما إذا كان نوع هذه الخدمة أساسيًا أو ثانويًا.

  • uuid

    سلسلة

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

ServiceData

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

الخصائص

  • البيانات

    number[]

  • uuid

    سلسلة

الطُرق

connect()

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

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

المعلمات

  • deviceAddress

    سلسلة

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

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

    ConnectProperties اختيارية

    خصائص الاتصال (اختيارية)

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

createCharacteristic()

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

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

المعلمات

  • الخاصية

    السمة

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

  • serviceId

    سلسلة

    رقم تعريف الخدمة المطلوب إنشاء هذه السمة لها

  • callback

    function اختياري

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

    (characteristicId: string) => void

    • characteristicId

      سلسلة

المرتجعات

  • وعد<سلسلة>

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

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

createDescriptor()

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

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

المعلمات

  • وصف

    Descriptor

    تمثّل هذه السمة الوصف المطلوب إنشاؤه.

  • characteristicId

    سلسلة

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

  • callback

    function اختياري

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

    (descriptorId: string) => void

    • descriptorId

      سلسلة

المرتجعات

  • وعد<سلسلة>

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

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

createService()

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

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

المعلمات

  • الخدمة

    الخدمة

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

  • callback

    function اختياري

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

    (serviceId: string) => void

    • serviceId

      سلسلة

المرتجعات

  • وعد<سلسلة>

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

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

disconnect()

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

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

المعلمات

  • deviceAddress

    سلسلة

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

getCharacteristic()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • callback

    function اختياري

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

    (result: Characteristic) => void

المرتجعات

  • Promise<Characteristic>

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

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

getCharacteristics()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

    function اختياري

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

    (result: Characteristic[]) => void

المرتجعات

  • Promise<Characteristic[]>

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

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

getDescriptor()

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

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

المعلمات

  • descriptorId

    سلسلة

    رقم تعريف مثيل واصف سمة GATT المطلوب

  • callback

    function اختياري

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

    (result: Descriptor) => void

المرتجعات

  • Promise<Descriptor>

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

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

getDescriptors()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • callback

    function اختياري

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

    (result: Descriptor[]) => void

المرتجعات

  • Promise<Descriptor[]>

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

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

getIncludedServices()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

    function اختياري

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

    (result: Service[]) => void

المرتجعات

  • Promise<Service[]>

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

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

getService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

    function اختياري

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

    (result: Service) => void

المرتجعات

  • Promise<Service>

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

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

getServices()

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

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

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

المعلمات

  • deviceAddress

    سلسلة

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

  • callback

    function اختياري

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

    (result: Service[]) => void

المرتجعات

  • Promise<Service[]>

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

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

notifyCharacteristicValueChanged()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • إشعار

    Notification

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

readCharacteristicValue()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • callback

    function اختياري

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

    (result: Characteristic) => void

المرتجعات

  • Promise<Characteristic>

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

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

readDescriptorValue()

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

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

المعلمات

  • descriptorId

    سلسلة

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

  • callback

    function اختياري

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

    (result: Descriptor) => void

المرتجعات

  • Promise<Descriptor>

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

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

registerAdvertisement()

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

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

المعلمات

  • إعلان

    إعلان

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

  • callback

    function اختياري

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

    (advertisementId: number) => void

    • advertisementId

      الرقم

المرتجعات

  • <number>

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

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

registerService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

removeService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

resetAdvertising()

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

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

المعلمات

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

sendRequestResponse()

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

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

المعلمات

setAdvertisingInterval()

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

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

المعلمات

  • minInterval

    الرقم

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

  • maxInterval

    الرقم

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

startCharacteristicNotifications()

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

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

المعلمات

  • characteristicId

    سلسلة

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

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

    NotificationProperties اختيارية

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

stopCharacteristicNotifications()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

unregisterAdvertisement()

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

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

المعلمات

  • advertisementId

    الرقم

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

unregisterService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

writeCharacteristicValue()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • القيمة

    ArrayBuffer

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

writeDescriptorValue()

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

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

المعلمات

  • descriptorId

    سلسلة

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

  • القيمة

    ArrayBuffer

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

الفعاليات

onCharacteristicReadRequest

الإصدار 52 من Chrome أو الإصدارات الأحدث 
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

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

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

المعلمات

  • callback

    دالة

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

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

onDescriptorReadRequest

الإصدار 52 من Chrome أو الإصدارات الأحدث 
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

الإصدار 52 من Chrome أو الإصدارات الأحدث 
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