Espruino:Справочник по API/Класс BluetoothRemoteGATTServer/connect(): различия между версиями
Myagkij (обсуждение | вклад) (Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= ==Синтакс...») |
Myagkij (обсуждение | вклад) Нет описания правки |
||
Строка 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.
См.также
Внешние ссылки