QNmeaSatelliteInfoSource Class

The QNmeaSatelliteInfoSource class provides satellite information using an NMEA data source. 更多...

头: #include <QNmeaSatelliteInfoSource>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning
Since: Qt 6.2
继承: QGeoSatelliteInfoSource

公共类型

enum class UpdateMode { RealTimeMode, SimulationMode }

公共函数

QNmeaSatelliteInfoSource (QNmeaSatelliteInfoSource::UpdateMode mode , QObject * parent = nullptr)
virtual ~QNmeaSatelliteInfoSource () override
QIODevice * device () const
void setDevice (QIODevice * device )
QNmeaSatelliteInfoSource::UpdateMode updateMode () const

重实现公共函数

virtual QVariant backendProperty (const QString & name ) const override
virtual QGeoSatelliteInfoSource::Error error () const override
virtual int minimumUpdateInterval () const override
virtual bool setBackendProperty (const QString & name , const QVariant & value ) override
virtual void setUpdateInterval (int msec ) override

公共槽

virtual void requestUpdate (int msec = 0) override
virtual void startUpdates () override
virtual void stopUpdates () override

静态公共成员

QString SimulationUpdateInterval

保护类型

enum SatelliteInfoParseStatus { NotParsed, PartiallyParsed, FullyParsed }

保护函数

virtual QNmeaSatelliteInfoSource::SatelliteInfoParseStatus parseSatelliteInfoFromNmea (const char * data , int size , QList<QGeoSatelliteInfo> & infos , QGeoSatelliteInfo::SatelliteSystem & system )
virtual QGeoSatelliteInfo::SatelliteSystem parseSatellitesInUseFromNmea (const char * data , int size , QList<int> & pnrsInUse )

详细描述

NMEA is a commonly used protocol for the specification of one's global position at a certain point in time. The QNmeaSatelliteInfoSource class reads NMEA data and uses it to provide information about satellites in view and satellites in use in form of lists of QGeoSatelliteInfo 对象。

A QNmeaSatelliteInfoSource instance operates in either RealTimeMode or SimulationMode . These modes allow NMEA data to be read from either a live source of data, or replayed for simulation purposes from previously recorded NMEA data.

The source of NMEA data is set via setDevice ().

使用 startUpdates () to start receiving regular satellite information updates and stopUpdates () to stop these updates. If you only require updates occasionally, you can call requestUpdate () to request a single update of both satellites in view and satellites in use.

The information about satellites in view is received via the satellitesInViewUpdated () 信号。

The information about satellites in use is received via the satellitesInUseUpdated () 信号。

成员类型文档编制

enum QNmeaSatelliteInfoSource:: SatelliteInfoParseStatus

Defines the parse status of satellite information. The satellite information can be split into multiple sentences, and we need to parse all of them.

常量 描述
QNmeaSatelliteInfoSource::NotParsed 0 The data does not contain information about satellites.
QNmeaSatelliteInfoSource::PartiallyParsed 1 A valid satellite information is received and parsed, but it's not complete, so we need to wait for another NMEA sentence.
QNmeaSatelliteInfoSource::FullyParsed 2 Satellite information was fully collected and parsed.

enum class QNmeaSatelliteInfoSource:: UpdateMode

Defines the available update modes.

常量 描述
QNmeaSatelliteInfoSource::UpdateMode::RealTimeMode 1 Satellite information is read and distributed from the data source as it becomes available. Use this mode if you are using a live source of NMEA data (for example a GPS hardware device).
QNmeaSatelliteInfoSource::UpdateMode::SimulationMode 2 Satellite information is read and distributed from the data source at the given rate. The rate is determined by the SimulationUpdateInterval parameter. Use this mode if the data source contains previously recorded NMEA data and you want to replay the data for simulation purposes.

成员函数文档编制

[explicit] QNmeaSatelliteInfoSource:: QNmeaSatelliteInfoSource ( QNmeaSatelliteInfoSource::UpdateMode mode , QObject * parent = nullptr)

构造 QNmeaSatelliteInfoSource instance with the given parent and mode .

[override virtual] QNmeaSatelliteInfoSource:: ~QNmeaSatelliteInfoSource ()

Destroys the satellite information source.

[override virtual] QVariant QNmeaSatelliteInfoSource:: backendProperty (const QString & name ) const

