chrome.bluetoothLowEnergy

الوصف

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

البيان

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

"bluetooth"

الأنواع

Advertisement

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

أماكن إقامة

  • manufacturerData

    ManufacturerData[] اختيارية

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

  • serviceData

    ServiceData[] اختيارية

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

  • serviceUuids

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

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

  • solicitUuids

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

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

  • كتابة

    AdvertisementType

    نوع الإعلان

AdvertisementType

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

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

التعداد

"broadcast"

Characteristic

أماكن إقامة

  • instanceId

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

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

  • المواقع

    CharacteristicProperty[]

    تمثّل هذه السمة خصائص هذه السمة.

  • الخدمة

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

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

  • uuid

    سلسلة

    تمثّل هذه السمة المعرّف الفريد العالمي للسمة، مثل 00002a37-0000-1000-8000-00805f9b34fb.

  • القيمة

    ArrayBuffer اختيارية

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

CharacteristicProperty

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

التعداد

"broadcast"

"writeWithoutResponse"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

أماكن إقامة

  • ثابت

    boolean

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

Descriptor

أماكن إقامة

  • خاصية

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

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

  • instanceId

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

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

  • الأذونات

    DescriptorPermission[]

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

    تمثّل هذه السمة أذونات أداة الوصف هذه.

  • uuid

    سلسلة

    تمثّل هذه السمة المعرّف الفريد العالمي لوصف الميزة، مثل 00002902-0000-1000-8000-00805f9b34fb.

  • القيمة

    ArrayBuffer اختيارية

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

DescriptorPermission

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

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

التعداد

Device

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

أماكن إقامة

  • معالجة

    سلسلة

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

  • deviceClass

    الرقم اختياري

    فئة الجهاز، وهي حقل بت يتم تحديده بواسطة http://www.Bluetooth.org/en-us/specification/assigned-numbers/base Band.

  • اسم

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

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

ManufacturerData

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

أماكن إقامة

  • البيانات

    الرقم[]

  • id

    الرقم

Notification

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

أماكن إقامة

  • shouldIndicate

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

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

  • القيمة

    ArrayBuffer

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

NotificationProperties

أماكن إقامة

  • ثابت

    boolean

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

Request

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

أماكن إقامة

  • جهاز

    الجهاز

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

  • requestId

    الرقم

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

  • القيمة

    ArrayBuffer اختيارية

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

Response

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

أماكن إقامة

  • isError

    boolean

    إذا كانت هذه استجابة خطأ، يجب أن يكون ذلك صحيحًا.

  • requestId

    الرقم

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

  • القيمة

    ArrayBuffer اختيارية

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

Service

أماكن إقامة

  • deviceAddress

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

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

  • instanceId

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

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

  • isPrimary

    boolean

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

  • uuid

    سلسلة

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

ServiceData

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

أماكن إقامة

  • البيانات

    الرقم[]

  • uuid

    سلسلة

الطُرق

connect()

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

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

المَعلمات

  • deviceAddress

    سلسلة

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

  • المواقع

    ConnectProperties اختياري

    خصائص الربط (اختياري)

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

createCharacteristic()

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

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

المَعلمات

  • خاصية

    السمة

    خاصية الإنشاء.

  • serviceId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (characteristicId: string)=>void

    • characteristicId

      سلسلة

المرتجعات

  • وعد<string>

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

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

createDescriptor()

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

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

المَعلمات

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

  • characteristicId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (descriptorId: string)=>void

    • descriptorId

      سلسلة

المرتجعات

  • وعد<string>

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

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

createService()

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

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

المَعلمات

  • الخدمة

    الخدمة

    الخدمة التي يتم إنشاؤها.

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (serviceId: string)=>void

    • serviceId

      سلسلة

المرتجعات

  • وعد<string>

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

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

disconnect()

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

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

المَعلمات

  • deviceAddress

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

getCharacteristic()

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

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

المَعلمات

  • characteristicId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: Characteristic)=>void

المرتجعات

  • Promise<Characteristic>

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

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

getCharacteristics()

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

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

المَعلمات

  • serviceId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: Characteristic[])=>void

المرتجعات

  • Promise<Characteristic[]>

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

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

getDescriptor()

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

احصل على واصف خاصية GATT مع رقم تعريف المثيل المعني.

المَعلمات

  • descriptorId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: Descriptor)=>void

المرتجعات

  • Promise<Descriptor>

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

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

getDescriptors()

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

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

المَعلمات

  • characteristicId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: Descriptor[])=>void

المرتجعات

  • Promise<Descriptor[]>

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

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

getIncludedServices()

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

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

المَعلمات

  • serviceId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: Service[])=>void

المرتجعات

  • تقديم وعود<الخدمة[]>

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

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

getService()

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

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

المَعلمات

  • serviceId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: Service)=>void

المرتجعات

  • تقديم وعود<الخدمة>

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

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

getServices()

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

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

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

المَعلمات

  • deviceAddress

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: Service[])=>void

المرتجعات

  • تقديم وعود<الخدمة[]>

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

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

notifyCharacteristicValueChanged()

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

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

المَعلمات

  • characteristicId

    سلسلة

    السمة المطلوب إرسال الإشعار بشأنها.

  • إشعار

    الإشعار

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

readCharacteristicValue()

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

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

المَعلمات

  • characteristicId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: Characteristic)=>void

المرتجعات

  • Promise<Characteristic>

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

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

readDescriptorValue()

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

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

المَعلمات

  • descriptorId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: Descriptor)=>void

المرتجعات

  • Promise<Descriptor>

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

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

registerAdvertisement()

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

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

المَعلمات

  • إعلان

    الإعلان

    الإعلان المراد الإعلان عنه.

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (advertisementId: number)=>void

    • advertisementId

      الرقم

المرتجعات

  • وعد<الرقم>

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

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

registerService()

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

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

المَعلمات

  • serviceId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

removeService()

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

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

المَعلمات

  • serviceId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

resetAdvertising()

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

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

المَعلمات

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

sendRequestResponse()

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

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

المَعلمات

  • رد

    الرد

    الردّ على الطلب.

setAdvertisingInterval()

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

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

المَعلمات

  • minInterval

    الرقم

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

  • maxInterval

    الرقم

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

startCharacteristicNotifications()

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

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

المَعلمات

  • characteristicId

    سلسلة

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

  • المواقع

    NotificationProperties اختيارية

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

stopCharacteristicNotifications()

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

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

المَعلمات

  • characteristicId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

unregisterAdvertisement()

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

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

المَعلمات

  • advertisementId

    الرقم

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

unregisterService()

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

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

المَعلمات

  • serviceId

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

writeCharacteristicValue()

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

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

المَعلمات

  • characteristicId

    سلسلة

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

  • القيمة

    ArrayBuffer

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

writeDescriptorValue()

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

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

المَعلمات

  • descriptorId

    سلسلة

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

  • القيمة

    ArrayBuffer

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

فعاليات

onCharacteristicReadRequest

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة 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:الأجهزة الطرفية" على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

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

onDescriptorReadRequest

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة 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:الأجهزة الطرفية" على "صحيح". قد لا يتوفّر إذن الأجهزة الملحقة لبعض التطبيقات.

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة 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