Класс QGeoSatelliteInfoSource

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

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

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

Свойства

• минимальныйИнтервалОбновления : const int
• интервалОбновления : int

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

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

Сигналы

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

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

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

Вызовите начатьОбновления() и остановитьОбновления() для запуска и остановки регулярных обновлений или запросОбновления() для запроса одного обновления. Когда доступно обновление, обновленыСпутникиВзоре() и/или обновленыСпутникиВУпотреблении() будут выпущены.

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

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

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

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

перечисление QGeoSatelliteInfoSource::Ошибка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[virtual] QGeoSatelliteInfoSource::~QGeoSatelliteInfoSource()

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

[static] QStringList QGeoSatelliteInfoSource::availableSources()

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

[virtual, since 6.2] QVariant QGeoSatelliteInfoSource::backendProperty(const QString &name) const

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

Эта функция была добавлена в Qt 6.2.

См. также setBackendProperty.

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

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

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

[static, since Qt 5.14] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createDefaultSource(const QVariantMap &parameters, QObject *parent)

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

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

Этот метод передает parameters фабрике для конфигурации источника.

Эта функция была добавлена в Qt 5.14.

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

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

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

[static, since Qt 5.14] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createSource(const QString &sourceName, const QVariantMap &parameters, QObject *parent)

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

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

Этот метод передает parameters фабрике для конфигурации источника.

Эта функция была добавлена в Qt 5.14.

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

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

[virtual, since 6.2] bool QGeoSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value)

Устанавливает свойство бэкенда с именем name в значение value. Возвращает true при успехе, false в противном случае. Свойства бэкенда могут использоваться для конфигурации поведения подсистемы информации о спутниках во время выполнения.

Эта функция была добавлена в Qt 6.2.

См. также backendProperty.

QString QGeoSatelliteInfoSource::sourceName() const

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

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