VKWebAppAccelerometerStart
VKWebAppAccelerometerStart включает отслеживание и приём данных акселерометра, установленного на мобильном устройстве.
Схема работы
- 1.Клиент вызывает
VKWebAppAccelerometerStartдля начала получения данных акселерометра. - 2.Платформа отвечает:
- •Событием
VKWebAppAccelerometerStartResultв случае успешного выполнения. - •Событием
VKWebAppAccelerometerStartFailedв случае ошибки доступа к датчику.
- •
- 3.Если на предыдущем шаге не было ошибки, платформа начинает отправлять поток событий
VKWebAppAccelerometerChangedс данными акселерометра. - 4.На iOS поток событий с данными акселерометра может быть прерван. В этом случае платформа отправляет событие
VKWebAppAccelerometerInterrupted. - 5.Чтобы возобновить получение данных акселерометра, снова вызовите
VKWebAppAccelerometerStart.
Чтобы прекратить отслеживание данных, вызовите VKWebAppAccelerometerStop.
Пример
bridge.send('VKWebAppAccelerometerStart', {
refresh_rate: 500
})
.then((data) => {
if (data.result) {
// Отслеживание данных акселерометра включено
}
})
.catch((error) => {
// Ошибка
console.log(error);
});
Платформы
Android, iOS
Параметры
Поле | Тип | Описание |
|---|---|---|
refresh_rate
необязательное | integer | Период обновления данных акселерометра в миллисекундах. Минимальное значение: 20. Максимальное значение: 1000. Значение по умолчанию: 1000. |
Результат
Проверить результат можно:
- •
Используя объект
Promise, который возвращается вызовомbridge.send(...). - •
С помощью событий:
- •
- •
Подробнее о проверке результатов при вызовах VK Bridge — в разделе Обработка результата.
Объект Promise
Если обращение к платформе прошло успешно, управление будет передано в then-обработчик объекта Promise.
Если при обращении к платформе произошла ошибка, управление передаётся в метод catch. В качестве ответа платформа возвращает объект с информацией об ошибке, общий для всех событий VK Bridge.
События
VKWebAppAccelerometerStartResult
Сигнализирует, что отслеживание данных акселерометра включено и мини-приложение может получать данные. В обработчик события на стороне пользователя передаются данные:
{
detail: {
type: "VKWebAppAccelerometerStartResult",
data: {
result: true
}
}
}
В качестве ответа платформа возвращает объект:
Поле | Тип | Описание |
|---|---|---|
result | boolean | true, если отслеживание данных акселерометра включено. |
VKWebAppAccelerometerStartFailed
Информирует, что при взаимодействии с платформой произошла ошибка или что мини-приложение не может получить данные акселерометра.
В обработчик события на стороне пользователя передаётся объект с информацией об ошибке, общий для всех методов VK Bridge.
Отслеживание данных
Чтобы получить текущее состояние акселерометра, подпишитесь на события:
- •
VKWebAppAccelerometerChanged— отслеживает координаты устройства при его перемещении. - •
VKWebAppAccelerometerInterrupted— сообщает о том, что поток данных прервался. Событие доступно только для iOS.
VKWebAppAccelerometerChanged
Сигнализирует, что получены данные акселерометра. Акселерометр измеряет проекцию кажущегося ускорения — разницу между истинным и гравитационным ускорением. Таким образом определяется положение устройства относительно осей X, Y и Z. Знак числа обозначает направление перемещения. ``
Положение устройства относительно осей X, Y, Z
В обработчик события на стороне пользователя передаются данные:
{
detail: {
type: "VKWebAppAccelerometerChanged",
data: {
x: -0.016759412,
y: 6.3302693,
z: 7.704541
}
}
}
В качестве ответа платформа возвращает объект с полями:
Поле | Тип | Описание |
|---|---|---|
x | float | Проекция кажущегося ускорения на ось X в м/c². |
y | float | Проекция кажущегося ускорения на ось Y в м/c². |
z | float | Проекция кажущегося ускорения на ось Z в м/c². |
VKWebAppAccelerometerInterrupted
Указывает на то, что поток событий VKWebAppAccelerometerChanged прерван и данные акселерометра больше не могут быть получены. Событие доступно только для iOS.
В обработчик события на стороне пользователя передаются данные:
{
detail: {
type: "VKWebAppAccelerometerInterrupted",
data: {
"message": "Received empty accelerometer data"
}
}
}
Чтобы продолжить отслеживание данных акселерометра, снова вызовите событие VKWebAppAccelerometerStart.
