SatelliteSource QML Type

La clase SatelliteSource proporciona la información del satélite. Más...

• Lista de todos los miembros, incluyendo los heredados

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 satélites en uso y satélites a la vista. Esta clase es una representación QML de QGeoSatelliteInfoSource.

Al igual que su equivalente en C++, la clase soporta diferentes plugins. Utilice la propiedad name para especificar el nombre del plugin a utilizar, y proporcione PluginParameters, si es necesario. Si no se establece la propiedad name, se utilizará un plugin por defecto. Consulte Qt Positioning Plugins para obtener más información sobre los plugins disponibles.

Utilice la propiedad valid para comprobar el estado de SatelliteSource.

Utilice la propiedad updateInterval para indicar la frecuencia con la que su aplicación desea recibir las actualizaciones de la información del satélite. Los métodos start(), stop() y update() pueden utilizarse para controlar el funcionamiento de la SatelliteSource, así como la propiedad active, que cuando se establece equivale a llamar a start() o stop().

Cuando la SatelliteSource está activa, las actualizaciones de la información de los satélites se pueden recuperar utilizando las propiedades satellitesInView y satellitesInUse.

Si se produce un error durante la actualización de la información de los satélites, utilice la propiedad sourceError para obtener el código de error real.

Ejemplo de uso

El siguiente ejemplo muestra un SatelliteSource que está utilizando el plugin NMEA para recibir actualizaciones de información de satélites cada segundo e imprimir la cantidad de satélites a la vista y satélites en uso en la consola.

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)
    }
}

Ver también QGeoSatelliteInfoSource, PluginParameter, y geoSatelliteInfo.

Documentación de Propiedades

active : bool

Esta propiedad indica si la fuente satélite está activa. Establecer esta propiedad a false equivale a llamar a stop, y establecer esta propiedad a true equivale a llamar a start.

Ver también start, stop, y update.

name : string

Esta propiedad contiene el nombre interno único del plugin que proporciona actualmente la información del satélite.

Establecer esta propiedad hace que SatelliteSource utilice un plugin backend en particular. Si SatelliteSource está activo en el momento de cambiar la propiedad name, se volverá inactivo. Si el backend especificado no puede ser cargado, la fuente de satélites dejará de ser válida.

Cambiar la propiedad name puede causar que la propiedad updateInterval cambie también.

parameters : list<PluginParameter> [default read-only]

Esta propiedad contiene la lista de parámetros del plugin.

Véase también PluginParameter.

satellitesInUse : list<geoSatelliteInfo> [read-only]

Esta propiedad contiene la lista de satélites que están actualmente en uso. Estos son los satélites que se utilizan para obtener un "fix" - es decir, los que se utilizan para determinar la posición actual.

satellitesInView : list<geoSatelliteInfo> [read-only]

Esta propiedad contiene la lista de satélites que están actualmente a la vista.

sourceError : enumeration [read-only]

Esta propiedad contiene el último error que se produjo con el proveedor de datos backend.

updateInterval : int

Esta propiedad contiene el intervalo deseado entre actualizaciones en milisegundos.

valid : bool [read-only]

Esta propiedad es true si el objeto SatelliteSource ha adquirido un plugin 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 sobre satélites está disponible y habilitado en la plataforma en tiempo 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 llamada name, si está presente. En caso contrario, incluso si se llama a un 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 name en value. Devuelve true en caso de éxito, false en caso contrario, incluso si se llama a un SatelliteSource no inicializado.

Véase también backendProperty().

void start()

Solicita actualizaciones de la fuente satélite. Utiliza updateInterval si está configurado, intervalo por defecto en caso contrario. Si no hay fuente disponible, este método no tiene efecto.

Véase también stop(), update(), y active.

void stop()

Detiene las actualizaciones de la fuente satélite. Si no hay fuente disponible o no está activa, este método no tiene 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 de 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 tarde en recibir una actualización, o hasta que se agote el tiempo de espera de la solicitud. El tiempo de espera de la petición es específico del plugin.

timeout se especifica en milisegundos. Si timeout es cero (el valor por defecto), se establece por defecto un periodo de tiempo razonable apropiado para la fuente.

Véase también start(), stop(), y active.