این صفحه بخشی از اسناد پلتفرم Chrome Apps است که در سال 2020 منسوخ شد. حداقل تا ژانویه 2025 برای مشتریان Enterprise و Education در ChromeOS پشتیبانی می‌شود. درباره انتقال برنامه خود بیشتر بدانید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

chrome.bluetooth LowEnergy

شرح

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

آشکار

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

"bluetooth"

انواع

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
```
- سرویس
  سرویس