chrome.bluetoothLowEnergy

الوصف

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

البيان

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

"bluetooth"

الأنواع

Advertisement

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

أماكن إقامة

  • manufacturerData

    ManufacturerData[] اختيارية

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

  • serviceData

    ServiceData[] اختيارية

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

  • serviceUuids

    string[] اختيارية

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

  • solicitUuids

    string[] اختيارية

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

  • كتابة

    AdvertisementType

    نوع الإعلان.

AdvertisementType

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

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

Enum

"البث"

"ملحق"

Characteristic

أماكن إقامة

  • instanceId

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

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

  • المواقع

    CharacteristicProperty[]

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

  • الخدمة

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

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

  • رقم uuid

    سلسلة

    المعرّف الفريد العالمي للخاصية، مثل 00002a37-0000-1000-8000-00805f9b34fb.

  • القيمة

    ArrayBuffer اختيارية

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

CharacteristicProperty

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

Enum

"البث"

"قراءة"

" writeWithoutResponse"

"الكتابة"

"إرسال إشعار"

"الإشارة"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

أماكن إقامة

  • مستمر

    منطقي

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

Descriptor

أماكن إقامة

  • سمة

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

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

  • instanceId

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

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

  • الأذون

    DescriptorPermission[]

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

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

  • رقم uuid

    سلسلة

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

  • القيمة

    ArrayBuffer اختيارية

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

DescriptorPermission

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

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

Enum

"قراءة"

"الكتابة"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

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

أماكن إقامة

  • معالجة

    سلسلة

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

  • deviceClass

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

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

  • الاسم

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

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

ManufacturerData

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

أماكن إقامة

  • البيانات

    رقم[]

  • id

    الرقم

Notification

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

أماكن إقامة

  • shouldIndicate

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

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

  • القيمة

    مخزن المصفوفات

    القيمة الجديدة للصفة.

NotificationProperties

أماكن إقامة

  • مستمر

    منطقي

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

Request

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

أماكن إقامة

  • جهاز

    الجهاز

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

  • requestId

    الرقم

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

  • القيمة

    ArrayBuffer اختيارية

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

Response

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

أماكن إقامة

  • isError

    منطقي

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

  • requestId

    الرقم

    معرّف الطلب الذي يكون هذا ردًا عليه.

  • القيمة

    ArrayBuffer اختيارية

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

Service

أماكن إقامة

  • deviceAddress

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

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

  • instanceId

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

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

  • أساسي

    منطقي

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

  • رقم uuid

    سلسلة

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

ServiceData

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

أماكن إقامة

  • البيانات

    رقم[]

  • رقم uuid

    سلسلة

الطُرق

connect()

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

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

المعلمات

  • deviceAddress

    سلسلة

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

  • المواقع

    ConnectProperties اختياري

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

createCharacteristic()

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

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

المعلمات

  • ميزة الإنشاء.

  • رقم تعريف الخدمة

    سلسلة

    معرّف الخدمة المطلوب إنشاء هذه الميزة له.

  • رد الاتصال

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

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

    (characteristicId: string) => void

    • characteristicId

      سلسلة

المرتجعات

  • وعود<string>

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

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

createDescriptor()

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

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

المعلمات

  • الواصف المراد إنشائه.

  • characteristicId

    سلسلة

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

  • رد الاتصال

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

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

    (descriptorId: string) => void

    • descriptorId

      سلسلة

المرتجعات

  • وعود<string>

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

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

createService()

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

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

المعلمات

  • الخدمة

    الخدمة

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

  • رد الاتصال

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

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

    (serviceId: string) => void

    • رقم تعريف الخدمة

      سلسلة

المرتجعات

  • وعود<string>

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

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

disconnect()

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

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

المعلمات

  • deviceAddress

    سلسلة

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

getCharacteristic()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • رد الاتصال

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

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

    (result: Characteristic) => void

المرتجعات

  • الوعد<Characteristic>

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

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

getCharacteristics()

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

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

المعلمات

  • رقم تعريف الخدمة

    سلسلة

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

  • رد الاتصال

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

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

    (result: Characteristic[]) => void

المرتجعات

  • الوعد<Characteristic[]>

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

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

getDescriptor()

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

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

