QGeoSatelliteInfoSource 类

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

成员函数文档

[虚函数 noexcept] QGeoSatelliteInfoSource::~QGeoSatelliteInfoSource()

销毁卫星源。

[静态] QStringList QGeoSatelliteInfoSource::availableSources()

返回可用源插件的列表，包括如果有的话默认系统后端。

[虚函数, 自6.2版本起] QVariant QGeoSatelliteInfoSource::backendProperty(const QString &name) const

如果有，返回名为name的特定于后端属性值；否则返回的值无效。

此函数自Qt 6.2版本起被引入。

另请参阅setBackendProperty。

[静态] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createDefaultSource(QObject *parent)

创建并返回一个具有指定parent的源，该源从系统默认的卫星更新信息源读取，或读取最高优先级的可用插件。

如果没有默认的卫星源，找不到有效的插件或用户没有权限访问卫星数据，则返回nullptr。

[静态，自Qt 5.14版本起] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createDefaultSource(const QVariantMap &parameters, QObject *parent)

创建并返回一个具有给定parent且从系统默认的卫星数据源读取，或读取具有最高可用优先级的插件的卫星源。

如果没有默认的卫星源，找不到有效的插件或用户没有权限访问卫星信息，则返回nullptr。

此方法将parameters传递到工厂以配置源。

此函数自Qt 5.14版本起被引入。

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

通过加载名为sourceName的插件创建并返回指定parent的源。

如果找不到插件，则返回nullptr。

[静态，从 Qt 5.14 以来] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createSource(const QString &sourceName, const QVariantMap &parameters, QObject *parent)

通过加载名为 sourceName 的插件，创建并返回一个具有给定 parent 的卫星源。

如果找不到插件，则返回nullptr。

此方法将parameters传递到工厂以配置源。

此函数自Qt 5.14版本起被引入。

[纯虚函数] QGeoSatelliteInfoSource::Error QGeoSatelliteInfoSource::error() const

返回最后发生的错误。

[信号] void QGeoSatelliteInfoSource::errorOccurred(QGeoSatelliteInfoSource::Error satelliteError)

错误发生时会发出此信号。参数 satelliteError 描述了发生错误的类型。

[纯虚槽] void QGeoSatelliteInfoSource::requestUpdate(int timeout = 0)

尝试获取当前的卫星信息并发出带有该信息的 satellitesInViewUpdated() 和 satellitesInUseUpdated() 信号。如果在给定的 timeout （以毫秒为单位）内找不到当前卫星信息，或者如果在 timeout 小于 minimumUpdateInterval() 返回的值时，将发出带有 UpdateTimeoutError 的 errorOccurred() 信号。

如果超时为零，则超时默认为适合源的可接受超时时间段。

如果有其他更新请求正在进行，则此操作不执行任何操作。但是，即使已经调用 startUpdates() 并且正在执行常规更新，也可以调用此方法。

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

当调用 startUpdates() 或 requestUpdate() 时，如果在当前正在使用的卫星数量上有更新的情况，则发出此信号。

这些是用于获取“固定”的卫星——即用于确定当前位置的卫星。

参数 satellites 包含当前正在使用的卫星。

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

当调用 startUpdates() 或 requestUpdate() 时，如果在当前视野中的卫星上有更新的情况，则发出此信号。

卫星参数包含 currently in view 中当前可见的卫星。

[虚拟，自6.2起] bool QGeoSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value)

将名为 name 的后端特定属性设置为 value。成功时返回 true，否则返回 false。后端特定属性可以用于在运行时配置卫星信息子系统行为。

此函数自Qt 6.2版本起被引入。

另请参阅backendProperty。

QString QGeoSatelliteInfoSource::sourceName() const

返回正在使用的卫星源实现的唯一名称。

此名称可以传递给 createSource() 以创建特定卫星源实现的实例。

[纯虚函数] void QGeoSatelliteInfoSource::startUpdates()

以固定间隔开始发出更新。只要可用，就会提供新的卫星信息。

如果无法检索卫星信息或已发生超时等其他形式，则可能发出带有空参数列表的 satellitesInViewUpdated() 和 satellitesInUseUpdated() 信号。

另请参阅satellitesInViewUpdated() 和 satellitesInUseUpdated。

[纯虚函数] void QGeoSatelliteInfoSource::stopUpdates()

停止以固定间隔发出更新。