Espruino:Справочник по API/Класс Puck/mag(): различия между версиями
Myagkij (обсуждение | вклад) (Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= ==Синтакс...») |
Myagkij (обсуждение | вклад) |
||
(не показаны 4 промежуточные версии 2 участников) | |||
Строка 3: | Строка 3: | ||
{{Myagkij-редактор}} | {{Myagkij-редактор}} | ||
=<ref>[ www.espruino.com - ]</ref>= | =Функция Puck.mag()<ref>[https://www.espruino.com/Reference#l_Puck_mag www.espruino.com - Puck.mag()]</ref>= | ||
==Синтаксис== | ==Синтаксис== | ||
<syntaxhighlight lang="javascript | <syntaxhighlight lang="javascript"> | ||
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 мкТл в зависимости от того, где вы находитесь. | |||
{{Примечание1|Эта функция доступна только для устройств [[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] | |||
=См.также= | |||
=Внешние ссылки= | =Внешние ссылки= | ||
Строка 35: | Строка 48: | ||
<references /> | <references /> | ||
{{Навигационная таблица/Espruino | {{Навигационная таблица/Портал/Espruino}} | ||
Текущая версия от 22:36, 22 июня 2023
Функция 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 мкТл в зависимости от того, где вы находитесь.
Примеры
Эта функция используется в следующих статьях документации Espruino:
- Библиотека Vec3 для векторов с 3 координатами
- Дисплейное регистрирующее устройство при помощи Pixl.js
- Освещение, реагирующее на открывание/закрывание двери, с помощью Puck.js
См.также
Внешние ссылки