chrome.bluetooth LowEnergy

توضیحات

chrome.bluetoothLowEnergy API برای برقراری ارتباط با دستگاه‌های هوشمند بلوتوث (کم انرژی) با استفاده از نمایه ویژگی عمومی (GATT) استفاده می‌شود.

آشکار

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

"bluetooth"

انواع

Advertisement

Chrome 47+

خواص

  • اطلاعات سازنده

    ManufacturerData [] اختیاری است

    فهرست داده‌های خاص سازنده که باید در فیلدهای «داده‌های خاص سازنده» داده‌های تبلیغاتی گنجانده شوند.

  • ServiceData

    ServiceData [] اختیاری است

    فهرست داده‌های خدماتی که باید در قسمت‌های «داده‌های سرویس» داده‌های تبلیغاتی گنجانده شوند.

  • serviceUuids

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

    فهرست UUID هایی که باید در قسمت "UUID های خدمات" در داده های تبلیغاتی گنجانده شوند. این UUID ها می توانند از فرمت های 16 بیتی، 32 بیتی یا 128 بیتی باشند.

  • درخواست می کند

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

    فهرست UUIDهایی که باید در قسمت "Solicit UUID" در داده های تبلیغاتی گنجانده شوند. این UUID ها می توانند از فرمت های 16 بیتی، 32 بیتی یا 128 بیتی باشند.

  • نوع آگهی.

AdvertisementType

Chrome 47+

نوع آگهی. اگر "پخش" انتخاب شود، نوع تبلیغ ارسالی ADV_NONCONN_IND خواهد بود و دستگاه با یک آدرس MAC تصادفی پخش می شود. اگر روی "پیرامونی" تنظیم شود، نوع تبلیغ ADV_IND یا ADV_SCAN_IND خواهد بود و دستگاه با آدرس MAC آداپتور بلوتوث واقعی پخش می شود.

Enum

"پخش"

"محیطی"

Characteristic

خواص

  • شناسه نمونه

    رشته اختیاری

    شناسه اختصاص داده شده به این مشخصه را برمی گرداند. از شناسه نمونه برای تمایز بین ویژگی‌ها از یک دستگاه جانبی با UUID یکسان و برای فراخوانی تابعی که یک شناسه مشخصه را دریافت می‌کند، استفاده کنید. اگر این نمونه یک مشخصه از راه دور را نشان دهد، ارائه شود.

  • خواص این ویژگی.

  • خدمات

    خدمات اختیاری

    سرویس گات این ویژگی به آن تعلق دارد.

  • uuid

    رشته

    UUID مشخصه، به عنوان مثال 00002a37-0000-1000-8000-00805f9b34fb.

  • ارزش

    ArrayBuffer اختیاری است

    مقدار مشخصه ذخیره شده فعلی. این مقدار زمانی به روز می شود که مقدار مشخصه از طریق یک اعلان یا نشانه خوانده یا به روز شود.

CharacteristicProperty

مقادیری که خصوصیات احتمالی یک مشخصه را نشان می دهند. مجوزهای مشخصه از این ویژگی ها استنباط می شود. لطفاً مشخصات بلوتوث 4.x را ببینید تا معنای هر ویژگی را ببینید.

Enum

"پخش"

"خواندن"

"نوشتن بدون پاسخ"

"نوشتن"

"اطلاع رسانی"

"نشان دادن"

"authenticatedSignedWrites"

"extendedProperties"

"ReliableWrite"

"کمک های قابل نوشتن"

"رمزگذاری خواندن"

"رمزگذاری نوشتن"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

خواص

  • مداوم

    بولی

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

Descriptor

خواص

  • مشخصه

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

    ویژگی GATT این توصیفگر به آن تعلق دارد.

  • شناسه نمونه

    رشته اختیاری

    شناسه اختصاص داده شده به این توصیفگر را برمی گرداند. از شناسه نمونه برای تمایز بین توصیفگرها از یک دستگاه جانبی با UUID یکسان و برای فراخوانی تابعی که شناسه توصیفگر را دریافت می کند، استفاده کنید. اگر این نمونه یک مشخصه از راه دور را نشان دهد، ارائه شود.

  • مجوزها

    DescriptorPermission []

    Chrome 52+

    مجوزهای این توصیفگر

  • uuid

    رشته

    UUID توصیفگر مشخصه، به عنوان مثال 00002902-0000-1000-8000-00805f9b34fb.

  • ارزش

    ArrayBuffer اختیاری است

    مقدار توصیفگر ذخیره شده فعلی. این مقدار با خوانده شدن مقدار توصیفگر به روز می شود.

DescriptorPermission

