Señales Acceleration, App, Compass, Connection y Location en Power Apps

Se aplica a: Aplicaciones de lienzo Aplicaciones basadas en modelos

Devuelve información sobre el entorno de la aplicación, como dónde se encuentra el usuario en el mundo y la pantalla que se muestra.

Descripción y sintaxis

Las señales son valores que pueden cambiar en cualquier momento, independientemente de cómo el usuario pueda interactuar con la aplicación. Las fórmulas que se basan en señales se recalculan automáticamente a medida que cambian estos valores.

Por lo general, las señales devuelven un registro de información. Puede usar y almacenar esta información como un registro, o puede extraer propiedades individuales mediante el operador..

Nota

Las funciones Acceleration y Compass devuelven valores precisos en un reproductor nativo, como en iOS o Android, pero estas funciones devuelven valores de cero al crear o modificar la aplicación en el explorador.

Acceleration

La señal Acceleration devuelve la aceleración del dispositivo en tres dimensiones en relación con la pantalla del dispositivo. Acceleration se mide en unidades g de 9,81 m/s² o 32,2 ft/s² (la aceleración que imparte la Tierra en los objetos en su superficie debida a la gravedad).

Propiedad	Descripción
Acceleration.X	Derecha e izquierda. El valor de la derecha es un número positivo.
Acceleration.Y	Hacia delante y atrás. El valor hacia delante es un número positivo.
Acceleration.Z	Arriba y abajo. El valor de arriba es un número positivo.

App

Entre otras propiedades, el objeto App incluye una señal que indica qué pantalla se está mostrando.

Propiedad	Descripción
App.ActiveScreen	Pantalla que se muestra. Devuelve un objeto de la pantalla, que puede usar para hacer referencia a propiedades de la pantalla o comparar con otra pantalla para determinar qué pantalla se muestra. Puede usar la función Back o Navigate para cambiar la pantalla que se muestra.

Más información: documentación del objeto App.

Compass

La señal Compass devuelve el encabezado de brújula de la parte superior de la pantalla. El encabezado se basa en el norte magnético.

Propiedad	Descripción
Compass.Heading	Encabezado en grados. Devuelve un número entre 0 y 360, y 0 es el norte.

Connection

La señal Connection devuelve información acerca de la conexión de red. Cuando está en una conexión medida, puede que desee limitar la cantidad de datos que envíe o reciba a través de la red. O, si su aplicación está habilitada para funcionar sin conexión, es posible que desee mostrar información diferente según el estado de sincronización actual.

Property	Description
Connection.Connected	Devuelve un valor booleano true o false que indica si el dispositivo está conectado a una red.
Connection.Metered	Devuelve un valor booleano true o false que indica si se mide la conexión.
Connection.Sync	Devuelve una enumeración denominada ConnectionSync que contiene el estado de sincronización actual de una aplicación que está habilitada para estar sin conexión.

A continuación se muestran los valores de enumeración disponibles para Connection.Sync.

Valor de enumeración	Description
Connected	El dispositivo está conectado a la red, y la aplicación está lista para funcionar sin conexión
ConnectedWithWarning	Su dispositivo está conectado con una advertencia.
ConnectedPendingUpsync	Algunos datos de su dispositivo deben sincronizarse con el servicio.
ConnectedError	Hubo un error en el último intento de sincronización.
ConnectedRefresh	Su aplicación actualmente está sincronizando datos con el servicio.
NotConnected	Su dispositivo no está conectado al servicio.
NotConnectedWithWarning	La última advertencia de sincronización.
NotConnectedPendingUpsync	Hay actualizaciones en su dispositivo esperando a ser sincronizadas.
NotConnectedSyncError	El último error de sincronización.

Ubicación

La señal Location devuelve la ubicación del dispositivo según el sistema GPS (Global Positioning System) y otra información de dispositivo, como las comunicaciones de la torre de telefonía móvil y la dirección IP.

Cuando un usuario tiene acceso a la información de ubicación por primera vez, el dispositivo puede solicitar que el usuario permita el acceso a esta información.

