QGeoSatelliteInfoSource Class

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

成员函数文档

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

停止定期更新。