کروم.بلوتوث

توضیحات

از 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

"کامپیوتر"

"تلفن"

"مودم"

"صوتی"

"carAudio"

"ویدئو"

"محیطی"

"جوی استیک"

"گیم پد"

"صفحه کلید"

"موش"

"تبلت"

"keyboardMouseCombo"

FilterType
Chrome 67+

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

Enum

"همه"

"شناخته شده"

Transport
Chrome 76+

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

Enum

"نامعتبر"

"کلاسیک"

"له"

"دوگانه"

VendorIdSource

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

Enum

"بلوتوث"

"USB"

روش ها
getAdapterState()
قول بده
chrome.bluetooth.getAdapterState(
  callback?: function,
): Promise<AdapterState>

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

پارامترها
  • پاسخ به تماس

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

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

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

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

برمی گرداند

  • Promise< AdapterState >

    Chrome 91+

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

getDevice()
قول بده
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
): Promise<Device>

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

پارامترها
  • آدرس دستگاه

    رشته

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

  • پاسخ به تماس

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

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

    (deviceInfo: Device) => void

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

      دستگاه

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

برمی گرداند

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

    Chrome 91+

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

getDevices()
قول بده
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
): Promise<Device[]>

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

پارامترها
  • فیلتر کنید

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

    Chrome 67+

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

  • پاسخ به تماس

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

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

    (deviceInfos: Device[]) => void

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

      دستگاه []

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

برمی گرداند

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

    Chrome 91+

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

startDiscovery()
قول بده
chrome.bluetooth.startDiscovery(
  callback?: function,
): Promise<void>

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

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

پارامترها
  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

stopDiscovery()
قول بده
chrome.bluetooth.stopDiscovery(
  callback?: function,
): Promise<void>

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

پارامترها
  • پاسخ به تماس

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

    پارامتر 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