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
Accélération.X	Droite et gauche. La droite est un nombre positif.
Accélération.Y	Avant et arrière. L’avant est un nombre positif.
Accélération.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
Application 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
Boussole.Cap	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
Connexion.Connecté	Retourne une valeur booléenne true ou false qui indique si l’appareil est connecté à un réseau.
Connexion.Mesurée	Retourne une valeur booléenne true ou false qui indique si la connexion est limitée.
Connexion.Synchronisation	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
Connecté	Votre appareil est connecté au réseau et votre application est prête à travailler hors connexion
ConnectéAvecAvertissement	Votre appareil est connecté avec un avertissement.
ConnectéEn attente de synchronisation ascendante	Certaines données de votre appareil doivent être synchronisées avec le service.
Erreur de connexion	Une erreur s’est produite lors de la dernière tentative de synchronisation.
Actualiser connecté	Votre application synchronise actuellement les données avec le service.
Non connecté	Votre appareil n’est pas connecté au service.
Non connecté avec avertissement	Le dernier avertissement de synchronisation.
Non connectéEn attente de synchronisation ascendante	Des mises à jour sur votre appareil sont en attente de synchronisation.
Erreur de synchronisation non connectée	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
Localisation.Altitude	Retourne un nombre qui indique l’altitude au-dessus du niveau de la mer, calculée en mètres.
Localisation.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.
Localisation.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
Localisation.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.
Localisation.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.
Emplacement	Retourne la latitude et la longitude de l’emplacement actuel, sous forme d’enregistrement.	{ Latitude : 47.591, Longitude : 122.333 }
Boussole.Cap	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
Accélération.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
Accélération.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.
Accélération.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.
Connexion.Connecté	Retourne une valeur booléenne qui indique si l’appareil est connecté à un réseau.	vrai
Connexion.Mesurée	Retourne une valeur booléenne qui indique si la connexion est limitée.	vrai
Connexion.Synchronisation	Renvoie une valeur d’énumération qui indique l’état de synchronisation actuel.	ConnexionSync.Connecté
Application.ActiveScreen = PlayBall	Retourne une valeur booléenne qui indique si PlayBall est affiché.	vrai
Application.ActiveScreen.Fill	Retourne la couleur d’arrière-plan de l’écran affiché.	Couleur.Vert