Документация
Поездки, карта и обмен
Как пишется история, что показывают графики, и как отдать данные наружу.
Пока колесо подключено и вы едете, приложение пишет поездку в память телефона. Никуда наружу эти данные не уходят.
История поездок#
В истории лежит список поездок с датой, дистанцией и основными итогами. Внутри поездки можно открыть график любого записанного показателя.
- График приближается двумя пальцами, точка увеличения там, где пальцы.
- Приближённый участок двигается двумя пальцами по горизонтали.
- Несколько поездок можно выделить и удалить сразу.
Запись трека и карта#
Если включить запись маршрута, приложение будет писать положение по спутникам во время активной поездки. Потом маршрут можно посмотреть на карте.
Карта не просто рисует линию: нажатие на точку маршрута показывает всю телеметрию именно в этой точке. Так можно посмотреть, с какой скоростью и на каком ШИМ вы проходили конкретный подъём. Приложение также считает профиль высот по треку.
Запись маршрута требует разрешения на точную геопозицию. Без разрешения остальные функции работают как обычно, только трека не будет.
Карточка поездки#
Из любой поездки можно сделать картинку и отправить друзьям. На карточке маршрут, дата, дистанция, время в пути, максимальная и средняя скорость, максимальный ШИМ и расход батареи.
Настраивается многое: тема, акцентный цвет, цвет трека по значению выбранного показателя и набор плиток. Нажатие на плитку меняет её на другой показатель этой же поездки.
Сколько всё это занимает#
Подробность записи вы задаёте сами.
- Частота записи: каждый кадр или каждый второй, третий и так далее. Приложение сразу показывает, сколько это примерно даст снимков и мегабайт за час поездки.
- Срок хранения: новая поездка вытесняет поездки старше выбранного срока. Пока новых поездок нет, история не трогается.
Кадры, в которых поставлен новый рекорд поездки по скорости, ШИМ или току, записываются всегда, независимо от выбранной частоты. Иначе разрежённая запись съедала бы именно те моменты, ради которых её и смотрят.
Выгрузка и загрузка#
- Все поездки, телеметрия и точки маршрута выгружаются в один файл таблицы и загружаются обратно. Так переносят историю на новый телефон или между Android и iPhone.
- Загрузка не создаёт дубликатов: поездки и записи сверяются по устойчивым ключам.
- Трек отдельной поездки выгружается в формат GPX, который понимают сторонние карты и спортивные программы.
Плеер записей#
Приложение умеет записывать сырой обмен с колесом и потом проигрывать эту запись как живую поездку, с перемоткой и ускорением. Экран приборов, графики и предупреждения при этом ведут себя ровно так же, как с настоящим колесом, а в базу поездок ничего не пишется.
Это главный инструмент, когда нужно разобраться в поведении колеса или добавить поддержку новой модели: запись можно прислать мне, и я увижу ровно то, что видело ваше приложение.