chrome.bluetoothLowEnergy

الوصف

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

البيان

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

"bluetooth"

الأنواع

Advertisement

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

الخصائص

  • manufacturerData

    ManufacturerData[] اختياري

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

  • serviceData

    ServiceData[] اختيارية

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

  • serviceUuids

    string[] اختياري

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

  • solicitUuids

    string[] اختياري

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

  • النوع

    AdvertisementType

    نوع الإعلان.

AdvertisementType

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

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

Enum

"broadcast"

"peripheral"

Characteristic

الخصائص

  • instanceId

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

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

  • مواقع

    CharacteristicProperty[]

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

  • الخدمة

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

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

  • uuid

    سلسلة

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

  • القيمة

    ArrayBuffer اختياري

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

CharacteristicProperty

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

Enum

"broadcast"

"read"

"writeWithoutResponse"

"كتابة"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

الخصائص

  • مستمر

    قيمة منطقية

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

Descriptor

الخصائص

  • السمة

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

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

  • instanceId

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

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

  • أذونات

    DescriptorPermission[]

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

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

  • uuid

    سلسلة

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

  • القيمة

    ArrayBuffer اختياري

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

DescriptorPermission

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

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

Enum

"read"

"كتابة"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

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

الخصائص

  • معالجة

    سلسلة

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

  • deviceClass

    number اختياري

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

  • الاسم

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

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

ManufacturerData

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

الخصائص

  • البيانات

    number[]

  • id

    الرقم

Notification

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

الخصائص

  • shouldIndicate

    boolean اختياري

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

  • القيمة

    ArrayBuffer

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

NotificationProperties

الخصائص

  • مستمر

    قيمة منطقية

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

Request

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

الخصائص

  • جهاز

    الجهاز

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

  • requestId

    الرقم

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

  • القيمة

    ArrayBuffer اختياري

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

Response

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

الخصائص

  • isError

    قيمة منطقية

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

  • requestId

    الرقم

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

  • القيمة

    ArrayBuffer اختياري

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

Service

الخصائص

  • deviceAddress

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

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

  • instanceId

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

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

  • isPrimary

    قيمة منطقية

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

  • uuid

    سلسلة

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

ServiceData

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

الخصائص

  • البيانات

    number[]

  • uuid

    سلسلة

الطُرق

connect()

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

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

المعلمات

  • deviceAddress

    سلسلة

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

  • مواقع

    ConnectProperties اختيارية

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

createCharacteristic()

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

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

المعلمات

  • السمة

    السمة

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

  • serviceId

    سلسلة

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

  • callback

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

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

    (characteristicId: string) => void

    • characteristicId

      سلسلة

المرتجعات

  • Promise<string>

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

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

createDescriptor()

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

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

المعلمات

  • واصف

    الواصف

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

  • characteristicId

    سلسلة

    المعرّف الخاص بالسمة التي سيتم إنشاء واصف لها.

  • callback

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

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

    (descriptorId: string) => void

    • descriptorId

      سلسلة

المرتجعات

  • Promise<string>

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

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

createService()

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

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

المعلمات

  • الخدمة

    الخدمة

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

  • callback

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

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

    (serviceId: string) => void

    • serviceId

      سلسلة

المرتجعات

  • Promise<string>

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

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

disconnect()

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

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

المعلمات

  • deviceAddress

    سلسلة

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

getCharacteristic()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • callback

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

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

    (result: Characteristic) => void

المرتجعات

  • Promise<Characteristic>

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

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

getCharacteristics()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

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

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

    (result: Characteristic[]) => void

المرتجعات

  • Promise<Characteristic[]>

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

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

getDescriptor()

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

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

المعلمات

  • descriptorId

    سلسلة

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

  • callback

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

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

    (result: Descriptor) => void

المرتجعات

  • Promise<Descriptor>

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

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

getDescriptors()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • callback

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

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

    (result: Descriptor[]) => void

المرتجعات

  • Promise<Descriptor[]>

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

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

getIncludedServices()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

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

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

    (result: Service[]) => void

المرتجعات

  • Promise<Service[]>

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

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

getService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

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

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

    (result: Service) => void

المرتجعات

  • Promise<Service>

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

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

getServices()

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

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

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

المعلمات

  • deviceAddress

    سلسلة

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

  • callback

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

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

    (result: Service[]) => void

المرتجعات

  • Promise<Service[]>

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

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

notifyCharacteristicValueChanged()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • إشعار

    الإشعار

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

readCharacteristicValue()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • callback

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

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

    (result: Characteristic) => void

المرتجعات

  • Promise<Characteristic>

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

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

readDescriptorValue()

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

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

المعلمات

  • descriptorId

    سلسلة

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

  • callback

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

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

    (result: Descriptor) => void

المرتجعات

  • Promise<Descriptor>

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

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

registerAdvertisement()

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

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

المعلمات

  • إعلان

    الإعلان

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

  • callback

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

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

    (advertisementId: number) => void

    • advertisementId

      الرقم

المرتجعات

  • Promise<number>

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

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

registerService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

removeService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

resetAdvertising()

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

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

المعلمات

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

sendRequestResponse()

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

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

المعلمات

  • رد

    الرد

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

setAdvertisingInterval()

Promise Chrome 55+ 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

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

المعلمات

  • minInterval

    الرقم

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

  • maxInterval

    الرقم

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

startCharacteristicNotifications()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • مواقع

    NotificationProperties اختيارية

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

stopCharacteristicNotifications()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

unregisterAdvertisement()

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

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

المعلمات

  • advertisementId

    الرقم

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

unregisterService()

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

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

المعلمات

  • serviceId

    سلسلة

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

writeCharacteristicValue()

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

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

المعلمات

  • characteristicId

    سلسلة

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

  • القيمة

    ArrayBuffer

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

writeDescriptorValue()

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

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

المعلمات

  • descriptorId

    سلسلة

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

  • القيمة

    ArrayBuffer

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

الفعاليات

onCharacteristicReadRequest

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

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

المعلمات

  • callback

    دالة

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

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

onCharacteristicValueChanged

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

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

المعلمات

  • callback

    دالة

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

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

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

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

المعلمات

  • callback

    دالة

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

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

onDescriptorReadRequest

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

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

المعلمات

  • callback

    دالة

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

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

onDescriptorValueChanged

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

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

المعلمات

  • callback

    دالة

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

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

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

المعلمات

  • callback

    دالة

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

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

onServiceAdded

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

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

المعلمات

  • callback

    دالة

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

    (service: Service) => void

onServiceChanged

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

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

المعلمات

  • callback

    دالة

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

    (service: Service) => void

onServiceRemoved

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

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

المعلمات

  • callback

    دالة

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

    (service: Service) => void