Espruino:Справочник по API/Класс BluetoothRemoteGATTServer/connect(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
(Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= ==Синтакс...»)
 
Нет описания правки
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[ www.espruino.com - ]</ref>=
=Функция BluetoothRemoteGATTServer.connect()<ref>[https://www.espruino.com/Reference#t_l_BluetoothRemoteGATTServer_connect www.espruino.com - function BluetoothRemoteGATTServer.connect]</ref>=


==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript" enclose="div">
 
BluetoothRemoteGATTServer.connect(options)
</syntaxhighlight>
</syntaxhighlight>


==Параметры==
==Параметры==


* '''options''' – объект (специфичный для [[Espruino]]) с настройками подключения (см. ниже)
==Возвращаемое значение==
* '''Промис (Promise)''' с состоянием ''«выполнено успешно»'' (или ''«выполнено с ошибкой»'').
==Описание==
Подключает к [[BLE-устройств]]у. Возвращает промис, где аргументом будет объект [https://www.espruino.com/Reference#BluetoothRemoteGATTServer BluetoothRemoteGATTServer].
Примеры использования смотрите в описании [https://www.espruino.com/Reference#l_NRF_requestDevice NRF.requestDevice].


Объект ''options'' – это опциональный объект со следующим содержимым:


==Возвращаемое значение==
<syntaxhighlight lang="javascript" enclose="div">
{
  minInterval // минимальный интервал соединения в миллисекундах
              // от 7.5 мс до 4 с
  maxInterval // максимальный интервал соединения в миллисекундах
              // от 7.5 мс до 4 с
}
</syntaxhighlight>


По умолчанию интервал составляет ''20-200 мс'' (или ''500-1000 мс'', если была вызвана NRF.setLowPowerConnection(true)). Во время подключения [[Espruino]] будет согласовывать с [[BLE-устройство]]м интервал, который будет использован для соединения.


Например, если задать...


==Описание==
<syntaxhighlight lang="javascript" enclose="div">
NRF.requestDevice({ filters: [{ namePrefix: 'Pixl.js' }] }).then(function(device) {
  return device.gatt.connect({minInterval:7.5, maxInterval:7.5});
}).then(function(g) {
</syntaxhighlight>


...то будет принудительно использован быстрейший интервал (если [[BLE-устройство]] по ту сторону его поддерживает).


'''Примечание:''' Эта функция доступна только для [[NRF52]]-устройств (вроде [[Puck.js]], [[Pixl.js]], [[Bangle.js]] и [[MDBT42Q]]) и плат [[ESP32]].


=См.также=
=См.также=

Версия от 18:44, 5 декабря 2020

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Функция BluetoothRemoteGATTServer.connect()[1]

Синтаксис

BluetoothRemoteGATTServer.connect(options)

Параметры

  • options – объект (специфичный для Espruino) с настройками подключения (см. ниже)

Возвращаемое значение

  • Промис (Promise) с состоянием «выполнено успешно» (или «выполнено с ошибкой»).

Описание

Подключает к BLE-устройству. Возвращает промис, где аргументом будет объект BluetoothRemoteGATTServer.

Примеры использования смотрите в описании NRF.requestDevice.

Объект options – это опциональный объект со следующим содержимым:

{
   minInterval // минимальный интервал соединения в миллисекундах
               // от 7.5 мс до 4 с
   maxInterval // максимальный интервал соединения в миллисекундах 
               // от 7.5 мс до 4 с
}

По умолчанию интервал составляет 20-200 мс (или 500-1000 мс, если была вызвана NRF.setLowPowerConnection(true)). Во время подключения Espruino будет согласовывать с BLE-устройством интервал, который будет использован для соединения.

Например, если задать...

NRF.requestDevice({ filters: [{ namePrefix: 'Pixl.js' }] }).then(function(device) {
  return device.gatt.connect({minInterval:7.5, maxInterval:7.5});
}).then(function(g) {

...то будет принудительно использован быстрейший интервал (если BLE-устройство по ту сторону его поддерживает).

Примечание: Эта функция доступна только для NRF52-устройств (вроде Puck.js, Pixl.js, Bangle.js и MDBT42Q) и плат ESP32.

См.также

Внешние ссылки