Chrome 52+

مقادیری که مجوزهای ممکن را برای یک توصیفگر نشان می دهند. لطفاً مشخصات بلوتوث 4.x را ببینید تا معنای هر مجوز جداگانه را ببینید.

Enum

"خواندن"

"نوشتن"

"رمزگذاری شده خواندن"

"رمزگذاری شده رایت"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52+

خواص

  • آدرس

    رشته

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

  • دستگاه کلاس

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

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

  • نام

    رشته اختیاری

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

ManufacturerData

Chrome 47+

خواص

  • داده ها

    شماره[]

  • شناسه

    شماره

Notification

Chrome 52+

خواص

  • باید نشان دهد

    بولی اختیاری

    پرچم اختیاری برای ارسال نشانه به جای اعلان.

  • ارزش

    ArrayBuffer

    ارزش جدید مشخصه

NotificationProperties

خواص

  • مداوم

    بولی

    پرچم‌گذاری نشان می‌دهد که آیا برنامه هنگام بارگیری صفحه رویداد برنامه باید اعلان‌ها را دریافت کند (به مدیریت چرخه عمر برنامه مراجعه کنید). مقدار پیش فرض false است.

Request

Chrome 52+

خواص

  • دستگاه

    دستگاه

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

  • درخواست شناسه

    شماره

    شناسه منحصر به فرد برای این درخواست. هنگام پاسخ دادن به این درخواست از این شناسه استفاده کنید.

  • ارزش

    ArrayBuffer اختیاری است

    مقدار برای نوشتن (اگر این درخواست نوشتن است).

Response

Chrome 52+

خواص

  • isError

    بولی

    اگر این یک پاسخ خطا است، این باید درست باشد.

  • درخواست شناسه

    شماره

    شناسه درخواست این یک پاسخ است.

  • ارزش

    ArrayBuffer اختیاری است

    ارزش پاسخگویی درخواست های نوشتن و پاسخ های خطا این پارامتر را نادیده می گیرند.

Service

خواص

  • آدرس دستگاه

    رشته اختیاری

    آدرس دستگاه دستگاه جانبی راه دور که سرویس گات به آن تعلق دارد. اگر این نمونه نشان دهنده یک سرویس راه دور باشد، ارائه شود.

  • شناسه نمونه

    رشته اختیاری

    شناسه اختصاص داده شده به این سرویس را برمی گرداند. از شناسه نمونه برای تمایز بین سرویس‌ها از یک دستگاه جانبی با همان UUID و برقراری فراخوانی تابعی که شناسه سرویس را دریافت می‌کند، استفاده کنید. اگر این نمونه نشان دهنده یک سرویس راه دور باشد، ارائه شود.

  • اولیه است

    بولی

    نشان می دهد که نوع این سرویس اولیه یا ثانویه است.

  • uuid

    رشته

    UUID سرویس، به عنوان مثال 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47+

خواص

  • داده ها

    شماره[]

  • uuid

    رشته

روش ها

connect()

قول بده
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

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

پارامترها

  • آدرس دستگاه

    رشته

    آدرس بلوتوث دستگاه راه دور که باید اتصال GATT به آن باز شود.

  • خواص

    ConnectProperties اختیاری است

    ویژگی های اتصال (اختیاری).

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

createCharacteristic()

Promise Chrome 52+
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

یک مشخصه گات میزبان محلی ایجاد کنید. این ویژگی باید تحت یک سرویس معتبر میزبانی شود. اگر شناسه سرویس معتبر نباشد، lastError تنظیم می شود. این عملکرد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • مشخصه

    مشخصه

    ویژگی برای ایجاد.

  • شناسه سرویس

    رشته

    شناسه سرویس برای ایجاد این مشخصه.

  • پاسخ به تماس

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

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

    (characteristicId: string) => void

    • شناسه مشخصه

      رشته

برمی گرداند

  • قول<رشته>

    Chrome 91+

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

createDescriptor()

Promise Chrome 52+
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

یک توصیفگر گات با میزبانی محلی ایجاد کنید. این توصیفگر باید تحت یک مشخصه معتبر میزبانی شود. اگر شناسه مشخصه معتبر نباشد، lastError تنظیم می شود. این عملکرد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • توصیف کننده

    توصیفگر

    توصیف کننده برای ایجاد.

  • شناسه مشخصه

    رشته

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

  • پاسخ به تماس

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

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

    (descriptorId: string) => void

    • شناسه توصیفی

      رشته

برمی گرداند

  • قول<رشته>

    Chrome 91+

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

createService()

Promise Chrome 52+
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