المعلمات

  • descriptorId

    سلسلة

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

  • رد الاتصال

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

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

    (result: Descriptor) => void

المرتجعات

  • Promise&lt;Descriptor&gt;

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

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

getDescriptors()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • رد الاتصال

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

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

    (result: Descriptor[]) => void

المرتجعات

  • Promise&lt;Descriptor[]&gt;

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

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

getIncludedServices()

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

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

المعلمات

  • رقم تعريف الخدمة

    سلسلة

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

  • رد الاتصال

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

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

    (result: Service[]) => void

المرتجعات

  • Promise<Service[]>

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

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

getService()

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

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

المعلمات

  • رقم تعريف الخدمة

    سلسلة

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

  • رد الاتصال

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

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

    (result: Service) => void

المرتجعات

  • Promise&lt;Service&gt;

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

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

getServices()

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

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

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

المعلمات

  • deviceAddress

    سلسلة

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

  • رد الاتصال

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

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

    (result: Service[]) => void

المرتجعات

  • Promise<Service[]>

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

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

notifyCharacteristicValueChanged()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • إشعار

    إشعار

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

readCharacteristicValue()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • رد الاتصال

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

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

    (result: Characteristic) => void

المرتجعات

  • الوعد<Characteristic>

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

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

readDescriptorValue()

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

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

المعلمات

  • descriptorId

    سلسلة

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

  • رد الاتصال

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

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

    (result: Descriptor) => void

المرتجعات

  • Promise&lt;Descriptor&gt;

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

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

registerAdvertisement()

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

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

المعلمات

  • إعلان

    إعلان

    الإعلان المطلوب الإعلان عنه.

  • رد الاتصال

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

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

    (advertisementId: number) => void

    • advertisementId

      الرقم

المرتجعات

  • Promise&lt;number&gt;

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

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

registerService()

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

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

المعلمات

  • رقم تعريف الخدمة

    سلسلة

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

removeService()

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

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

المعلمات

  • رقم تعريف الخدمة

    سلسلة

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

resetAdvertising()

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

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

المعلمات

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

sendRequestResponse()

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

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

المعلمات

  • رد

    الردّ

    تمثّل هذه السمة الردّ على الطلب.

setAdvertisingInterval()

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

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

المعلمات

  • minInterval

    الرقم

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

  • maxInterval

    الرقم

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

startCharacteristicNotifications()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • المواقع

    NotificationProperties اختيارية

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

stopCharacteristicNotifications()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

unregisterAdvertisement()

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

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

المعلمات

  • advertisementId

    الرقم

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

unregisterService()

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

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

المعلمات

  • رقم تعريف الخدمة

    سلسلة

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

writeCharacteristicValue()

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

اكتب قيمة خاصية محددة من جهاز ملحق بعيد.

المعلمات

  • characteristicId

    سلسلة

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

  • القيمة

    مخزن المصفوفات

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

writeDescriptorValue()

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

اكتب قيمة واصف خاص محدد من جهاز ملحق بعيد.

المعلمات

  • descriptorId

    سلسلة

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

  • القيمة

    مخزن المصفوفات

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

فعاليات

onCharacteristicReadRequest

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

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

المعلمات

  • رد الاتصال

    دالة

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

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

    • طلب

      طلب

    • characteristicId

      سلسلة

onCharacteristicValueChanged

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

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

المعلمات

  • رد الاتصال

    دالة

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

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

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

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

المعلمات

  • رد الاتصال

    دالة

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

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

    • طلب

      طلب

    • characteristicId

      سلسلة

onDescriptorReadRequest

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

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

المعلمات

  • رد الاتصال

    دالة

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

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

    • طلب

      طلب

    • descriptorId

      سلسلة

onDescriptorValueChanged

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

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

المعلمات

  • رد الاتصال

    دالة

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

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

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

المعلمات

  • رد الاتصال

    دالة

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

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

    • طلب

      طلب

    • descriptorId

      سلسلة

onServiceAdded

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

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

المعلمات

  • رد الاتصال

    دالة

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

    (service: Service) => void

onServiceChanged

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

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

المعلمات

  • رد الاتصال

    دالة

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

    (service: Service) => void

onServiceRemoved

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

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

المعلمات

  • رد الاتصال

    دالة

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

    (service: Service) => void