chrome.bluetooth

الوصف

يمكنك استخدام واجهة برمجة تطبيقات chrome.bluetooth للاتصال بجهاز يتضمّن بلوتوث. تُبلِغ جميع الدوال عن حالات الإخفاق من خلال chrome.runtime.lastError.

البيان

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

"bluetooth"

الأنواع

AdapterState

أماكن إقامة

  • معالجة

    سلسلة

    عنوان المحوّل، بالتنسيق "XX:XX:XX:XX:XX:XX".

  • متوفر

    منطقي

    يشير إلى ما إذا كان المحوّل متاحًا أم لا (أي مفعَّل).

  • اكتشاف

    منطقي

    يشير إلى ما إذا كان المحول يكتشف اكتشافًا حاليًا أم لا.

  • الاسم

    سلسلة

    اسم المحوِّل الذي يمكن للمستخدمين قراءته.

  • مشغَّل

    منطقي

    يشير إلى ما إذا كان المحوّل متصلاً بالطاقة أم لا.

BluetoothFilter

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

أماكن إقامة

  • filterType

    FilterType اختياري

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

  • الحدّ الأقصى المسموح به

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

    الحد الأقصى لعدد أجهزة البلوتوث التي يمكن إرجاعها. وتكون القيمة التلقائية 0 (بدون حد أقصى) في حال عدم تحديد القيمة.

Device

أماكن إقامة

  • معالجة

    سلسلة

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

  • batteryPercentage

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

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

    النسبة المتبقية من طاقة بطارية الجهاز

  • قابل للاتصال

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

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

    تشير هذه العلامة إلى ما إذا كان الجهاز قابلاً للاتصال.

  • تم الربط

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

    يشير هذا الرمز إلى ما إذا كان الجهاز متصلاً حاليًا بالنظام.

  • رحلة ربط

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

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

    يشير هذا الرمز إلى ما إذا كان الجهاز متصلاً حاليًا بالنظام.

  • deviceClass

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

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

  • deviceId

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

  • inquiryRssi

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

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

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

  • inquiryTxPower

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

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

    مستوى الطاقة المنقولة. هذا الحقل متاح فقط لأجهزة LE التي تتضمن هذا الحقل في AD. وهو متاح وصالح فقط خلال فترة الاكتشاف.

  • الاسم

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

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

  • مقترن

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

    يشير إلى ما إذا كان الجهاز مقترنًا بالنظام أم لا.

  • productId

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

  • طبقة النقل

    النقل اختياري

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

    نوع نقل الجهاز الذي يتضمّن بلوتوث

  • كتابة

    DeviceType اختيارية

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

  • uuids

    string[] اختيارية

    أرقام التعريف الفريدة العالمية للبروتوكولات والملفات الشخصية والخدمات التي يعلن عنها الجهاز. بالنسبة إلى الأجهزة الكلاسيكية التي تتضمّن بلوتوث، يتم الحصول على هذه القائمة من بيانات EIR وجداول SDP. بالنسبة إلى الأجهزة ذات الطاقة المنخفضة، يتم الحصول على هذه القائمة من الخدمات الأساسية AD وGATT. وبالنسبة إلى الأجهزة ذات الوضع المزدوج، يمكن الحصول على ذلك من كليهما.

  • vendorId

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

  • vendorIdSource

    VendorIdSource اختيارية

    سجلّ رقم تعريف الجهاز الخاص بالجهاز، حيثما كان ذلك متاحًا

DeviceType

أنواع الأجهزة الشائعة التي يتعرّف عليها Chrome.

Enum

"جهاز الكمبيوتر"

"الهاتف"

"modem"

"audio"

"carAudio"

"الفيديو"

"ملحق"

"ذراع التحكّم"

"gamepad"

"لوحة المفاتيح"

"ماوس"

"الجهاز اللوحي"

"لوحة المفاتيحMouseCombo"

FilterType

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

أنواع فلترة الأجهزة التي تتضمّن بلوتوث.

Enum

"الكل"

"معروف"

Transport

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

نوع وسيلة النقل لجهاز البلوتوث

Enum

"غير صالح"

"كلاسيكي"

"le"

"ثنائي"

