Введение
Довольно часто, при реализации какой-либо логики в приложении, возникает потребность в срабатывании некоторой функции через определённый промежуток времени. Наиболее очевидным примером такой потребности является приложение таймера. Например, cooktimer или Saildoro.
Как было сказано в одной из предыдущих статей, для добавления таймера в приложение на Sailfish OS можно использовать стандартный элемент
Timer или его C++ аналог — QTimer. Однако, по умолчанию, работа этих таймеров приостанавливается на долгих промежутках времени из-за того, что устройство может уйти в «сон». Как раз с этой проблемой и столкнулись разработчики двух приложений, упомянутых выше.В данной статье представлен стандартный для системы, но к сожалению недокументированный способ обработки такого поведения Sailfish OS.
Начальная точка
В качестве отправной точки будет рассматриваться «абстрактное» приложение для Sailfish OS, в котором требуется срабатывание некоторого функционала через длительный промежуток времени. При этом работа таймера описывается не в коде QML, а в классе на C++:
Header
class TimerWrapper : public QObject
{
Q_OBJECT
public:
// Конструктор и деструктор
explicit TimerWrapper(QObject *parent = 0);
~TimerWrapper();
Q_INVOKABLE void start(int interval); // Метод для запуска таймера
Q_INVOKABLE void stop(); // Метод для остановки таймера
signals:
void pomodoroFinished(int start, int end); // Сигнал остановки таймера
void activeChanged(); // Сигнал смены состояния таймера
private:
QTimer *_timer; // Объект таймера
int _startTime; // Время запуска таймера
};Source
#include "timerwrapper.h"
/**
* Конструктор таймера.
*/
TimerWrapper::TimerWrapper(QObject *parent) : QObject(parent) {
_timer = new QTimer(this); // Создание объекта таймера
_timer->setSingleShot(true); // Отключение автоматического возобновления таймера
// После остановки таймера посылаются сигналы смены состояния и завершения работы
connect(_timer, &QTimer::timeout, [=]() {
emit activeChanged();
eemit pomodoroFinished(_startTime, QDateTime::currentDateTime().toMSecsSinceEpoch());
});
}
/**
* Деструктор таймера.
*/
TimerWrapper::~TimerWrapper() {
delete _timer;
_timer = nullptr;
}
/**
* Метод для начала работы таймера.
* @:param: interval - длительность работы таймера в миллисекундах
*/
void TimerWrapper::start(int interval) {
_startTime = QDateTime::currentMSecsSinceEpoch(); // Сохранение времени начала
_timer->start(interval); // Запуск таймера
emit activeChanged(); // Сигнал о смене состояния таймера
}
/**
* Метод для остановки таймера.
*/
void TimerWrapper::stop() {
_timer->stop(); // Остановка таймера
emit activeChanged(); // Сигнал о смене состояния
}Объект такого класса должен быть зарегистрирован в QML:
main.cpp
#ifdef QT_QML_DEBUG
#include <QtQuick>
#endif
#include <QGuiApplication>
#include <QQmlContext>
#include <QQuickView>
#include <QScopedPointer>
#include <sailfishapp.h>
#include "timerwrapper.h"
int main(int argc, char *argv[]) {
// Создание объекта приложения
QScopedPointer<QGuiApplication> application(SailfishApp::application(argc, argv));
// Создание объекта для отображения интерфейса
QScopedPointer<QQuickView> view(SailfishApp::createView());
// Создание объекта таймера
QScopedPointer<TimerWrapper> timer(new TimerWrapper(view.data()));
// Регистрация объекта таймера
view->rootContext()->setContextProperty("timer", timer.data());
// Объявление пути к стартовому QML-файлу
view->setSource(SailfishApp::pathTo("qml/harbour-application.qml"));
// Отображение интерфейса
view->show();
// Запуск приложения
return application->exec();
}При таком подходе, как упоминалось во введении, на длительных интервалах времени может наблюдаться приостановка работы таймера.
Решение
Первый вариант предотвращения засыпания таймера был предложен в почтовой рассылке разработчиков и прижился в приложении cooktimer. Здесь предлагается завести в явном виде дополнительный таймер, который раз в минуту вызывает D-Bus метод
req_display_cancel_blanking_pause, чтобы предотвратить засыпание устройства. Очевидно, что такая реализация неоптимальна и громоздка. Во-первых, при использовании такого подхода быстрее разряжается батарея устройства. Во-вторых, в проекте появляется второстепенный код, которого можно избежать.А избежать использования второстепенного кода можно потому, что Sailfish OS уже предоставляет два возможных решения поставленной проблемы: элементы
ScreenBlank и KeepAlive.Использование первого подхода подразумевает постоянно активный экран. Это рабочий, но прямолинейный подход, активно потребляющий заряд аккумулятора устройства. Таким образом, использовать его можно, но в ограниченном круге ситуаций.
import QtQuick 2.0 // Подключение модуля для поддержки стандартных элементов QML
import Sailfish.Silica 1.0 // Подключение модуля для поддержки Sailfish OS UI
import Sailfish.Media 1.0 // Подключение модуля для поддержки элемента ScreenBlank
ApplicationWindow // Объявление главного окна приложения
{
initialPage: Component { FirstPage { } } // Объявление главной страницы приложения
cover: Qt.resolvedUrl("cover/CoverPage.qml") // Объявление обложки приложения
ScreenBlank { // Объявление элемента для предотвращения засыпания устройства
id: screenBlank // Идентификатор для обращения
suspend: true // Экран постоянно активирован
}
}В свою очередь использование элемента
KeepAlive является более демократичным подходом. Он в меньшей степени потребляет заряд батареи, так как не держит экран устройства постоянно включенным, и в то же время, либо не даёт уйти устройству в глубокий сон, либо «будит» его в определённый момент времени, благодаря чему таймер будет продолжать работу и на долгих промежутках времени.import QtQuick 2.0 // Подключение модуля для поддержки стандартных элементов QML
import Sailfish.Silica 1.0 // Подключение модуля для поддержки Sailfish OS UI
import org.nemomobile.keepalive 1.1 // Подключение модуля для поддержки элемента KeepAlive
ApplicationWindow // Объявление главного окна приложения
{
initialPage: Component { FirstPage { } } // Объявление главной страницы приложения
cover: Qt.resolvedUrl("cover/CoverPage.qml") // Объявление обложки приложения
KeepAlive { // Объявление элемента для предотвращения засыпания устройства
id: keepAlive // Идентификатор для обращения
enabled: true // Устройство не уходит в глубокий сон
}
}Стоит заметить, что в принципе работы всех трёх упомянутых способах лежит регулярное обращение к системным методам D-Bus, что обсуждалось в одной из предыдущих статей.
Заключение
В рамках данной небольшой заметки описаны три возможных способа предотвращения глубокого засыпания устройства. Можно сделать вывод, что для фоновых задач (например, таймер) оптимально использовать элемент
KeepAlive, а если имеется необходимость постоянного отображения информации пользователю, то ScreenBlank.