Espruino:Справочник по API/Класс Puck/mag()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

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


Функция 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:

См.также

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