Retourne des informations sur l’environnement de l’application, par exemple l’endroit où se trouve l’utilisateur dans le monde et l’écran qui s’affiche.

Description et syntaxe

Tous les signaux retournent un enregistrement d’informations. Vous pouvez utiliser et stocker ces informations en tant qu’enregistrement ou vous pouvez en extraire des propriétés individuelles à l’aide de . opérateur.

Accélération

Le signal Acceleration retourne l’accélération de l’appareil dans trois dimensions par rapport à l’écran. L’accélération est exprimée en unités g de 9,81 m/s2 ou 32,2 pieds/s2 (Accélération conférée par la Terre aux objets qui se trouvent à sa surface en raison de la gravité).

Propriété du signal Description
Acceleration.X Droite et gauche. La droite est un nombre positif.
Acceleration.Y Avant et arrière. L’avant est un nombre positif.
Acceleration.Z Haut et bas. Le haut est un nombre positif.

App

Le signal application retourne des informations sur l’application en cours d’exécution.

Propriété du signal Description
App.ActiveScreen Écran affiché. Retourne un objet écran, que vous pouvez utiliser pour référencer des propriétés de l’écran ou pour le comparer à un autre écran pour déterminer l’écran affiché. À l’aide de la fonction Back ou Navigate, vous pouvez modifier l’écran qui s’affiche.

Boussole

Le signal Compass le cap de la boussole, en haut de l’écran. Ce cap est basé sur le nord magnétique.

Propriété du signal Description
Compass.Heading Cap en degrés. Retourne un nombre entre 0 et 360, 0 étant le Nord.

Connexion

Le signal Connection retourne des informations sur la connexion réseau. Sur une connexion limitée, vous souhaitez sans doute limiter la quantité de données que vous envoyez ou recevez via le réseau.

Propriété du signal Description
Connection.Connected Retourne une valeur booléenne true ou false qui indique si l’appareil est connecté à un réseau.
Connection.Metered Retourne une valeur booléenne true ou false qui indique si la connexion est limitée.

Emplacement

Le signal Location retourne l’emplacement de l’appareil à partir des informations GPS et autres informations de l’appareil, comme les communications avec l’antenne relais et l’adresse IP.

Lorsqu’un utilisateur accède pour la première fois aux informations de localisation, l’appareil peut lui demander s’il souhaite autoriser l’accès à ces informations.

Lorsque la localisation change, les dépendances basées sur cette localisation sont en permanence recalculées, ce qui consomme de l’énergie de la batterie. Pour économiser la batterie, vous pouvez utiliser les fonctions Enable et Disable pour activer et désactiver les mises à jour de l’emplacement. L’emplacement est automatiquement désactivé si l’écran qui s’affiche ne dépend pas des informations de localisation.

Propriété du signal Description
Location.Altitude Retourne un nombre qui indique l’altitude au-dessus du niveau de la mer, calculée en pieds.
Location.Latitude Retourne un nombre compris entre -90 et 90 qui indique la latitude, exprimée en degrés à partir de l’équateur. Un nombre positif indique un emplacement au nord de l’équateur.
Location.Longitude Retourne un nombre compris entre 0 et 180 qui indique la longitude, exprimée en degrés à partir de Greenwich.

Exemples

Sur la butte du terrain de baseball du Safeco Field à Seattle, le lanceur lance un téléphone au receveur qui se trouve sur le marbre. Le téléphone reste plat par rapport au sol, le haut de l’écran est orienté vers le receveur et le lanceur n’ajoute aucun effet à son lancer. À cet endroit, le réseau cellulaire du téléphone est limité et il n’y a pas de Wi-Fi. L’écran PlayBall est affiché.

Formule Description Résultat
Location.Latitude Retourne la latitude de l’emplacement actuel. Le stade du Safeco Field se situe sur les coordonnées 47,591 N, 122,333 O. 47,591

La latitude change en permanence lorsque le téléphone se déplace entre le lanceur et le receveur.
Location.Longitude Retourne la longitude de l’emplacement actuel. 122,333

La longitude change en permanence lorsque le téléphone se déplace entre le lanceur et le receveur.
Location Retourne la latitude et la longitude de l’emplacement actuel, sous forme d’enregistrement. { Latitude : 47,591, Longitude : 122,333 }
Compass.Heading Retourne le cap de la boussole, mesuré en haut de l’écran. Au Safeco Field, le marbre se trouve à peu près au sud-ouest de l’emplacement du lanceur. 230,25
Acceleration.X Retourne l’accélération sur le côté. Le lanceur projette le téléphone droit vers l’avant par rapport au haut de l’écran et l’appareil ne subit donc aucune accélération de côté. 0
Acceleration.Y Retourne l’accélération de l’avant de l’appareil vers l’arrière. Le lanceur impulse initialement à l’appareil une grande accélération lors du lancer, de 0 à 90 km/h (132 pieds par seconde) en une demi-seconde. Une fois l’appareil en l’air, en ignorant la friction de l’air, l’appareil n’accélère plus. Le téléphone ralentit lorsque le receveur le réceptionne et l’arrête. 8.2, lorsque le lanceur projette l’appareil.

0, pendant que l’appareil est en l’air.

-8.2, lorsque le receveur réceptionne l’appareil.
Acceleration.Z Retourne l’accélération de l’avant de l’appareil vers l’arrière. En l’air, l’appareil subit les effets de la gravité. 0, avant que le lanceur ne projette l’appareil.

1, pendant que l’appareil est en l’air.

0, après réception de l’appareil par le receveur.
Acceleration Retourne l’accélération en tant qu’enregistrement. { X : 0, Y : 264, Z : 0 } lorsque le lanceur projette l’appareil.
Connection.Connected Retourne une valeur booléenne qui indique si l’appareil est connecté à un réseau. true
Connection.Metered Retourne une valeur booléenne qui indique si la connexion est limitée. true
App.ActiveScreen = PlayBall Retourne une valeur booléenne qui indique si PlayBall est affiché. true
App.ActiveScreen.Fill Retourne la couleur d’arrière-plan de l’écran affiché. Color.Green