Espruino:Справочник по API/Класс Puck/magOn(): различия между версиями
Myagkij (обсуждение | вклад) Нет описания правки |
Нет описания правки |
||
Строка 7: | Строка 7: | ||
==Синтаксис== | ==Синтаксис== | ||
<syntaxhighlight lang="javascript | <syntaxhighlight lang="javascript"> | ||
Puck.magOn(samplerate) | Puck.magOn(samplerate) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Строка 23: | Строка 23: | ||
Включает магнетометр и запускает периодическое считывание данных с него. Каждое считывание данных будет генерировать на объекте Puck событие mag. | Включает магнетометр и запускает периодическое считывание данных с него. Каждое считывание данных будет генерировать на объекте Puck событие mag. | ||
<syntaxhighlight lang="javascript | <syntaxhighlight lang="javascript"> | ||
Puck.magOn(); | Puck.magOn(); | ||
Puck.on('mag', function(xyz) { | Puck.on('mag', function(xyz) { |
Версия от 18:31, 14 мая 2023
Функция Puck.magOn()[1]
Синтаксис
Puck.magOn(samplerate)
Параметры
- samplerate – частота считывания данных (в Гц) или undefined
Возвращаемое значение
Описание
Включает магнетометр и запускает периодическое считывание данных с него. Каждое считывание данных будет генерировать на объекте Puck событие mag.
Puck.magOn();
Puck.on('mag', function(xyz) {
console.log(xyz);
// {x:..., y:..., z:...}
});
// выключаем события при помощи Puck.magOff();
Если считывание данных магнетометра уже включено, эта функция будет проигнорирована.
Если аргумент samplerate будет задан, то функция воспользуется значением, заданным в нем, а если нет, то частота считывания данных магнетометра будет выставлена на 0.63 Гц. В samplerate нужно задать одно из следующих значений (что повлияет и на энергопотребление):
- 80 Гц – 900 мкА
- 40 Гц – 550 мкА
- 20 Гц – 275 мкА
- 10 Гц – 137 мкА
- 5 Гц – 69 мкА
- 2.5 Гц – 34 мкА
- 1.25 Гц – 17 мкА
- 0.63 Гц – 8 мкА
- 0.31 Гц – 8 мкА
- 0.16 Гц – 8 мкА
- 0.08 Гц – 8 мкА
Если заряд батареи упадет слишком низко, считывание данных магнетометра может остановиться без предупреждения – даже если другие функции Puck будут по-прежнему работать нормально.
Более подробно читайте в этой статье.
Примечание: Эта функция доступна только для устройств Puck.js.
Примеры
См.также
Внешние ссылки