SatelliteSource QML Type
La clase SatelliteSource proporciona la información sobre los satélites. Más...
| Import Statement: | import QtPositioning |
| Since: | Qt 6.5 |
Propiedades
- active : bool
- name : string
- parameters : list<PluginParameter>
- satellitesInUse : list<geoSatelliteInfo>
- satellitesInView : list<geoSatelliteInfo>
- sourceError : enumeration
- updateInterval : int
- valid : bool
Métodos
- var backendProperty(string name)
- bool setBackendProperty(string name, var value)
- void start()
- void stop()
- void update(int timeout)
Descripción detallada
La clase SatelliteSource proporciona información sobre los satélites en uso y los satélites visibles. Esta clase es una representación en QML de QGeoSatelliteInfoSource.
Al igual que su equivalente en C++, la clase admite diferentes complementos. Utilice la propiedad name para especificar el nombre del complemento que se va a utilizar y, si es necesario, indique l PluginParameteres. Si no se establece la propiedad name, se utilizará un complemento predeterminado. Consulte Complementos deQt Positioning para obtener más información sobre los complementos disponibles.
Utilice la propiedad « valid » para comprobar el estado de «SatelliteSource».
Utiliza la propiedad updateInterval para indicar con qué frecuencia tu aplicación desea recibir las actualizaciones de la información de satélites. Los métodos start(), stop() y update() pueden utilizarse para controlar el funcionamiento de SatelliteSource, así como la propiedad active, que, cuando se establece, equivale a llamar a start() o stop().
Cuando SatelliteSource está activo, las actualizaciones de la información de los satélites se pueden recuperar mediante las propiedades « satellitesInView » y « satellitesInUse ».
Si se produce un error durante las actualizaciones de la información de satélites, utilice la propiedad ` sourceError ` para obtener el código de error concreto.
Ejemplo de uso
El siguiente ejemplo muestra un SatelliteSource que utiliza el complemento NMEA para recibir actualizaciones de la información de los satélites cada segundo y mostrar en la consola el número de satélites visibles y de satélites en uso.
SatelliteSource {
id: source
name: "nmea"
active: true
updateInterval: 1000
PluginParameter { name: "nmea.source"; value: "serial:/dev/ttyACM0" }
onSatellitesInUseChanged: {
console.log("Satellites in use:", source.satellitesInUse.length)
}
onSatellitesInViewChanged: {
console.log("Satellites in view:", source.satellitesInView.length)
}
}Véase también QGeoSatelliteInfoSource, PluginParameter y geoSatelliteInfo.
Documentación de propiedades
active : bool
Esta propiedad indica si la fuente del satélite está activa. Establecer esta propiedad en « false » equivale a llamar a « stop », y establecerla en « true » equivale a llamar a « start ».
Véase también start, stop y update.
name : string
Esta propiedad contiene el nombre interno único del complemento que proporciona actualmente la información de satélite.
Al establecer esta propiedad, SatelliteSource pasa a utilizar un complemento de backend concreto. Si el complemento SatelliteSource está activo en el momento en que se modifica la propiedad «name», este quedará inactivo. Si no se puede cargar el backend especificado, la fuente de datos satelitales dejará de ser válida.
Cambiar la propiedad «name» puede provocar que la propiedad « updateInterval » también cambie.
parameters : list<PluginParameter> [default read-only]
Esta propiedad contiene la lista de parámetros del complemento.
Véase también PluginParameter.
satellitesInUse : list<geoSatelliteInfo> [read-only]
Esta propiedad contiene la lista de satélites que se están utilizando actualmente. Se trata de los satélites que se emplean para obtener una «posición», es decir, aquellos que se utilizan para determinar la posición actual.
satellitesInView : list<geoSatelliteInfo> [read-only]
Esta propiedad contiene la lista de satélites que se ven actualmente.
sourceError : enumeration [read-only]
Esta propiedad contiene el último error que se ha producido con el proveedor de datos del backend.
| Constante | Descripción |
|---|---|
SatelliteSource.AccessError | El establecimiento de la conexión con el backend satélite ha fallado porque la aplicación carecía de los privilegios necesarios. |
SatelliteSource.ClosedError | El backend satélite ha cerrado la conexión, lo que ocurre, por ejemplo, cuando el usuario desactiva los servicios de localización. |
SatelliteSource.NoError | No se ha producido ningún error. |
SatelliteSource.UnknownSourceError | Se ha producido un error no identificado. |
SatelliteSource.UpdateTimeoutError | No se ha podido recuperar la información del satélite dentro del tiempo de espera especificado. |
updateInterval : int
Esta propiedad almacena el intervalo deseado entre actualizaciones, expresado en milisegundos.
valid : bool [read-only]
Esta propiedad es « true » si el objeto « SatelliteSource » ha obtenido un complemento de backend válido para proporcionar datos, y « false » en caso contrario.
Las aplicaciones deben comprobar esta propiedad para determinar si el suministro de información de satélite está disponible y habilitado en la plataforma de ejecución, y reaccionar en consecuencia.
Documentación del método
var backendProperty(string name)
Devuelve el valor de la propiedad específica del backend denominada « name », si existe. En caso contrario, incluso si se invoca sobre un objeto « SatelliteSource » no inicializado, el valor devuelto no será válido.
Véase también setBackendProperty().
bool setBackendProperty(string name, var value)
Establece la propiedad específica del backend denominada « name » en « value ». Devuelve «true» si la operación se realiza correctamente y «false» en caso contrario, incluso si se invoca sobre un objeto « SatelliteSource » no inicializado.
Véase también backendProperty().
void start()
Solicita actualizaciones a la fuente del satélite. Utiliza ` updateInterval ` si está establecido; de lo contrario, se utiliza el intervalo predeterminado. Si no hay ninguna fuente disponible, este método no tiene ningún efecto.
Véase también stop(), update() y active.
void stop()
Detiene las actualizaciones procedentes de la fuente satelital. Si no hay ninguna fuente disponible o esta no está activa, este método no tiene ningún efecto.
Véase también start(), update() y active.
void update(int timeout = 0)
Un método práctico para solicitar una única actualización desde la fuente del satélite. Si no hay ninguna fuente disponible, este método no tiene ningún efecto.
Si la fuente satélite no está activa, se activará durante el tiempo que sea necesario para recibir una actualización, o hasta que expire el tiempo de espera de la solicitud. El tiempo de espera de la solicitud depende del complemento.
El tiempo de espera para la actualización ( timeout ) se especifica en milisegundos. Si el tiempo de espera de la actualización ( timeout ) es cero (el valor por defecto), se establece por defecto un tiempo de espera razonable adecuado para la fuente.
© 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.