Класс BatteryInfo

(Sailfish::Mdm::BatteryInfo)

Класс BatteryInfo предоставляет информацию о заряде батареи. Подробнее…

Заголовочный файл:

#include <mdm-batteryinfo.h>

Список всех членов класса, включая унаследованные

Публичные типы

enum ChargerStatus { Connected, Disconnected, ChargerStatusUnknown }
enum Status

Публичные методы

BatteryInfo(QObject *parent = 0)
int chargePercentage() const
ChargerStatus chargerStatus() const
Status status() const

Сигналы

void chargePercentageChanged(int percentage)
void chargerStatusChanged(ChargerStatus status)
void statusChanged(Status status)

Подробное описание

Класс BatteryInfo предоставляет информацию о заряде батареи.

Для использования данного класса в qmake-настройки проекта клиента следует добавить следующее:

 CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

и затем #include <mdm-batteryinfo.h>.

Пример использования:

 #include <mdm-batteryinfo.h>
 void listenForBatteryChanges(QObject *parent)
 {
     Sailfish::Mdm::BatteryInfo *info = new Sailfish::Mdm::BatteryInfo(parent);
     connect(info, &Sailfish::Mdm::BatteryInfo::chargerStatusChanged, [info] {
                 qInfo() << "Состояние зарядного устройства:" << info->chargerStatus();
             });

     connect(info, &Sailfish::Mdm::BatteryInfo::statusChanged, [info] {
                 qInfo() << "Состояние аккумуляторной батареи:" << info->status();
             });

     connect(info, &Sailfish::Mdm::BatteryInfo::chargePercentageChanged, [info] {
                 qInfo() << "Заряд батареи аккумулятора:" << info->chargePercentage() << "%";
             });
 }

Описание типов класса

enum BatteryInfo::ChargerStatus

В данном перечислении описаны возможные состояния зарядного устройства.

Константа	Значение	Описание
`Sailfish::Mdm::BatteryInfo::Connected`	`0`	Зарядное устройство подключено к этому устройству и заряжает его
`Sailfish::Mdm::BatteryInfo::Disconnected`	`1`	Зарядное устройство не подключено к этому устройству
`Sailfish::Mdm::BatteryInfo::ChargerStatusUnknown`	`2`	Неизвестно, подключено ли к этому устройству зарядное устройство

enum BatteryInfo::Status

В данном перечислении описаны возможные состояния заряда аккумулятора. Сопоставление диапазона процентов заряда со статусом заряда аккумулятора может быть настроено производителем.

Константа	Значение	Описание
`Sailfish::Mdm::BatteryInfo::Full`	`0`	Аккумулятор полностью заряжен (обычно > 95% заряда)
`Sailfish::Mdm::BatteryInfo::Normal`	`1`	Аккумулятор достаточно заряжен (обычно >= 50%)
`Sailfish::Mdm::BatteryInfo::Low`	`2`	Низкий уровень заряда аккумулятора (обычно >= 10%)
`Sailfish::Mdm::BatteryInfo::Empty`	`3`	Аккумулятор разряжен или почти разряжен (обычно менее 10% заряда)

Описание методов класса

BatteryInfo::BatteryInfo(QObject *parent = 0)

Конструктор по умолчанию для класса BatteryInfo.

int BatteryInfo::chargePercentage() const

Возвращает текущий заряд аккумулятора в процентах.

О полностью заряженном аккумуляторе сообщается как 100, а о полностью разряженном аккумуляторе — как 0 процентов. Если процент заряда аккумулятора неизвестен (например, из-за связи с системной службой, которая предоставляет данные, что занимает некоторое время, или если вызывающее приложение не имеет разрешения на доступ к этой информации), то будет возвращено-1.

При его изменении будет испущен сигнал chargePercentageChanged().

[signal] void BatteryInfo::chargePercentageChanged(int percentage)

Сигнал испускается при изменении процента заряда аккумулятора. percentage описывает новый процент заряда батареи.

См. также chargePercentage().

ChargerStatus BatteryInfo::chargerStatus() const

Возвращает статус зарядного устройства.

Зарядное устройство может быть Connected, Disconnected или ChargerStatusUnknown.

При его изменении будет испущен сигнал chargerStatusChanged().

[signal] void BatteryInfo::chargerStatusChanged(ChargerStatus status)

Этот сигнал испускается, когда зарядное устройство подключено к этому устройству или отключено от него. status описывает новый статус зарядного устройства.

См. также chargerStatus().

Status BatteryInfo::status() const

Возвращает статус заряда аккумулятора.

Статус может быть одним из Full, Normal, Low, Empty или BatteryStatusUnknown.

При его изменении будет испущен сигнал statusChanged().

[signal] void BatteryInfo::statusChanged(Status status)

Сигнал испускается при изменении уровня заряда аккумулятора. status описывает новый статус заряда аккумулятора.

См. также status().