Espruino:Примеры/Маяки iBeacon: различия между версиями

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


=<ref>[ www.espruino.com - ]</ref>=
=Маяки iBeacon<ref>[https://www.espruino.com/iBeacon www.espruino.com - iBeacons]</ref>=


{{Примечание1|Если вы используете маяки [[Eddystone]], то вам нужна [https://www.espruino.com/Eddystone эта статья].}}


<syntaxhighlight lang="html5" enclose="div">
[https://ru.wikipedia.org/wiki/IBeacon iBeacon] – это формат маяков от [[Apple]] для передачи информации, показываемой в виде уведомлений на [[iPhone]] пользователя.
 
Для этого всего лишь нужно воспользоваться [https://www.espruino.com/modules/ble_ibeacon.js модулем «ble_ibeacon»] (более подробно о модулях читайте [https://www.espruino.com/Modules тут]):
 
<syntaxhighlight lang="javascript">
require("ble_ibeacon").advertise({
  // UUID группы iBeacon-маяков:
  uuid : [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
  major : 0x0001, // опционально
  minor : 0x0001, // опционально
  rssi : -59      // опциональная RSSI на 1-метровой дистанции (в дБ)
});
</syntaxhighlight>
 
{{Примечание1|Чтобы воспользоваться этой функцией, вам понадобится [[UUID]] группы [[iBeacon-маяк]]ов от [[Apple]].}}
 
С этого момента [[Espruino]] начнёт транслировать данные всем прослушивающим устройствам, находящимся вокруг.
 
{{Примечание1|Вы не можете рассылать [[BLE-объявления]], когда подключены через [[Bluetooth]], поэтому вам сначала нужно будет отключиться от [[Espruino]], чтобы начать передачу данных.}}
 
Чтобы выключить рассылку [[iBeacon-данных]], просто вызовите '''NRF.setAdvertising({});'''.
 
== Продвинутое использование ==
 
{{Инфо1|Функция require("ble_ibeacon").advertise заменяет данные, рассылаемые [[Espruino]] (название, сервисы и т.д.), на [[iBeacon]]-пакет.}}
 
При помощи функции '''require("ble_ibeacon").get''' (в которой заданы те же настройки, что и в '''advertise'''), можно прочесть массив рассылаемых данных. Затем их можно напрямую ''«скормить»'' функции NRF.setAdvertising(), которая позволяет вам задать и другие настройки (вроде частоты рассылки данных).
 
Кроме того, в [[Espruino]] 1v92 и новее можно задать массив рассылаемых данных, чтобы [[Espruino]] отправляла каждый пакет по отдельности.
 
Данные [[iBeacon]] и стандартная информация подключения [[Espruino]]:
 
<syntaxhighlight lang="javascript">
NRF.setAdvertising([
require("ble_ibeacon").get(...),
{} // это добавит «стандартный» пакет объявления,
    // показывающий название и так далее:
], {interval:100});
</syntaxhighlight>
 
Данные [[iBeacon]], [[Eddystone]] и информация об уровне заряда батареи:
 
<syntaxhighlight lang="javascript">
NRF.setAdvertising([
  require("ble_ibeacon").get(...),
  require("ble_eddystone").get(...),
  { 0x180F : [95] }
  ], {interval:100});
</syntaxhighlight>


=См.также=
=См.также=
{{ads}}


=Внешние ссылки=
=Внешние ссылки=
Строка 16: Строка 63:
<references />
<references />


{{Навигационная таблица/Espruino}}
{{Навигационная таблица/Портал/Espruino}}
{{Навигационная таблица/Телепорт}}

Текущая версия от 19:02, 27 мая 2023

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


Маяки iBeacon[1]

Примечание

Если вы используете маяки Eddystone, то вам нужна эта статья.

iBeacon – это формат маяков от Apple для передачи информации, показываемой в виде уведомлений на iPhone пользователя.

Для этого всего лишь нужно воспользоваться модулем «ble_ibeacon» (более подробно о модулях читайте тут):

require("ble_ibeacon").advertise({
  // UUID группы iBeacon-маяков:
  uuid : [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
  major : 0x0001, // опционально
  minor : 0x0001, // опционально
  rssi : -59      // опциональная RSSI на 1-метровой дистанции (в дБ) 
});
Примечание

Чтобы воспользоваться этой функцией, вам понадобится UUID группы iBeacon-маяков от Apple.

С этого момента Espruino начнёт транслировать данные всем прослушивающим устройствам, находящимся вокруг.

Примечание

Вы не можете рассылать BLE-объявления, когда подключены через Bluetooth, поэтому вам сначала нужно будет отключиться от Espruino, чтобы начать передачу данных.

Чтобы выключить рассылку iBeacon-данных, просто вызовите NRF.setAdvertising({});.

Продвинутое использование

Для информации

Функция require("ble_ibeacon").advertise заменяет данные, рассылаемые Espruino (название, сервисы и т.д.), на iBeacon-пакет.

При помощи функции require("ble_ibeacon").get (в которой заданы те же настройки, что и в advertise), можно прочесть массив рассылаемых данных. Затем их можно напрямую «скормить» функции NRF.setAdvertising(), которая позволяет вам задать и другие настройки (вроде частоты рассылки данных).

Кроме того, в Espruino 1v92 и новее можно задать массив рассылаемых данных, чтобы Espruino отправляла каждый пакет по отдельности.

Данные iBeacon и стандартная информация подключения Espruino:

NRF.setAdvertising([
 require("ble_ibeacon").get(...),
 {} // это добавит «стандартный» пакет объявления,
    // показывающий название и так далее: 
 ], {interval:100});

Данные iBeacon, Eddystone и информация об уровне заряда батареи:

NRF.setAdvertising([
  require("ble_ibeacon").get(...),
  require("ble_eddystone").get(...),
  { 0x180F : [95] }
  ], {interval:100});

См.также

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