VendorIdSource

جهات التخصيص لأرقام تعريف المورّدين:

Enum

"البلوتوث"

"usb"

الطُرق

getAdapterState()

وعود 
chrome.bluetooth.getAdapterState(
  callback?: function,
)

احصل على معلومات حول محوّل البلوتوث.

المعلمات

  • رد الاتصال

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

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

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      عنصر يحتوي على معلومات المحوّل

المرتجعات

  • Promise<AdapterState>

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

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

getDevice()

وعود 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

الحصول على معلومات حول الجهاز الذي يتضمّن بلوتوث معروفًا للنظام.

المعلمات

  • deviceAddress

    سلسلة

    عنوان الجهاز الذي تريد الحصول عليه.

  • رد الاتصال

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

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

    (deviceInfo: Device) => void

    • deviceInfo

      الجهاز

      عنصر يحتوي على معلومات الجهاز

المرتجعات

  • Promise<Device>

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

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

getDevices()

وعود 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

يمكنك الحصول على قائمة بالأجهزة التي تتضمّن بلوتوث معروفة للنظام، بما في ذلك الأجهزة المقترنة والأجهزة التي تم اكتشافها مؤخرًا.

المعلمات

  • تصفية

    BluetoothFilter اختياري

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

    بعض المعايير لفلترة قائمة أجهزة البلوتوث التي تم إرجاعها. إذا لم يتم ضبط الفلتر على {} أو لم يتم ضبطه، ستتضمّن قائمة الأجهزة المعروضة جميع الأجهزة التي تتضمّن بلوتوث. لا تتوفّر هذه الميزة حاليًا إلا في نظام التشغيل ChromeOS. أما بالنسبة إلى الأنظمة الأساسية الأخرى، فيمكنك عرض قائمة كاملة بها.

  • رد الاتصال

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

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

    (deviceInfos: Device[]) => void

    • deviceInfos

      الجهاز[]

      مصفوفة من العناصر تحتوي على معلومات الجهاز.

المرتجعات

  • الوعد<Device[]>

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

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

startDiscovery()

وعود 
chrome.bluetooth.startDiscovery(
  callback?: function,
)

ابدأ استكشاف المحتوى. سيتم عرض الأجهزة المكتشفة حديثًا من خلال حدث onDeviceAdd. ويجب الحصول على الأجهزة التي تم اكتشافها سابقًا والمعروفة بالمحوّل باستخدام أمر getDevices (الأجهزة)، ولن يتم تعديلها باستخدام حدث onDeviceChanged إلا في حال تغيير المعلومات المتعلّقة بها.

سيتعذّر بدء Discovery إذا سبق أن أطلق هذا التطبيق اسم startDiscovery. قد تستهلك عملية الاستكشاف موارد كثيرة: يجب طلب إيقاف Discovery في أسرع وقت ممكن.

المعلمات

  • رد الاتصال

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

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

    () => void

المرتجعات

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

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

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

stopDiscovery()

وعود 
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

إيقاف الاكتشاف

المعلمات

  • رد الاتصال

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

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

    () => void

المرتجعات

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

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

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

فعاليات

onAdapterStateChanged

chrome.bluetooth.onAdapterStateChanged.addListener(
  callback: function,
)

يتم تشغيله عند تغيير حالة محوّل البلوتوث.

المعلمات

  • رد الاتصال

    دالة

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

    (state: AdapterState) => void

onDeviceAdded

chrome.bluetooth.onDeviceAdded.addListener(
  callback: function,
)

يتم إطلاقه عند توفُّر معلومات عن جهاز جديد يتضمّن بلوتوث.

المعلمات

  • رد الاتصال

    دالة

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

    (device: Device) => void

onDeviceChanged

chrome.bluetooth.onDeviceChanged.addListener(
  callback: function,
)

يتم الإطلاق عند تغيير معلومات حول جهاز بلوتوث معروف.

المعلمات

  • رد الاتصال

    دالة

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

    (device: Device) => void

onDeviceRemoved

chrome.bluetooth.onDeviceRemoved.addListener(
  callback: function,
)

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

المعلمات

  • رد الاتصال

    دالة

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

    (device: Device) => void