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

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[https://www.espruino.com/Reference#l_Puck_mag www.espruino.com - Puck.mag()]</ref>=
=Функция Puck.mag()<ref>[https://www.espruino.com/Reference#l_Puck_mag www.espruino.com - Puck.mag()]</ref>=


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


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript" enclose="div">
 
Puck.mag()
</syntaxhighlight>
</syntaxhighlight>


Строка 17: Строка 17:
==Возвращаемое значение==
==Возвращаемое значение==


Объект в формате {x,y,z} с данными магнетометра (в виде целых чисел).
==Описание==
Включает магнетометр, один раз считывает данные и выключает его.


Также возвращает объект в формате {x,y,z}, содержащий считанные данные магнетометра. Из-за остаточного магнетизма в Puck.js и самом магнетометре в отсутствие магнитного поля Puck.js не вернет {x:0,y:0,z:0}.


==Описание==
Вы сами должны определить «нулевое» значение для своего Puck.js в месте, где вы живете, а затем вычитать его из возвращаемого значения. Если вы не пытаетесь измерить магнитное поле Земли, рекомендуем придерживаться данных от самого первого считывания.
 
Если Puck.js размещен антенной кверху, в поле '''y''' будет значение по вертикали, в поле '''x''' – по горизонтали, а в поле '''z''' – поперек устройства.


Один шаг считываемого значения составляет 0.1 мкТл (микротесла). Магнитное поле Земли варьируется от 25 до 60 мкТл, так что данные, считанные Puck.mag(), будут варьироваться от 250 до 600 мкТл в зависимости от того, где вы находитесь.


'''Примечание:''' Эта функция доступна только для устройств Puck.js.


== Примеры ==
== Примеры ==


 
Эта функция используется в следующих статьях документации [[Espruino]]:
* [https://www.espruino.com/Vec3#line=2,5,10 Библиотека Vec3 для векторов с 3 координатами]
* [https://www.espruino.com/Pixl.js+Simple+Logger#line=81,94,95 Дисплейное регистрирующее устройство при помощи Pixl.js]
* [https://www.espruino.com/Puck.js+Door+Light#line=1,14,15,24,42,43 Освещение, реагирующее на открывание/закрывание двери, с помощью Puck.js]


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

Версия от 22:01, 24 февраля 2021

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


Функция Puck.mag()[1]

Синтаксис

Puck.mag()

Параметры

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

Объект в формате {x,y,z} с данными магнетометра (в виде целых чисел).

Описание

Включает магнетометр, один раз считывает данные и выключает его.

Также возвращает объект в формате {x,y,z}, содержащий считанные данные магнетометра. Из-за остаточного магнетизма в Puck.js и самом магнетометре в отсутствие магнитного поля Puck.js не вернет {x:0,y:0,z:0}.

Вы сами должны определить «нулевое» значение для своего Puck.js в месте, где вы живете, а затем вычитать его из возвращаемого значения. Если вы не пытаетесь измерить магнитное поле Земли, рекомендуем придерживаться данных от самого первого считывания.

Если Puck.js размещен антенной кверху, в поле y будет значение по вертикали, в поле x – по горизонтали, а в поле z – поперек устройства.

Один шаг считываемого значения составляет 0.1 мкТл (микротесла). Магнитное поле Земли варьируется от 25 до 60 мкТл, так что данные, считанные Puck.mag(), будут варьироваться от 250 до 600 мкТл в зависимости от того, где вы находитесь.

Примечание: Эта функция доступна только для устройств Puck.js.

Примеры

Эта функция используется в следующих статьях документации Espruino:

См.также

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