SatelliteSource QML Type

La classe SatelliteSource fournit des informations sur les satellites. Plus d'informations...

Import Statement: import QtPositioning
Since: Qt 6.5

Propriétés

Méthodes

Description détaillée

La classe SatelliteSource fournit des informations sur les satellites utilisés et les satellites en vue. Cette classe est une représentation QML de QGeoSatelliteInfoSource.

Comme son équivalent en C++, la classe prend en charge différents plugins. Utilisez la propriété name pour spécifier le nom du plugin à utiliser et fournissez PluginParameters, si nécessaire. Si la propriété name n'est pas définie, un plugin par défaut sera utilisé. Voir Qt Positioning Plugins pour plus d'informations sur les plugins disponibles.

Utilisez la propriété valid pour vérifier l'état de SatelliteSource.

Utilisez la propriété updateInterval pour indiquer la fréquence à laquelle votre application souhaite recevoir les mises à jour des informations satellite. Les méthodes start(), stop() et update() peuvent être utilisées pour contrôler le fonctionnement de la source satellite, ainsi que la propriété active qui, lorsqu'elle est définie, équivaut à appeler start() ou stop().

Lorsque la source satellite est active, les mises à jour des informations satellite peuvent être récupérées à l'aide des propriétés satellitesInView et satellitesInUse.

Si une erreur se produit lors de la mise à jour des informations satellite, utilisez la propriété sourceError pour obtenir le code d'erreur actuel.

Exemple d'utilisation

L'exemple suivant montre une SatelliteSource qui utilise le plugin NMEA pour recevoir des mises à jour d'informations satellite toutes les secondes et imprimer la quantité de satellites en vue et de satellites en cours d'utilisation sur la console.

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

Voir également QGeoSatelliteInfoSource, PluginParameter, et geoSatelliteInfo.

Propriété Documentation

active : bool

Cette propriété indique si la source satellite est active. La définition de cette propriété à false équivaut à appeler stop, et la définition de cette propriété à true équivaut à appeler start.

Voir également start, stop, et update.


name : string

Cette propriété contient le nom interne unique du plugin qui fournit actuellement des informations sur les satellites.

La définition de cette propriété fait en sorte que SatelliteSource utilise un module d'extension particulier. Si le site SatelliteSource est actif au moment où la propriété name est modifiée, il devient inactif. Si le backend spécifié ne peut pas être chargé, la source satellite devient invalide.

La modification de la propriété name peut entraîner la modification de la propriété updateInterval.


parameters : list<PluginParameter> [default]

Cette propriété contient la liste des paramètres du plugin.

Voir également PluginParameter.


satellitesInUse : list<geoSatelliteInfo> [read-only]

Cette propriété contient la liste des satellites actuellement utilisés. Il s'agit des satellites utilisés pour obtenir une "position", c'est-à-dire ceux utilisés pour déterminer la position actuelle.


satellitesInView : list<geoSatelliteInfo> [read-only]

Cette propriété contient la liste des satellites actuellement en vue.


sourceError : enumeration [read-only]

Cette propriété contient la dernière erreur survenue avec le fournisseur de données dorsal.

  • SatelliteSourceAccessError - L'établissement de la connexion avec le backend du satellite a échoué car l'application ne disposait pas des privilèges requis.
  • SatelliteSource.ClosedError - Le backend du satellite a fermé la connexion, ce qui se produit par exemple lorsque l'utilisateur désactive les services de localisation.
  • SatelliteSource.NoError - Aucune erreur ne s'est produite.
  • SatelliteSource.UnknownSourceError - Une erreur non identifiée s'est produite.
  • SatelliteSource.UpdateTimeoutError - Les informations sur le satellite n'ont pas pu être récupérées dans le délai spécifié.

updateInterval : int

Cette propriété indique l'intervalle souhaité entre les mises à jour en millisecondes.


valid : bool [read-only]

Cette propriété vaut true si l'objet SatelliteSource a acquis un plugin backend valide pour fournir des données, et false dans le cas contraire.

Les applications doivent vérifier cette propriété pour déterminer si la fourniture d'informations satellitaires est disponible et activée sur la plateforme d'exécution, et réagir en conséquence.


Documentation de la méthode

var backendProperty(string name)

Renvoie la valeur de la propriété spécifique au backend nommée name, si elle est présente. Dans le cas contraire, y compris si elle est appelée sur un site SatelliteSource non initialisé, la valeur de retour sera invalide.

Voir également setBackendProperty().


bool setBackendProperty(string name, var value)

Définit la propriété spécifique au backend nommée name à value. Retourne true en cas de succès, false sinon, y compris si elle est appelée sur un SatelliteSource non initialisé.

Voir aussi backendProperty().


start()

Demande des mises à jour à la source satellite. Utilise updateInterval s'il est défini, l'intervalle par défaut dans le cas contraire. Si aucune source n'est disponible, cette méthode n'a aucun effet.

Voir aussi stop, update, et active.


stop()

Arrête les mises à jour de la source satellite. Si aucune source n'est disponible ou si elle n'est pas active, cette méthode n'a aucun effet.

Voir aussi start, update, et active.


update(int timeout = 0)

Une méthode de commodité pour demander une seule mise à jour de la source satellite. Si aucune source n'est disponible, cette méthode n'a aucun effet.

Si la source satellite n'est pas active, elle sera activée le temps de recevoir une mise à jour ou jusqu'à ce que la demande soit épuisée. Le délai d'attente de la demande est spécifique à chaque plugin.

L'adresse timeout est spécifiée en millisecondes. Si timeout est égal à zéro (valeur par défaut), le délai d'attente est fixé par défaut à un niveau raisonnable, en fonction de la source.

Voir également start, stop, et active.


© 2025 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.