یک سرویس GATT با میزبانی محلی ایجاد کنید. این سرویس می تواند ثبت شود تا در سرور محلی گات در دسترس باشد. این عملکرد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • خدمات

    خدمات

    سرویس برای ایجاد.

  • پاسخ به تماس

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

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

    (serviceId: string) => void

    • شناسه سرویس

      رشته

برمی گرداند

  • قول<رشته>

    Chrome 91+

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

disconnect()

قول بده
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

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

پارامترها

  • آدرس دستگاه

    رشته

    آدرس بلوتوث دستگاه راه دور.

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

getCharacteristic()

قول بده
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

در صورت وجود مشخصه، مشخصه GATT را با شناسه نمونه داده شده که به سرویس داده شده GATT تعلق دارد، دریافت کنید.

پارامترها

  • شناسه مشخصه

    رشته

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

  • پاسخ به تماس

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

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

    (result: Characteristic) => void

برمی گرداند

  • قول< مشخصه >

    Chrome 91+

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

getCharacteristics()

قول بده
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

فهرستی از تمام ویژگی های کشف شده GATT که متعلق به سرویس داده شده است را دریافت کنید.

پارامترها

  • شناسه سرویس

    رشته

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

  • پاسخ به تماس

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

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

    (result: Characteristic[]) => void

برمی گرداند

  • وعده< مشخصه []>

    Chrome 91+

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

getDescriptor()

قول بده
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

توصیفگر مشخصه GATT را با شناسه نمونه داده شده دریافت کنید.

پارامترها

  • شناسه توصیفی

    رشته

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

  • پاسخ به تماس

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

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

    (result: Descriptor) => void

برمی گرداند

  • وعده< توصیفگر >

    Chrome 91+

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

getDescriptors()

قول بده
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

فهرستی از توصیفگرهای مشخصه GATT که به مشخصه داده شده تعلق دارند را دریافت کنید.

پارامترها

  • شناسه مشخصه

    رشته

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

  • پاسخ به تماس

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

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

    (result: Descriptor[]) => void

برمی گرداند

  • وعده< توصیفگر []>

    Chrome 91+

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

getIncludedServices()

قول بده
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

لیستی از خدمات GATT را که توسط این سرویس ارائه شده است دریافت کنید.

پارامترها

  • شناسه سرویس

    رشته

    شناسه نمونه سرویس GATT که خدمات شامل آن باید بازگردانده شود.

  • پاسخ به تماس

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

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

    (result: Service[]) => void

برمی گرداند

  • Promise< سرویس []>

    Chrome 91+

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

getService()

قول بده
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

سرویس GATT را با شناسه نمونه داده شده دریافت کنید.

پارامترها

  • شناسه سرویس

    رشته

    شناسه نمونه سرویس GATT درخواستی.

  • پاسخ به تماس

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

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

    (result: Service) => void

برمی گرداند

  • وعده< سرویس >

    Chrome 91+

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

getServices()

قول بده
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

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

توجه: اگر کشف سرویس هنوز در دستگاه کامل نشده باشد، این API یک زیرمجموعه (احتمالاً خالی) از سرویس‌ها را برمی‌گرداند. راه حل این است که یک تأخیر مبتنی بر زمان اضافه کنید و/یا تماس مکرر تا زمانی که تعداد مورد انتظار خدمات بازگردانده شود.

پارامترها

  • آدرس دستگاه

    رشته

    آدرس بلوتوث دستگاه راه دوری که خدمات GATT آن باید برگردانده شود.

  • پاسخ به تماس

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

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

    (result: Service[]) => void

برمی گرداند

  • Promise< سرویس []>

    Chrome 91+

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

notifyCharacteristicValueChanged()

Promise Chrome 52+
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

یک دستگاه راه دور را از یک مقدار جدید برای یک مشخصه مطلع کنید. اگر پرچم shouldIndicate در شیء اعلان درست باشد، به جای اعلان یک نشانه ارسال می شود. توجه داشته باشید، مشخصه باید در حین ایجاد، ویژگی "notify" یا "indicate" را به درستی تنظیم کند تا این فراخوانی موفق شود. این عملکرد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • شناسه مشخصه

    رشته

    ویژگی برای ارسال اعلان.

  • اطلاع رسانی

    اطلاع رسانی

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

readCharacteristicValue()

قول بده
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

مقدار یک مشخصه مشخص شده را از یک دستگاه جانبی راه دور بازیابی کنید.

پارامترها

  • شناسه مشخصه

    رشته

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

  • پاسخ به تماس

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

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

    (result: Characteristic) => void

برمی گرداند

  • قول< مشخصه >

    Chrome 91+

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

readDescriptorValue()

