QGeoSatelliteInfo 类
QGeoSatelliteInfo 类包含有关卫星的基本信息。更多...
头文件 | #include <QGeoSatelliteInfo> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
qmake | QT += positioning |
- 所有成员列表,包括继承的成员
- QGeoSatelliteInfo 是隐式共享类的一部分。隐式共享类.
公共类型
公共函数
QGeoSatelliteInfo() | |
QGeoSatelliteInfo(const QGeoSatelliteInfo &other) | |
(自 6.2) | QGeoSatelliteInfo(QGeoSatelliteInfo &&other) |
~QGeoSatelliteInfo() | |
qreal | 属性(QGeoSatelliteInfo::Attribute 属性) const |
bool | hasAttribute(QGeoSatelliteInfo::Attribute 属性) const |
void | removeAttribute(QGeoSatelliteInfo::Attribute 属性) |
int | 卫星标识符() const |
QGeoSatelliteInfo::SatelliteSystem | 卫星系统() const |
void | setAttribute(QGeoSatelliteInfo::Attribute 属性, qreal 值) |
void | setSatelliteIdentifier(int satId) |
void | setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system) |
void | setSignalStrength(int signalStrength) |
int | signalStrength() const |
QGeoSatelliteInfo & | operator=(const QGeoSatelliteInfo &other) |
(自 6.2) QGeoSatelliteInfo & | operator=(QGeoSatelliteInfo &&other) |
相关非成员
bool | operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs) |
QDataStream & | operator<<(QDataStream &stream, const QGeoSatelliteInfo &info) |
bool | operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs) |
QDataStream & | operator>>(QDataStream &stream, QGeoSatelliteInfo &info) |
成员类型文档
枚举 QGeoSatelliteInfo::属性
定义卫星信息的属性。
常量 | 值 | 描述 |
---|---|---|
QGeoSatelliteInfo::Elevation | 0 | 卫星的仰角,单位为度。 |
QGeoSatelliteInfo::Azimuth | 1 | 真北方向的天文方位角,单位为度。 |
枚举 QGeoSatelliteInfo::SatelliteSystem
定义卫星的GNSS系统。
常量 | 值 | 描述 |
---|---|---|
QGeoSatelliteInfo::Undefined | 0x00 | 未定义。 |
QGeoSatelliteInfo::GPS | 0x01 | 全球定位系统(美国)。 |
QGeoSatelliteInfo::GLONASS | 0x02 | 全球定位系统(俄罗斯)。 |
QGeoSatelliteInfo::GALILEO | 0x03 | 全球导航卫星系统(欧盟)。 |
QGeoSatelliteInfo::BEIDOU | 0x04 | 北斗导航卫星系统(中国)。 |
QGeoSatelliteInfo::QZSS | 0x05 | 准地平线卫星系统(日本)。 |
QGeoSatelliteInfo::Multiple | 0xFF | 此类型通常表示从支持多个卫星系统的设备接收到的信息,且未明确指定卫星系统。根据数据源,可能需要使用其他信息来确定实际系统类型。此类型的用法示例之一是NMEA $GNGSA消息,其中包含正在使用的卫星ID,但未明确提及它们的系统类型。 |
QGeoSatelliteInfo::CustomType | 0x100 | 第一个可以用于用户目的的类型。例如,在重新实现QNmeaSatelliteInfoSource中的NMEA数据解析时。用户可以使用CustomType + 1 、CustomType + 2 等添加更多类型。 |
成员函数文档
QGeoSatelliteInfo::QGeoSatelliteInfo()
创建一个卫星信息对象。
QGeoSatelliteInfo::QGeoSatelliteInfo(const QGeoSatelliteInfo &other)
使用other
的值创建一个卫星信息对象。
[noexcept, since 6.2]
QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfo &&other)
通过移动other
创建一个卫星信息对象。
注意:移动后的QGeoSatelliteInfo只能被销毁或赋值。调用除析构函数或赋值运算符之外的其他函数的效果是未定义的。
此函数自Qt 6.2起引入。
[noexcept]
QGeoSatelliteInfo::~QGeoSatelliteInfo()
销毁一个卫星信息对象。
[invokable]
qreal QGeoSatelliteInfo::attribute(QGeoSatelliteInfo::Attribute attribute) const
以qreal值返回指定attribute
的值。
如果值未设置,则返回-1。
注意:此函数可以通过元对象系统从QML调用。请参见Q_INVOKABLE。
另请参阅:hasAttribute() 和 setAttribute()。
[可调用的]
bool QGeoSatelliteInfo::hasAttribute(QGeoSatelliteInfo::Attribute attribute) const
如果指定的 attribute 在此更新中存在,则返回 true。
注意:此函数可以通过元对象系统从QML调用。请参见Q_INVOKABLE。
void QGeoSatelliteInfo::removeAttribute(QGeoSatelliteInfo::Attribute attribute)
删除指定的 attribute 和其值。
int QGeoSatelliteInfo::satelliteIdentifier() const
返回卫星标识符号。
卫星标识符号可用于在卫星系统中识别卫星。
实际值可能因平台和选择的后端而异。
例如,如果使用 nmea 插件,GPS 卫星系统的卫星标识符表示 PRN(伪随机噪声)号,而 GLONASS 卫星系统的卫星标识符表示槽号。
对于基于 NMEA 的后端,如果其他来源不可用,则可以使用卫星标识符确定卫星系统类型。您可以参考 卫星 ID 列表 检查不同卫星系统的 ID 范围。
注意:根据平台和选择的后端,不同卫星系统的卫星标识符范围可能相交。为了唯一识别卫星,必须使用 satelliteIndetifier() 和 satelliteSystem() 的组合。
注意:属性 satelliteIdentifier 的获取函数。
另请参阅:setSatelliteIdentifier() 和 satelliteSystem()。
QGeoSatelliteInfo::SatelliteSystem QGeoSatelliteInfo::satelliteSystem() const
返回卫星系统(GPS、GLONASS、...)
注意:此值可以与 satelliteIdentifier() 结合使用,以唯一识别卫星。
注意:属性 satelliteSystem 的获取函数。
另请参阅:setSatelliteSystem() 和 satelliteIdentifier()。
void QGeoSatelliteInfo::setAttribute(QGeoSatelliteInfo::Attribute attribute, qreal value)
将 attribute 的值设置为 value。
另请参阅:attribute()。
void QGeoSatelliteInfo::setSatelliteIdentifier(int satId)
将卫星标识符号设置为 satId。
卫星标识符号可用于在卫星系统中识别卫星。
实际值可能因平台和选择的后端而异。
例如,如果使用 nmea 插件,GPS 卫星系统的卫星标识符表示 PRN(伪随机噪声)号,而 GLONASS 卫星系统的卫星标识符表示槽号。
另请参阅:satelliteIdentifier()。
void QGeoSatelliteInfo::setSatelliteSystem(QGeoSatelliteInfo::SatelliteSystem system)
将卫星系统(GPS、GLONASS、...)设置为 system。
另请参阅:satelliteSystem()。
void QGeoSatelliteInfo::setSignalStrength(int signalStrength)
将信号强度设置为 signalStrength,以分贝计。
另请参阅:signalStrength()。
int QGeoSatelliteInfo::signalStrength() const
返回信号强度,如果未设置则为-1。
注意:属性signalStrength的获取器函数。
另请参阅setSignalStrength()。
QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(const QGeoSatelliteInfo &other)
将other中的值赋给此对象。
[noexcept, 自6.2以来]
QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(QGeoSatelliteInfo &&other)
将other的值移动赋给此对象
请注意,已移动的QGeoSatelliteInfo只能被销毁或赋值。调用除构造函数和赋值运算符之外的其他函数的效果是未定义的。
此函数自Qt 6.2起引入。
相关非成员
bool operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
如果lhs卫星的任何参数与rhs不相同,则返回true
。 Otherwise returns false
。
QDataStream &operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)
将给定的info写入指定的stream。
另请参阅序列化Qt数据类型。
bool operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
如果lhs卫星的所有参数与rhs相同,则返回true
。 Otherwise returns false
。
QDataStream &operator>>(QDataStream &stream, QGeoSatelliteInfo &info)
从指定的stream读取卫星信息到给定的info中。
另请参阅序列化Qt数据类型。
© 2024 Qt公司有限公司。本文档中的文档贡献的版权属于其各自的所有者。本文档根据自由软件基金会发布的