Класс QGeoSatelliteInfoSource

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

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

Открытые типы

Свойства

• minimumUpdateInterval : const int
• updateInterval : int

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

Открытые функции

• 31 открытая функция унаследована от QObject

Открытые слоты

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

Сигналы

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

Статические открытые члены

• 9 статических открытых членов унаследованы от QObject

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

• 9 защищённых функций унаследованы от 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::Ошибка

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

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

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()

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