Signaux Acceleration, App, Compass, Connection et Location dans Power Apps

S’applique à : Applications canevas Applications pilotées par modèle

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

Les signaux sont des valeurs qui peuvent changer à tout moment, indépendamment de la façon dont l’utilisateur peut interagir avec l’application. Les formules basées sur des signaux recalculent automatiquement lorsque ces valeurs changent.

Les signaux retournent en général 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 l’opérateur..

Note

Les fonctions Acceleration et Compass renvoient des valeurs précises dans une application publiée dans un lecteur natif comme iOS ou Android, mais ces fonctions renvoient des valeurs nulles lorsque vous créez ou modifiez une application dans le navigateur.

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/s² ou 32,2 pieds/s² (Accélération conférée par la Terre aux objets qui se trouvent à sa surface en raison de la gravité).

Propriété	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.

Application

Entre autres propriétés, l’objet Application comprend un signal qui indique quel écran affiche.

Propriété	Description
App.ActiveScreen	Écran affiché. Renvoie 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é. Vous pouvez utiliser la fonction Back ou Navigate pour changer l’écran qui s’affiche.

Plus d’informations : documentation objet App.

Compass

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

Propriété	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. Ou bien, si votre application est activée pour le mode hors connexion, vous souhaitez peut-être afficher des informations différentes en fonction de l’état de synchronisation actuel.

Property	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.
Connection.Sync	Renvoie une énumération nommée ConnectionSync qui contient l’état de synchronisation actuel d’une application activée pour le mode hors connexion.

Vous trouverez ci-dessous les valeurs d’énumération disponibles pour Connection.Sync.

Valeur d’enum	Description
Connected	Votre appareil est connecté au réseau et votre application est prête à travailler hors connexion
ConnectedWithWarning	Votre appareil est connecté avec un avertissement.
ConnectedPendingUpsync	Certaines données de votre appareil doivent être synchronisées avec le service.
ConnectedError	Une erreur s’est produite lors de la dernière tentative de synchronisation.
ConnectedRefresh	Votre application synchronise actuellement les données avec le service.
NotConnected	Votre appareil n’est pas connecté au service.
NotConnectedWithWarning	Le dernier avertissement de synchronisation.
NotConnectedPendingUpsync	Des mises à jour sur votre appareil sont en attente de synchronisation.
NotConnectedSyncError	La denière erreur de synchronisation.

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é	Description
Location.Altitude	Retourne un nombre qui indique l’altitude au-dessus du niveau de la mer, calculée en mètres.
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 -180 et 180 qui indique la longitude, exprimée en degrés à partir de Greenwich. Un nombre positif indique un emplacement à l’est de Greenwich.

Examples

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é. L’application est activée pour le mode hors connexion et est connectée au service.

Formula	Description	Result
Location.Latitude	Retourne la latitude de l’emplacement actuel. Le terrain 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. Sur le terrain, 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.
Accélération	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
Connection.Sync	Renvoie une valeur d’énumération qui indique l’état de synchronisation actuel.	ConnectionSync.Connected
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