قول بده
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

مقدار یک توصیفگر مشخصه مشخص شده را از یک دستگاه جانبی راه دور بازیابی کنید.

پارامترها

  • شناسه توصیفی

    رشته

    شناسه نمونه توصیفگر مشخصه GATT که مقدار آن باید از دستگاه راه دور خوانده شود.

  • پاسخ به تماس

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

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

    (result: Descriptor) => void

برمی گرداند

  • وعده< توصیفگر >

    Chrome 91+

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

registerAdvertisement()

Promise Chrome 47+
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

یک آگهی ایجاد کنید و آن را برای تبلیغات ثبت کنید. برای فراخوانی این تابع، برنامه باید مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. علاوه بر این، این API فقط برای برنامه‌های راه‌اندازی خودکار در حالت کیوسک یا با تنظیم سوئیچ خط فرمان «--enable-ble-advertising-in-apps» در دسترس است. به https://developer.chrome.com/apps/manifest/bluetooth توجه کنید: در برخی از سخت‌افزارها، حالت‌های مرکزی و جانبی به طور همزمان پشتیبانی می‌شوند، اما در سخت‌افزارهایی که از این پشتیبانی نمی‌کنند، برقراری این تماس دستگاه را به حالت محیطی در مورد سخت افزاری که از حالت مرکزی و محیطی پشتیبانی نمی کند، تلاش برای استفاده از دستگاه در هر دو حالت منجر به رفتار نامشخص می شود یا از رفتار صحیح سایر برنامه های کاربردی نقش مرکزی جلوگیری می کند (از جمله کشف دستگاه های کم انرژی بلوتوث).

پارامترها

  • تبلیغات

    تبلیغات

    تبلیغ برای تبلیغ.

  • پاسخ به تماس

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

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

    (advertisementId: number) => void

    • شناسه تبلیغاتی

      شماره

برمی گرداند

  • قول <تعداد>

    Chrome 91+

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

registerService()

Promise Chrome 52+
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

سرویس داده شده را با سرور محلی گات ثبت کنید. اگر شناسه سرویس نامعتبر باشد، lastError تنظیم می شود. این عملکرد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • شناسه سرویس

    رشته

    شناسه منحصر به فرد یک سرویس ایجاد شده.

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

removeService()

Promise Chrome 52+
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

سرویس مشخص شده را حذف کنید، اگر ثبت شده بود، آن را لغو ثبت کنید. اگر شناسه سرویس نامعتبر باشد، lastError تنظیم می شود. این عملکرد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • شناسه سرویس

    رشته

    شناسه منحصر به فرد یک سرویس ثبت شده فعلی.

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

resetAdvertising()

Promise Chrome 61+
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

تبلیغات را در دستگاه فعلی بازنشانی می کند. همه تبلیغات موجود را لغو و متوقف می کند.

پارامترها

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

sendRequestResponse()

Chrome 52+
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

پاسخی را برای یک درخواست خواندن/نوشتن مشخصه یا توصیفگر ارسال می کند. این عملکرد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • پاسخ

    پاسخ

    پاسخ به درخواست.

setAdvertisingInterval()

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

فاصله بین دو آگهی متوالی را تنظیم کنید. توجه: این بهترین تلاش است. فاصله واقعی ممکن است به طور غیر ضروری با فواصل درخواستی متفاوت باشد. در برخی از سخت افزارها، حداقل فاصله 100 میلی ثانیه وجود دارد. مقادیر حداقل و حداکثر نمی توانند از محدوده مجاز توسط مشخصات بلوتوث 4.2 تجاوز کنند.

پارامترها

  • من فاصله

    شماره

    حداقل فاصله بین تبلیغات (بر حسب میلی ثانیه). این نمی تواند کمتر از 20 میلی ثانیه باشد (طبق مشخصات).

  • maxInterval

    شماره

    حداکثر فاصله بین تبلیغات (بر حسب میلی ثانیه). این نمی تواند بیشتر از 10240 میلی ثانیه باشد (طبق مشخصات).

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

startCharacteristicNotifications()

قول بده
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

اعلان‌ها/نشان‌های مقدار را از مشخصه مشخص‌شده فعال کنید. پس از فعال شدن، برنامه می تواند با استفاده از رویداد onCharacteristicValueChanged به اعلان ها گوش دهد.

پارامترها

  • شناسه مشخصه

    رشته

    شناسه نمونه مشخصه GATT که اعلان‌ها باید در آن فعال شوند.

  • خواص

    NotificationProperties اختیاری است

    ویژگی های جلسه اعلان (اختیاری).

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

stopCharacteristicNotifications()

قول بده
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