重实现: QGeoSatelliteInfoSource::backendProperty(const QString &name) const .

另请参阅 setBackendProperty ().

QIODevice *QNmeaSatelliteInfoSource:: device () const

Returns the NMEA data source.

另请参阅 setDevice ().

[override virtual] QGeoSatelliteInfoSource::Error QNmeaSatelliteInfoSource:: error () const

重实现: QGeoSatelliteInfoSource::error() const .

[override virtual] int QNmeaSatelliteInfoSource:: minimumUpdateInterval () const

重实现访问函数为特性: QGeoSatelliteInfoSource::minimumUpdateInterval .

[virtual protected] QNmeaSatelliteInfoSource::SatelliteInfoParseStatus QNmeaSatelliteInfoSource:: parseSatelliteInfoFromNmea (const char * data , int size , QList < QGeoSatelliteInfo > & infos , QGeoSatelliteInfo::SatelliteSystem & system )

Parses an NMEA sentence string to extract the information about satellites in view.

The default implementation will parse standard NMEA $GPGSV sentences. This method should be reimplemented in a subclass whenever the need to deal with non-standard NMEA sentences arises.

The parser reads size 字节来自 data and uses that information to fill infos 列表。

返回 SatelliteInfoParseStatus with parse result. Modifies infos list in case PartiallyParsed or FullyParsed is returned. Also sets the system to correct satellite system type. This is required to determine the system type in case there are no satellites in view.

[virtual protected] QGeoSatelliteInfo::SatelliteSystem QNmeaSatelliteInfoSource:: parseSatellitesInUseFromNmea (const char * data , int size , QList < int > & pnrsInUse )

Parses an NMEA sentence string to extract the IDs of satelites in use.

The default implementation will parse standard NMEA $GPGSA sentences. This method should be reimplemented in a subclass whenever the need to deal with non-standard NMEA sentences arises.

The parser reads size 字节来自 data and uses that information to fill pnrsInUse 列表。

Returns system type if the sentence was successfully parsed, otherwise returns QGeoSatelliteInfo::Undefined and should not modifiy pnrsInUse .

[override virtual slot] void QNmeaSatelliteInfoSource:: requestUpdate ( int msec = 0)

重实现: QGeoSatelliteInfoSource::requestUpdate (int timeout).

[override virtual] bool QNmeaSatelliteInfoSource:: setBackendProperty (const QString & name , const QVariant & value )

重实现: QGeoSatelliteInfoSource::setBackendProperty (const QString &name, const QVariant &value).

另请参阅 backendProperty ().

void QNmeaSatelliteInfoSource:: setDevice ( QIODevice * device )

Sets the NMEA data source to device . If the device is not open, it will be opened in QIODevice::ReadOnly mode.

The source device can only be set once and must be set before calling startUpdates () 或 requestUpdate ().

注意: The device must emit QIODevice::readyRead () for the source to be notified when data is available for reading. QNmeaSatelliteInfoSource does not assume the ownership of the device, and hence does not deallocate it upon destruction.

另请参阅 device ().

[override virtual] void QNmeaSatelliteInfoSource:: setUpdateInterval ( int msec )

重实现访问函数为特性: QGeoSatelliteInfoSource::updateInterval .

[override virtual slot] void QNmeaSatelliteInfoSource:: startUpdates ()

重实现: QGeoSatelliteInfoSource::startUpdates ().

[override virtual slot] void QNmeaSatelliteInfoSource:: stopUpdates ()

重实现: QGeoSatelliteInfoSource::stopUpdates ().

QNmeaSatelliteInfoSource::UpdateMode QNmeaSatelliteInfoSource:: updateMode () const

Returns the update mode.

成员变量文档编制

QString QNmeaSatelliteInfoSource:: SimulationUpdateInterval

This variable holds the backend property name for data read rate in the SimulationMode . The value for this property is the integer number representing the amount of milliseconds between the subsequent reads. Use this parameter in the setBackendProperty () 和 backendProperty () 方法。

注意: This property is different from the interval that can be set via setUpdateInterval (). The value set via setUpdateInterval () denotes an interval for the user notification, while this parameter specifies the internal frequency of reading the data from source file. It means that one can have multiple (or none) reads during the updateInterval () period.