Класс LBSProviderSettings
(Aurora::Location::LBSProviderSettings)
Предоставляет геттеры и сеттеры для настроек конкретного LBS-провайдера. Подробнее...
| Подключение: | #include <LBSProviderSettings> |
Свойства
- apiKey : QString
- backgroundPolicy : LBSBackgroundPolicy::Enum
- backgroundRequestPeriod : quint32
- providerName : QString
- requestPeriod : quint32
- status : Status::Enum
Публичные функции
| LBSProviderSettings(QObject *parent = nullptr) | |
| virtual | ~LBSProviderSettings() |
| QString | apiKey() const |
| LBSBackgroundPolicy::Enum | backgroundPolicy() const |
| quint32 | backgroundRequestPeriod() const |
| void | initializeAsync() |
| QString | providerName() const |
| quint32 | requestPeriod() const |
| void | setApiKeyAsync(const QString &key) |
| void | setBackgroundPolicyAsync(LBSBackgroundPolicy::Enum policy) |
| void | setBackgroundRequestPeriodAsync(quint32 period) |
| void | setProviderName(const QString &name) |
| void | setRequestPeriodAsync(quint32 period) |
| void | setStatusAsync(Status::Enum status) |
| Status::Enum | status() const |
Сигналы
| void | apiKeyChanged(const QString &key) |
| void | backgroundPolicyChanged(LBSBackgroundPolicy::Enum policy) |
| void | backgroundRequestPeriodChanged(quint32 period) |
| void | error(const QString &message) |
| void | initializeFinished(bool success) |
| void | providerNameChanged(const QString &name) |
| void | requestPeriodChanged(quint32 period) |
| void | statusChanged(Status::Enum status) |
| void | validationError(QDBusError::ErrorType err) |
Подробное описание
Предоставляет геттеры и сеттеры для настроек конкретного LBS-провайдера.
Этот класс работает в комбинированном синхронно-асинхронном режиме:
- Cвойства инициализируются при создании объекта, что позволяет затем получать их значения через геттеры мгновенно.
- Когда свойство обновляется извне, оно мгновенно обновляется, и испускается соответствующий сигнал.
- Их сеттеры работают в асинхронном режиме.
Описание свойств
apiKey : QString
Содержит ключ, используемый для выполнения запросов к API.
Функции доступа:
| QString | apiKey() const |
| void | setApiKeyAsync(const QString &key) |
Сигнал уведомления:
| void | apiKeyChanged(const QString &key) |
backgroundPolicy : LBSBackgroundPolicy::Enum
Задаёт правила работы провайдера LBS в фоновом режиме.
Функции доступа:
| LBSBackgroundPolicy::Enum | backgroundPolicy() const |
| void | setBackgroundPolicyAsync(LBSBackgroundPolicy::Enum policy) |
Сигнал уведомления:
| void | backgroundPolicyChanged(LBSBackgroundPolicy::Enum policy) |
backgroundRequestPeriod : quint32
Содержит числовое значение, задающее интервал между запросами в фоновом режиме.
Данное значение применяется как интервал запросов при условии backgroundPolicy == LBSBackgroundPolicy::UseBackgroundPeriod.
Функции доступа:
| quint32 | backgroundRequestPeriod() const |
| void | setBackgroundRequestPeriodAsync(quint32 period) |
Сигнал уведомления:
| void | backgroundRequestPeriodChanged(quint32 period) |
providerName : QString
Содержит имя LBS-провайдера.
Свойство необходимо установить до инициализации объекта. Иначе поведение является неопределённым.
Функции доступа:
| QString | providerName() const |
| void | setProviderName(const QString &name) |
Сигнал уведомления:
| void | providerNameChanged(const QString &name) |
requestPeriod : quint32
Содержит интервал между запросами координат.
Функции доступа:
| quint32 | requestPeriod() const |
| void | setRequestPeriodAsync(quint32 period) |
Сигнал уведомления:
| void | requestPeriodChanged(quint32 period) |
status : Status::Enum
Указывает, активен ли провайдер.
Функции доступа:
| Status::Enum | status() const |
| void | setStatusAsync(Status::Enum status) |
Сигнал уведомления:
| void | statusChanged(Status::Enum status) |
Описание функций-членов
LBSProviderSettings::LBSProviderSettings(QObject *parent = nullptr)
По умолчанию создает экземпляр LBSProviderSettings.
[virtual] LBSProviderSettings::~LBSProviderSettings()
Уничтожает экземпляр LBSProviderSettings. Деструктор является виртуальным.
[signal] void LBSProviderSettings::error(const QString &message)
Испускается при возникновении ошибки. Параметр message описывает произошедшую ошибку.
void LBSProviderSettings::initializeAsync()
Приступает к инициализации объекта. После завершения инициализации испускается сигнал initializeFinished(true), и свойства объекта инициализируются корректными значениями. Если инициализация не удалась, испускается сигнал initializeFinished(false), и свойства объекта переводятся в состояние Unknown.
[signal] void LBSProviderSettings::initializeFinished(bool success)
Сигнал испускается после завершения initializeAsync(). Параметр success указывает, прошла ли успешна инициализация.
[signal] void LBSProviderSettings::validationError(QDBusError::ErrorType err)
Cигнал испускается при возникновении ошибки в процессе валидации API-ключа. Параметр err описывает возникшую ошибку.