QNmeaSatelliteInfoSource Class
La clase « QNmeaSatelliteInfoSource » proporciona información sobre satélites utilizando una fuente de datos NMEA. Más información...
| Encabezado: | #include <QNmeaSatelliteInfoSource> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Desde: | Qt 6.2 |
| Heredado de: | QGeoSatelliteInfoSource |
Tipos públicos
| enum class | UpdateMode { RealTimeMode, SimulationMode } |
Funciones públicas
| QNmeaSatelliteInfoSource(QNmeaSatelliteInfoSource::UpdateMode mode, QObject *parent = nullptr) | |
| virtual | ~QNmeaSatelliteInfoSource() override |
| QIODevice * | device() const |
| void | setDevice(QIODevice *device) |
| QNmeaSatelliteInfoSource::UpdateMode | updateMode() const |
Funciones públicas reimplementadas
| 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 |
Ranuras públicas
| virtual void | requestUpdate(int msec = 0) override |
| virtual void | startUpdates() override |
| virtual void | stopUpdates() override |
Miembros públicos estáticos
| QString | SimulationUpdateInterval |
Tipos protegidos
| enum | SatelliteInfoParseStatus { NotParsed, PartiallyParsed, FullyParsed } |
Funciones protegidas
| QNmeaSatelliteInfoSource(const QNmeaSatelliteInfoSource &) | |
| 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) |
| QNmeaSatelliteInfoSource & | operator=(const QNmeaSatelliteInfoSource &) |
Descripción detallada
NMEA es un protocolo de uso común para especificar la posición global de un usuario en un momento determinado. La clase QNmeaSatelliteInfoSource lee datos NMEA y los utiliza para proporcionar información sobre los satélites visibles y los satélites en uso en forma de listas de objetos QGeoSatelliteInfo.
Una instancia de ` QNmeaSatelliteInfoSource ` funciona en los modos ` RealTimeMode ` o ` SimulationMode`. Estos modos permiten leer datos NMEA desde una fuente de datos en tiempo real o reproducirlos con fines de simulación a partir de datos NMEA grabados previamente.
La fuente de datos NMEA se configura mediante setDevice().
Utilice startUpdates() para comenzar a recibir actualizaciones periódicas de información sobre los satélites y stopUpdates() para detener dichas actualizaciones. Si solo necesita actualizaciones de forma ocasional, puede llamar a requestUpdate() para solicitar una única actualización tanto de los satélites visibles como de los satélites en uso.
La información sobre los satélites visibles se recibe a través de la señal satellitesInViewUpdated().
La información sobre los satélites en uso se recibe a través de la señal « satellitesInUseUpdated » ().
Documentación sobre tipos de miembros
enum QNmeaSatelliteInfoSource::SatelliteInfoParseStatus
Define el estado de análisis sintáctico de la información del satélite. La información del satélite puede dividirse en varias frases, y debemos analizar sintácticamente todas ellas.
| Constante | Valor | Descripción |
|---|---|---|
QNmeaSatelliteInfoSource::NotParsed | 0 | Los datos no contienen información sobre satélites. |
QNmeaSatelliteInfoSource::PartiallyParsed | 1 | Se ha recibido y analizado información válida sobre satélites, pero no está completa, por lo que hay que esperar a otra frase NMEA. |
QNmeaSatelliteInfoSource::FullyParsed | 2 | Se ha recopilado y analizado íntegramente la información sobre los satélites. |
enum class QNmeaSatelliteInfoSource::UpdateMode
Define los modos de actualización disponibles.
| Constante | Valor | Descripción |
|---|---|---|
QNmeaSatelliteInfoSource::UpdateMode::RealTimeMode | 1 | La información del satélite se lee y se distribuye desde la fuente de datos a medida que está disponible. Utiliza este modo si estás utilizando una fuente de datos NMEA en tiempo real (por ejemplo, un dispositivo GPS). |
QNmeaSatelliteInfoSource::UpdateMode::SimulationMode | 2 | La información de los satélites se lee y se distribuye desde la fuente de datos a la frecuencia especificada. La frecuencia viene determinada por el parámetro « SimulationUpdateInterval ». Utiliza este modo si la fuente de datos contiene datos NMEA grabados previamente y deseas reproducirlos con fines de simulación. |
Documentación de las funciones de miembro
[explicit] QNmeaSatelliteInfoSource::QNmeaSatelliteInfoSource(QNmeaSatelliteInfoSource::UpdateMode mode, QObject *parent = nullptr)
Crea una instancia de ` QNmeaSatelliteInfoSource ` con los valores ` parent ` y ` mode` proporcionados.
[protected delete] QNmeaSatelliteInfoSource::QNmeaSatelliteInfoSource(const QNmeaSatelliteInfoSource &)
Crea una instancia de ` QNmeaSatelliteInfoSource` mediante copia. Esta función se ha eliminado.
[override virtual noexcept] QNmeaSatelliteInfoSource::~QNmeaSatelliteInfoSource()
Destruye la fuente de información del satélite.
[override virtual] QVariant QNmeaSatelliteInfoSource::backendProperty(const QString &name) const
Reimplementa: ` QGeoSatelliteInfoSource::backendProperty(const QString &name) const`.
Véase también setBackendProperty().
QIODevice *QNmeaSatelliteInfoSource::device() const
Devuelve la fuente de datos NMEA.
Véase también setDevice().
[override virtual] QGeoSatelliteInfoSource::Error QNmeaSatelliteInfoSource::error() const
Reimplementa: ` QGeoSatelliteInfoSource::error()` const.
[override virtual] int QNmeaSatelliteInfoSource::minimumUpdateInterval() const
Reimplementa una función de acceso para la propiedad: QGeoSatelliteInfoSource::minimumUpdateInterval.
[virtual protected] QNmeaSatelliteInfoSource::SatelliteInfoParseStatus QNmeaSatelliteInfoSource::parseSatelliteInfoFromNmea(const char *data, int size, QList<QGeoSatelliteInfo> &infos, QGeoSatelliteInfo::SatelliteSystem &system)
Analiza una cadena de texto con una frase NMEA para extraer la información sobre los satélites visibles.
La implementación predeterminada analizará sentencias NMEA $GPGSV estándar. Este método debe reimplementarse en una subclase siempre que surja la necesidad de gestionar sentencias NMEA no estándar.
El analizador lee size bytes de data y utiliza esa información para rellenar una list infos.
Devuelve un objeto ` SatelliteInfoParseStatus ` con el resultado del análisis. Modifica la lista ` infos ` en caso de que se devuelva ` PartiallyParsed ` o ` FullyParsed `. También establece el campo ` system ` al tipo de sistema de satélites correcto. Esto es necesario para determinar el tipo de sistema en caso de que no haya satélites a la vista.
[virtual protected] QGeoSatelliteInfo::SatelliteSystem QNmeaSatelliteInfoSource::parseSatellitesInUseFromNmea(const char *data, int size, QList<int> &pnrsInUse)
Analiza una cadena de texto con una frase NMEA para extraer los identificadores de los satélites en uso.
La implementación predeterminada analizará frases NMEA $GPGSA estándar. Este método debe reimplementarse en una subclase siempre que surja la necesidad de gestionar frases NMEA no estándar.
El analizador lee size bytes de data y utiliza esa información para rellenar una list pnrsInUse.
Devuelve el tipo del sistema si la frase se ha analizado correctamente; en caso contrario, devuelve QGeoSatelliteInfo::Undefined y no debe modificar pnrsInUse.
[override virtual slot] void QNmeaSatelliteInfoSource::requestUpdate(int msec = 0)
Reimplementa: ` QGeoSatelliteInfoSource::requestUpdate` (int timeout).
[override virtual] bool QNmeaSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value)
Reimplementa: QGeoSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value).
Véase también backendProperty().
void QNmeaSatelliteInfoSource::setDevice(QIODevice *device)
Establece la fuente de datos NMEA en device. Si el dispositivo no está abierto, se abrirá en modo ReadOnly.
El dispositivo de origen solo se puede configurar una vez y debe hacerse antes de llamar a startUpdates() o requestUpdate().
Nota: El ` device ` debe emitir ` QIODevice::readyRead()` para que se notifique a la fuente cuando haya datos disponibles para su lectura. ` QNmeaSatelliteInfoSource ` no asume la propiedad del dispositivo y, por lo tanto, no lo desasigna al ser destruido.
Véase también device().
[override virtual] void QNmeaSatelliteInfoSource::setUpdateInterval(int msec)
Reimplementa una función de acceso para la propiedad: QGeoSatelliteInfoSource::updateInterval.
[override virtual slot] void QNmeaSatelliteInfoSource::startUpdates()
Reimplementa: QGeoSatelliteInfoSource::startUpdates().
[override virtual slot] void QNmeaSatelliteInfoSource::stopUpdates()
Reimplementa: QGeoSatelliteInfoSource::stopUpdates().
QNmeaSatelliteInfoSource::UpdateMode QNmeaSatelliteInfoSource::updateMode() const
Devuelve el modo de actualización.
[protected delete] QNmeaSatelliteInfoSource &QNmeaSatelliteInfoSource::operator=(const QNmeaSatelliteInfoSource &)
Asigna por copia ` other ` a esta instancia de ` QNmeaSatelliteInfoSource `. Esta función se ha eliminado.
Documentación de variables de miembro
QString QNmeaSatelliteInfoSource::SimulationUpdateInterval
Esta variable contiene el nombre de la propiedad del backend correspondiente a la velocidad de lectura de datos en SimulationMode. El valor de esta propiedad es un número entero que representa la cantidad de milisegundos que transcurren entre lecturas consecutivas. Utiliza este parámetro en los métodos setBackendProperty() y backendProperty().
Nota: Esta propiedad es diferente del intervalo que se puede establecer mediante ` setUpdateInterval()` (). El valor establecido mediante ` setUpdateInterval()` indica un intervalo para la notificación al usuario, mientras que este parámetro especifica la frecuencia interna de lectura de los datos del archivo de origen. Esto significa que pueden producirse varias lecturas (o ninguna) durante el periodo de ` updateInterval()`.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.