A medida que cambia la ubicación, las dependencias de la ubicación se recalcularán continuamente, lo que consumirá corriente de la batería del dispositivo. Para conservar la vida útil de la batería, puede usar las funciones Enable y Disable para activar y desactivar las actualizaciones de la ubicación. La ubicación se desactiva automáticamente si la pantalla mostrada no depende de la información de la ubicación.

Propiedad	Descripción
Location.Altitude	Devuelve un número que indica la altitud, medida en metros, por encima del nivel del mar.
Location.Latitude	Devuelve un número, entre -90 y 90, que indica la latitud, que se mide en grados desde el ecuador. Un número positivo especifica una ubicación que esté al norte del ecuador.
Location.Longitude	Devuelve un número, entre -180 y 180, que indica la longitud, que se mide en grados desde Greenwich, Inglaterra. Un número positivo indica una ubicación que sea al este de Greenwich.

Ejemplos

En un campo de béisbol, un lanzador lanza un teléfono desde su montículo a un receptor situado en la base. El teléfono se encuentra situado horizontalmente con respecto a la tierra, la parte superior de la pantalla está orientada al receptor, y el lanzador no hace ningún giro. En esta ubicación, el teléfono tiene una cobertura medida, pero no tiene Wi-Fi. Se muestra la pantalla PlayBall. La aplicación está habilitada para estar sin conexión y está conectada al servicio.

Fórmula	Description	Result
Location.Latitude	Devuelve la latitud de la ubicación actual. El campo se encuentra en las coordenadas de mapa 47.591 N, 122.333 W.	47.591 La latitud cambiará continuamente a medida que la pelota se mueva entre el lanzador y el receptor.
Location.Longitude	Devuelve la longitud de la ubicación actual.	122.333 La longitud cambiará continuamente a medida que la pelota se mueva entre el lanzador y el receptor.
Location	Devuelve la latitud y longitud de la ubicación actual, como un registro.	{ Latitud: 47.591, Longitud: 122.333 }
Compass.Heading	Devuelve el encabezado de brújula de la parte superior de la pantalla. En este campo, la base está aproximadamente al suroeste del montículo del lanzador.	230.25
Acceleration.X	Devuelve la aceleración del dispositivo de lado a lado. El lanzador está lanzando el teléfono en línea recta con respecto a la parte superior de la pantalla, por lo que el dispositivo no cuenta con una aceleración de lado a lado.	0
Acceleration.Y	Devuelve la aceleración del dispositivo de la parte delantera a la trasera. El lanzador inicialmente ofrece al dispositivo una gran aceleración al lanzar el dispositivo, que pasa de 0 a 144 km por hora (40 metros por segundo) en medio segundo. Después de que el dispositivo esté en el aire, sin tener en cuenta la fricción del aire, no se acelera más. El dispositivo deja de acelerarse cuando el receptor lo atrapa, hasta que para.	8,2, cuando el lanzador lanza el dispositivo. 0, cuando el dispositivo está en el aire. -8,2, cuando el receptor atrapa el dispositivo.
Acceleration.Z	Devuelve la aceleración del dispositivo de arriba a abajo. Mientras está en el aire, el dispositivo experimenta los efectos de la gravedad.	0, antes de que el lanzador lance el dispositivo. 1, cuando el dispositivo está en el aire. 0, cuando el receptor atrapa el dispositivo.
Acceleration	Devuelve la aceleración como registro.	{ X: 0, Y: 264, Z: 0 } cuando el lanzador lanza el dispositivo.
Connection.Connected	Devuelve un valor booleano que indica si el dispositivo está conectado a una red.	true
Connection.Metered	Devuelve un valor booleano que indica si se mide la conexión.	true
Connection.Sync	Devuelve un valor de enumeración que indica el estado de sincronización actual.	ConnectionSync.Connected
App.ActiveScreen = PlayBall	Devuelve un valor booleano que indica si se muestra PlayBall.	true
App.ActiveScreen.Fill	Devuelve el color de fondo de la pantalla mostrada.	Color.Green