کروم.بلوتوث

شرح

از chrome.bluetooth API برای اتصال به دستگاه بلوتوث استفاده کنید. همه توابع خرابی را از طریق chrome.runtime.lastError گزارش می دهند.

آشکار

برای استفاده از این API باید کلیدهای زیر در مانیفست اعلان شوند.

"bluetooth"

انواع

AdapterState

خواص

  • نشانی

    رشته

    آدرس آداپتور، در قالب "XX:XX:XX:XX:XX:XX".

  • در دسترس

    بولی

    نشان می دهد که آیا آداپتور در دسترس است (یعنی فعال است).

  • کشف کردن

    بولی

    نشان می دهد که آیا آداپتور در حال کشف است یا خیر.

  • نام

    رشته

    نام قابل خواندن آداپتور برای انسان.

  • نیرو گرفته است

    بولی

    نشان می دهد که آیا آداپتور برق دارد یا خیر.

BluetoothFilter

Chrome 67+

خواص

  • نوع فیلتر

    FilterType اختیاری است

    نوع فیلتر برای اعمال در لیست دستگاه. پیش فرض همه است.

  • حد

    شماره اختیاری

    حداکثر تعداد دستگاه های بلوتوث برای بازگشت. اگر مشخص نشده باشد، پیش‌فرض 0 (بدون محدودیت) است.

Device

خواص

  • نشانی

    رشته

    آدرس دستگاه، در قالب "XX:XX:XX:XX:XX:XX".

  • درصد باتری

    شماره اختیاری

    Chrome 77+

    باتری باقیمانده دستگاه

  • قابل اتصال

    بولی اختیاری

    Chrome 48+

    نشان می دهد که آیا دستگاه قابل اتصال است یا خیر.

  • متصل

    بولی اختیاری

    نشان می دهد که آیا دستگاه در حال حاضر به سیستم متصل است یا خیر.

  • برقراری ارتباط

    بولی اختیاری

    Chrome 48+

    نشان می دهد که آیا دستگاه در حال حاضر به سیستم متصل است یا خیر.

  • دستگاه کلاس

    شماره اختیاری

    کلاس دستگاه، یک فیلد بیتی است که توسط http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband تعریف شده است.

  • شناسه دستگاه

    شماره اختیاری

  • استعلامRssi

    شماره اختیاری

    Chrome 44+

    قدرت سیگنال دریافتی، بر حسب dBm. این فیلد فقط در زمان کشف در دسترس و معتبر است. خارج از کشف ارزش آن مشخص نشده است.

  • inquiryTxPower

    شماره اختیاری

    Chrome 44+

    سطح توان انتقالی این فیلد فقط برای دستگاه های LE که شامل این فیلد در AD هستند در دسترس است. فقط در هنگام کشف در دسترس و معتبر است.

  • نام

    رشته اختیاری

    نام دستگاه قابل خواندن برای انسان.

  • جفت شده است

    بولی اختیاری

    نشان می دهد که آیا دستگاه با سیستم جفت شده است یا خیر.

  • شناسه محصول

    شماره اختیاری

  • حمل و نقل

    حمل و نقل اختیاری است

    Chrome 76+

    نوع حمل و نقل دستگاه بلوتوث.

  • نوع

    DeviceType اختیاری است

    نوع دستگاه، اگر کروم تشخیص دهد. این از فیلد deviceClass به دست می آید و تنها بخش کوچکی از انواع دستگاه های ممکن را نشان می دهد. وقتی شک دارید باید مستقیماً از قسمت deviceClass استفاده کنید.

  • uuids

    رشته[] اختیاری است

    UUID پروتکل‌ها، پروفایل‌ها و سرویس‌های تبلیغ‌شده توسط دستگاه. برای دستگاه های بلوتوث کلاسیک، این لیست از داده های EIR و جداول SDP به دست می آید. برای دستگاه های کم انرژی، این لیست از خدمات اولیه AD و GATT به دست آمده است. برای دستگاه های حالت دوگانه، این ممکن است از هر دو به دست آید.

  • شناسه فروشنده

    شماره اختیاری

  • vendorIdSource

    VendorIdSource اختیاری است

    سابقه شناسه دستگاه دستگاه، در صورت وجود.

DeviceType

انواع دستگاه متداول که توسط Chrome شناسایی شده است.

Enum

"کامپیوتر"

"تلفن"

"مودم"

"سمعی"

"ضبط ماشین"

"ویدئو"

"پیرامونی"

"جوی استیک"

"گیم پد"

"صفحه کلید"

"موش"

"تبلت"

"keyboardMouseCombo"

FilterType

Chrome 67+

انواع فیلتر کردن دستگاه های بلوتوث

Enum

"همه"

"شناخته شده"

Transport

Chrome 76+

نوع حمل و نقل دستگاه بلوتوث

Enum

"بی اعتبار"

"کلاسیک"

"له"

"دوگانه"

VendorIdSource

مقامات تخصیص شناسه فروشنده.

Enum

"بلوتوث"

"یو اس بی"

مواد و روش ها

getAdapterState()

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

اطلاعاتی در مورد آداپتور بلوتوث دریافت کنید.

مولفه های

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (adapterInfo: AdapterState)=>void

    • adapterInfo

      AdapterState

      شی حاوی اطلاعات آداپتور.

برمی گرداند

  • Promise< AdapterState >

    Chrome 91+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

getDevice()

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

اطلاعاتی در مورد یک دستگاه بلوتوث شناخته شده برای سیستم دریافت کنید.

مولفه های

  • آدرس دستگاه

    رشته

    آدرس دستگاه برای دریافت.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (deviceInfo: Device)=>void

    • اطلاعات دستگاه

      دستگاه

      شی حاوی اطلاعات دستگاه

برمی گرداند

  • وعده< دستگاه >

    Chrome 91+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

getDevices()

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

فهرستی از دستگاه های بلوتوث شناخته شده برای سیستم، از جمله دستگاه های جفت شده و اخیراً کشف شده را دریافت کنید.

مولفه های

  • فیلتر

    فیلتر بلوتوث اختیاری است

    Chrome 67+

    برخی معیارها برای فیلتر کردن لیست دستگاه های بلوتوث برگشتی. اگر فیلتر تنظیم نشده باشد یا روی {} تنظیم نشده باشد، لیست دستگاه های برگشتی شامل همه دستگاه های بلوتوث خواهد بود. در حال حاضر این فقط در ChromeOS پشتیبانی می شود، برای سایر سیستم عامل ها، یک لیست کامل برگردانده می شود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (deviceInfos: Device[])=>void

    • اطلاعات دستگاه

      دستگاه []

      آرایه ای از شی حاوی اطلاعات دستگاه.

برمی گرداند

  • Promise< دستگاه []>

    Chrome 91+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

startDiscovery()

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

شروع به کشف دستگاه های تازه کشف شده از طریق رویداد onDeviceAdded بازگردانده می شوند. دستگاه‌هایی که قبلاً کشف شده‌اند، قبلاً برای آداپتور شناخته شده‌اند، باید با استفاده از getDevices دریافت شوند و تنها در صورت تغییر اطلاعات مربوط به آنها، با استفاده از رویداد onDeviceChanged به‌روزرسانی می‌شوند.

اگر این برنامه قبلاً startDiscovery را نامیده باشد، Discovery شروع نمی شود. Discovery می‌تواند منابع فشرده باشد: stopDiscovery باید در اسرع وقت فراخوانی شود.

مولفه های

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 91+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

stopDiscovery()

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

کشف را متوقف کنید.

مولفه های

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 91+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

مناسبت ها

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