QGeoSatelliteInfoSource Class

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

成员函数文档

[explicit] QGeoSatelliteInfoSource::QGeoSatelliteInfoSource(QObject *parent)

创建一个具有指定parent 的卫星源。

[virtual noexcept] 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)

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

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

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

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

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

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

该函数于 Qt 5.14 中引入。

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

返回最近发生的错误。

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

该信号在发生错误后发出。satelliteError 参数描述了发生的错误类型。

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

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

如果超时时间为零，则超时时间将默认设置为适合该源的合理超时周期。

如果另一个更新请求正在进行中，此操作将不产生任何效果。但是，即使已经调用了startUpdates() 且常规更新正在进行中，也可以调用此方法。

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

如果调用了startUpdates() 或requestUpdate()，当当前正在使用的卫星数量有更新时，将触发此信号。

这些卫星用于“定位”——即用于确定当前位置。

satellites 参数保存了当前正在使用的卫星。

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

如果调用了startUpdates()或requestUpdate()，当当前可见的卫星有更新时，将触发此信号。

satellites 参数包含当前可见的卫星。

[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()以创建特定卫星源实现的新实例时所用的名称相同。

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

开始以固定间隔发送更新。每当有新的卫星信息可用时，系统就会提供更新。

如果无法获取卫星信息或发生其他形式的超时，可能会以空参数列表触发satellitesInViewUpdated()和satellitesInUseUpdated()信号。

另请参阅 satellitesInViewUpdated() 和satellitesInUseUpdated()。

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

停止按固定间隔发送更新。