اعلان‌ها/نشان‌های مقدار را از مشخصه مشخص شده غیرفعال کنید. پس از یک تماس موفق، برنامه دریافت اعلان‌ها/نشانه‌های مربوط به این مشخصه را متوقف می‌کند.

پارامترها

  • شناسه مشخصه

    رشته

    شناسه نمونه مشخصه GATT که جلسه اعلان این برنامه باید روی آن متوقف شود.

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

unregisterAdvertisement()

Promise Chrome 47+
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

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

پارامترها

  • شناسه تبلیغاتی

    شماره

    شناسه آگهی برای لغو ثبت نام

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

unregisterService()

Promise Chrome 52+
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

سرویس داده شده را با سرور محلی گات لغو ثبت کنید. اگر شناسه سرویس نامعتبر باشد، lastError تنظیم می شود. این عملکرد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • شناسه سرویس

    رشته

    شناسه منحصر به فرد یک سرویس ثبت شده فعلی.

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

writeCharacteristicValue()

قول بده
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

مقدار یک مشخصه مشخص شده را از یک دستگاه جانبی راه دور بنویسید.

پارامترها

  • شناسه مشخصه

    رشته

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

  • ارزش

    ArrayBuffer

    مقداری که باید به عنوان بخشی از درخواست نوشتن به مشخصه راه دور ارسال شود.

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

writeDescriptorValue()

قول بده
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

مقدار یک توصیفگر مشخصه مشخص شده را از یک دستگاه جانبی راه دور بنویسید.

پارامترها

  • شناسه توصیفی

    رشته

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

  • ارزش

    ArrayBuffer

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

  • پاسخ به تماس

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

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

    () => void

برمی گرداند

  • قول<باطل>

    Chrome 91+

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

رویدادها

onCharacteristicReadRequest

Chrome 52+
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

زمانی فعال می شود که یک دستگاه مرکزی متصل درخواست خواندن مقدار مشخصه ثبت شده در سرور محلی GATT را داشته باشد. پاسخ ندادن به این درخواست برای مدت طولانی ممکن است منجر به قطع ارتباط شود. این رویداد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • پاسخ به تماس

    تابع

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

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

onCharacteristicValueChanged

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

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

پارامترها

  • پاسخ به تماس

    تابع

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

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52+
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

زمانی فعال می شود که یک دستگاه مرکزی متصل درخواست نوشتن مقدار یک مشخصه ثبت شده در سرور محلی GATT را داشته باشد. پاسخ ندادن به این درخواست برای مدت طولانی ممکن است منجر به قطع ارتباط شود. این رویداد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • پاسخ به تماس

    تابع

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

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

onDescriptorReadRequest

Chrome 52+
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

زمانی فعال می شود که یک دستگاه مرکزی متصل درخواست خواندن مقدار یک توصیفگر ثبت شده در سرور محلی GATT را داشته باشد. پاسخ ندادن به این درخواست برای مدت طولانی ممکن است منجر به قطع ارتباط شود. این رویداد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • پاسخ به تماس

    تابع

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

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

onDescriptorValueChanged

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

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

پارامترها

  • پاسخ به تماس

    تابع

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52+
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

زمانی فعال می شود که یک دستگاه مرکزی متصل درخواست می کند که مقدار یک توصیفگر ثبت شده در سرور محلی GATT را بنویسد. پاسخ ندادن به این درخواست برای مدت طولانی ممکن است منجر به قطع ارتباط شود. این رویداد فقط در صورتی در دسترس است که برنامه مجوزهای bluetooth:low_energy و bluetooth:periferal را روی true تنظیم کرده باشد. ممکن است مجوز جانبی برای همه برنامه‌ها در دسترس نباشد.

پارامترها

  • پاسخ به تماس

    تابع

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

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

onServiceAdded

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

هنگامی که یک سرویس جدید گات در یک دستگاه راه دور کشف شد، فعال شد.

پارامترها

  • پاسخ به تماس

    تابع

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

    (service: Service) => void

onServiceChanged

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

هنگامی که وضعیت سرویس گات از راه دور تغییر می کند فعال می شود. این شامل هر ویژگی و/یا توصیفگرهایی است که به سرویس اضافه یا حذف می‌شوند، و همچنین اعلان‌های «ServiceChanged» از دستگاه راه دور.

پارامترها

  • پاسخ به تماس

    تابع

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

    (service: Service) => void

onServiceRemoved

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

زمانی فعال می شود که یک سرویس GATT که قبلاً در یک دستگاه راه دور کشف شده بود حذف شد.

پارامترها

  • پاسخ به تماس

    تابع

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

    (service: Service) => void