Класс QGeoSatelliteInfoSource

Класс QGeoSatelliteInfoSource — это абстрактный базовый класс для распространения обновлений информации о спутниках. Подробнее...

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

Типы публичного доступа

Свойства

• minimumUpdateInterval : const int
• updateInterval : int

• 1 свойство унаследовано от QObject

Функции публичного доступа

• 34 функции публичного доступа унаследованы от QObject

Слот публичного доступа

• 1 слот публичного доступа унаследован от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Статические члены публичного доступа

• 10 статических членов публичного доступа унаследованы от QObject

Дополнительные унаследованные члены

• 1 публичная переменная унаследована от QObject
• 9 защищённые функции унаследованы от QObject
• 2 защищённые переменные унаследованы от QObject

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

Класс QGeoSatelliteInfoSource — это абстрактный базовый класс для распространения обновлений информации о спутниках.

Статическая функция QGeoSatelliteInfoSource::createDefaultSource() создает стандартный источник данных о спутниках, подходящий для платформы, если такой есть. В противном случае, доступные плагины QGeoPositionInfoSourceFactory будут проверены на наличие источника данных о спутниках.

Вызовите startUpdates() и stopUpdates() для начала и остановки регулярных обновлений или requestUpdate() для запроса одного обновления. Когда обновление доступно, будут выпущены satellitesInViewUpdated() и/или satellitesInUseUpdated().

Если требуются регулярные обновления данных о спутниках, setUpdateInterval() может быть использовано для указания частоты выпуска этих обновлений. Если интервал не указан, обновления предоставляются просто тогда, когда они доступны. Например:

// Emit updates every 10 seconds if available
QGeoSatelliteInfoSource *source = QGeoSatelliteInfoSource::createDefaultSource(0);
if (source)
    source->setUpdateInterval(10000);

Чтобы удалить ранее заданный интервал обновления, вызовите setUpdateInterval() со значением 0.

Обратите внимание, что источник спутниковых данных может иметь минимальное требование к интервалам обновлений, как возвращает minimumUpdateInterval().

Документация типов членов

Перечисление QGeoSatelliteInfoSource::Error

Перечисление Error представляет ошибки, которые могут возникнуть.

Документация функций-членов

QGeoSatelliteInfoSource::QGeoSatelliteInfoSource(QObject *parent)

Создает источник данных о спутниках со указанным parent.

[virtual] QGeoSatelliteInfoSource::~QGeoSatelliteInfoSource()

Уничтожает источник данных о спутниках.

[static] QStringList QGeoSatelliteInfoSource::availableSources()

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

[static] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createDefaultSource(QObject *parent)

Создает и возвращает источник, с заданным parent, который считывает данные об обновлении спутников из системного источника по умолчанию или плагин с наивысшим приоритетом.

Возвращает 0, если у системы нет источника спутниковых данных по умолчанию, не найдены валидные плагины или у пользователя нет разрешения на доступ к спутниковым данным.

[static] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createSource(const QString &sourceName, QObject *parent)

Создает и возвращает источник с указанным parent, загружая плагин с именем sourceName.

Возвращает 0, если плагин не найден.

[pure virtual] QGeoSatelliteInfoSource::Error QGeoSatelliteInfoSource::error() const

Возвращает последнюю произошедшую ошибку.

Это событие не генерируется, когда произошел requestTimeout().

[signal] void QGeoSatelliteInfoSource::error(QGeoSatelliteInfoSource::Error satelliteError)

Это сигнал испускается после возникновения ошибки. Параметр satelliteError описывает тип произошедшей ошибки.

Примечание: Сигнал error перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя функции Qt предоставляет удобную утилиту для получения указателя функции, как показано в этом примере:

connect(geoSatelliteInfoSource, QOverload<QGeoSatelliteInfoSource::Error>::of(&QGeoSatelliteInfoSource::error),
    [=](QGeoSatelliteInfoSource::Error satelliteError){ /* ... */ });

[signal] void QGeoSatelliteInfoSource::requestTimeout()

Издается, если requestUpdate() был вызван, и текущая информация о спутниках не могла быть получена в течение заданного таймаута.

Хотя срабатывание этого сигнала можно считать ошибкой, это не подразумевает испускание сигнала error(). Требуется только испускание сигнала requestTimeout(), чтобы указать на таймаут.

[pure virtual slot] void QGeoSatelliteInfoSource::requestUpdate(int timeout = ...)

Попытка получить текущую информацию о спутниках и испустить satellitesInViewUpdated() и satellitesInUseUpdated() с этой информацией. Если текущая информация о спутниках не может быть найдена в течение заданного timeout (в миллисекундах) или если timeout меньше значения, возвращаемого minimumUpdateInterval(), испускается requestTimeout().

Если таймаут равен нулю, таймаут устанавливается по умолчанию на разумное значение, соответствующее источнику.

Это ничего не делает, если в процессе уже есть другой запрос обновления. Однако его можно вызвать, даже если startUpdates() уже был вызван и регулярные обновления находятся в процессе.

[signal] void QGeoSatelliteInfoSource::satellitesInUseUpdated(const QList<QGeoSatelliteInfo> &satellites)

Если startUpdates() или requestUpdate() вызывается, этот сигнал испускается, когда доступно обновление количества спутников, которые в настоящее время используются.

Это спутники, используемые для получения «фиксирования» — то есть тех, которые используются для определения текущего местоположения.

Параметр satellites содержит спутники, которые в настоящее время используются.

[signal] void QGeoSatelliteInfoSource::satellitesInViewUpdated(const QList<QGeoSatelliteInfo> &satellites)

Если startUpdates() или requestUpdate() вызывается, этот сигнал испускается, когда доступно обновление спутников, которые в настоящее время находятся в поле зрения.

Параметр satellites содержит спутники, которые в настоящее время находятся в поле зрения.

QString QGeoSatelliteInfoSource::sourceName() const

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

Это то же имя, которое можно передать в createSource() для создания нового экземпляра конкретной реализации источника спутниковых данных.

[pure virtual slot] void QGeoSatelliteInfoSource::startUpdates()

Начинает испускать обновления с регулярными интервалами. Обновления будут предоставляться всякий раз, когда появятся новые данные о спутниках.

Если информация о спутниках не может быть получена или произошел какой-либо таймаут, сигналы satellitesInViewUpdated() и satellitesInUseUpdated() могут быть испущены со списками параметров, которые пусты.

См. также satellitesInViewUpdated() и satellitesInUseUpdated().

[pure virtual slot] void QGeoSatelliteInfoSource::stopUpdates()

Останавливает испускание обновлений с регулярными интервалами.