Segnali di accelerazione, app, bussola, connessione e posizione in PowerAppsAcceleration, App, Compass, Connection, and Location signals in PowerApps

Restituiscono informazioni sull'ambiente dell'app, ad esempio la posizione geografica dell'utente e la schermata visualizzata.Returns information about the app's environment, such as where the user is located in the world and which screen is displayed.

Descrizione e sintassiDescription and syntax

I segnali sono valori che possono cambiare in qualsiasi momento, indipendentemente dalla modalità di interazione dell'utente con l'app.Signals are values that can change at any time, independent of how the user may be interacting with the app. Le formule basate sui segnali vengono ricalcolate automaticamente in seguito alla modifica di questi valori.Formulas that are based on signals automatically recalculate as these values change.

I segnali in genere restituiscono un record di informazioni.Signals typically return a record of information. È possibile usare e archiviare le informazioni come record o estrarre le singole proprietà usando l'operatore .You can use and store this information as a record, or you can extract individual properties by using the . operatore.operator.

Nota

Le funzioni di accelerazione e bussola restituiscono valori accurati in un lettore nativo, ad esempio in iOS o Android, ma tali funzioni restituiscono zero valori quando si crea o si modifica un'app nel browser.The Acceleration and Compass functions return accurate values in a native player such as on iOS or Android, but those functions return zero values as you create or modify an app in the browser.

AccelerationAcceleration

Il segnale Acceleration (Accelerazione) restituisce l'accelerazione del dispositivo in tre dimensioni relative alla schermata del dispositivo.The Acceleration signal returns the device's acceleration in three dimensions relative to the device's screen. L'accelerazione è misurata in unità g di 9,81 m/secondo2 o 32,2 piedi/secondo2, ovvero l'accelerazione che la Terra esercita sugli oggetti sulla superficie terrestre a causa della gravità.Acceleration is measured in g units of 9.81 m/second2 or 32.2 ft/second2 (the acceleration that the Earth imparts to objects at its surface due to gravity).

ProprietàProperty DescrizioneDescription
Acceleration.XAcceleration.X Destra e sinistra.Right and left. L'accelerazione a destra è un numero positivo.Right is a positive number.
Acceleration.YAcceleration.Y In avanti e indietro.Forward and back. L'accelerazione in avanti è un numero positivo.Forward is a positive number.
Acceleration.ZAcceleration.Z In alto e in basso.Up and down. L'accelerazione in alto è un numero positivo.Up is a positive number.

AppApp

Tra le altre proprietà, l'oggetto app include un segnale che indica la schermata visualizzata.Among other properties, the App object includes a signal that indicates which screen is showing.

ProprietàProperty DescrizioneDescription
App.ActiveScreenApp.ActiveScreen Schermata visualizzata.Screen that's showing. Restituisce un oggetto Screen, che è possibile utilizzare per fare riferimento alle proprietà dello schermo o confrontare con un'altra schermata per determinare la schermata visualizzata.Returns a screen object, which you can use to reference properties of the screen or compare to another screen to determine which screen is showing. È possibile utilizzare la funzione back o Navigate per modificare la schermata visualizzata.You can use the Back or Navigate function to change the screen that's showing.

Altre informazioni: Documentazione dell' oggetto app .More information: App object documentation.

CompassCompass

Il segnale Compass (Bussola) restituisce l'intestazione della bussola nella parte superiore della schermata.The Compass signal returns the compass heading of the top of the screen. L'intestazione è basata sul Nord magnetico.The heading is based on magnetic north.

ProprietàProperty DescrizioneDescription
Compass.HeadingCompass.Heading L'intestazione in gradi.Heading in degrees. Restituisce un numero compreso tra 0 e 360. Il numero 0 rappresenta il Nord.Returns a number 0 to 360, and 0 is north.

ConnessioneConnection

Il segnale Connection (Connessione) restituisce informazioni sulla connessione di rete.The Connection signal returns the information about the network connection. In una connessione a consumo è possibile che si voglia limitare la quantità di dati inviati o ricevuti in rete.When on a metered connection, you may want to limit how much data you send or receive over the network.

ProprietàProperty DescrizioneDescription
Connection.ConnectedConnection.Connected Restituisce un valore booleano true o false che indica se il dispositivo è connesso a una rete.Returns a Boolean true or false value that indicates whether the device is connected to a network.
Connection.MeteredConnection.Metered Restituisce un valore booleano true o false che indica se la connessione è a consumo.Returns a Boolean true or false value that indicates whether the connection is metered.

PercorsoLocation

Il segnale Location (Posizione) restituisce la posizione GPS (Global Positioning System) del dispositivo e altre informazioni sul dispositivo, ad esempio le comunicazioni dell'antenna cellulare e l'indirizzo IP.The Location signal returns the location of the device based on the Global Positioning System (GPS) and other device information, such as cell-tower communications and IP address.

Quando un utente accede alle informazioni sulla posizione per la prima volta, il dispositivo potrebbe richiedere all'utente di consentire l'accesso a queste informazioni.When a user accesses the location information for the first time, the device may prompt that user to allow access to this information.

Al cambio di posizione, le dipendenze della posizione vengono ricalcolate continuamente consumando l'energia della batteria del dispositivo.As the location changes, dependencies on the location will continuously recalculate, which will consume power from the device's battery. Per prolungare la durata della batteria, è possibile usare le funzioni Enable e Disable per attivare e disattivare gli aggiornamenti della posizione.To conserve battery life, you can use the Enable and Disable functions to turn location updates on and off. La posizione viene disattivata automaticamente se la schermata visualizzata non dipende dalle informazioni di posizione.Location is automatically turned off if the displayed screen doesn't depend on location information.

ProprietàProperty DescrizioneDescription
Location.AltitudeLocation.Altitude Restituisce un numero che indica l'altitudine, in piedi, sul livello del mare.Returns a number that indicates the altitude, measured in feet, above sea level.
Location.LatitudeLocation.Latitude Restituisce un numero compreso tra -90 e 90 che indica la latitudine, misurata in gradi dall'equatore.Returns a number, from -90 to 90, that indicates the latitude, as measured in degrees from the equator. Un numero positivo indica una posizione a Nord dell'equatore.A positive number indicates a location that's north of the equator.
Location.LongitudeLocation.Longitude Restituisce un numero compreso tra 0 e 180 che indica la longitudine, misurata in gradi a Ovest di Greenwich, Inghilterra.Returns a number, from 0 to 180, that indicates the longitude, as measured in degrees west from Greenwich, England.

EsempiExamples

In un campo di baseball, un lanciatore genera un telefono dal tumulo a un Catcher a casa.In a baseball field, a pitcher throws a phone from the pitcher's mound to a catcher at home plate. Il telefono è appoggiato di piatto rispetto al terreno, la parte superiore dello schermo è rivolta verso il ricevitore e il battitore non aggiunge alcun effetto.The phone is lying flat with respect to the ground, the top of the screen is pointed at the catcher, and the pitcher adds no spin. In questa posizione, nel telefono è disponibile un servizio di rete cellulare calcolato a consumo ma senza connessione Wi-Fi.At this location, the phone has cellular network service that's metered but no WiFi. Viene visualizzata la schermata PlayBall.The PlayBall screen is displayed.

FormulaFormula DescrizioneDescription RisultatoResult
Location.LatitudeLocation.Latitude Restituisce la latitudine della posizione corrente.Returns the latitude of the current location. Il campo si trova in coordinate mappa 47,591 N, 122,333 W.The field is located at map coordinates 47.591 N, 122.333 W. 47.59147.591

La latitudine cambia continuamente mentre la palla si sposta tra lanciatore e ricevitore.The latitude will change continuously as the ball moves between the pitcher and the catcher.
Location.LongitudeLocation.Longitude Restituisce la longitudine della posizione corrente.Returns the longitude of the current location. 122.333122.333

La longitudine cambia continuamente mentre la palla si sposta tra lanciatore e ricevitore.The longitude will change continuously as the ball moves between the pitcher and the catcher.
LocationLocation Restituisce la latitudine e la longitudine della posizione corrente, sotto forma di record.Returns the latitude and longitude of the current location, as a record. { Latitudine: 47.591, Longitudine: 122.333 }{ Latitude: 47.591, Longitude: 122.333 }
Compass.HeadingCompass.Heading Restituisce l'intestazione della bussola della parte superiore della schermata.Returns the compass heading of the top of the screen. A questo campo, la piastra Home è approssimativamente a sud-ovest dal tumulo del Pitcher.At this field, home plate is roughly southwest from the pitcher's mound. 230.25230.25
Acceleration.XAcceleration.X Restituisce l'accelerazione del dispositivo da un lato all'altro.Returns the acceleration of the device side to side. Poiché il lanciatore lancia il telefono dritto rispetto alla parte superiore dello schermo, il dispositivo non subisce accelerazione da un lato all'altro.The pitcher is throwing the phone straight ahead with respect to the screen's top, so the device isn't accelerating side to side. 00
Acceleration.YAcceleration.Y Restituisce l'accelerazione del dispositivo da fronte a retro.Returns the acceleration of the device front to back. Il lanciatore trasmette inizialmente al dispositivo un'accelerazione elevata durante il lancio, che passa da 0 a 90 miglia all'ora (132 piedi al secondo) in mezzo secondo.The pitcher initially gives the device a large acceleration when throwing the device, going from 0 to 90 miles per hour (132 feet per second) in half a second. Quando il dispositivo è in aria, ignorando l'attrito dell'aria, il dispositivo non accelera ulteriormente.After the device is in the air, ignoring air friction, the device doesn't accelerate further. Il dispositivo rallenta quando il ricevitore lo afferra bloccandolo.The device decelerates when the catcher catches it, bringing it to a stop. 8.2, quando il lanciatore lancia il dispositivo.8.2, while the pitcher throws the device.

0, mentre il dispositivo è in aria.0, while the device is in the air.

-8.2, quando il ricevitore afferra il dispositivo.-8.2, as the catcher catches the device.
Acceleration.ZAcceleration.Z Restituisce l'accelerazione del dispositivo dall'alto al basso.Returns the acceleration of the device top to bottom. Mentre è in aria, il dispositivo subisce gli effetti della gravità.While in the air, the device experiences the effects of gravity. 0, prima che il lanciatore lanci il dispositivo.0, before the pitcher throws the device.

1, mentre il dispositivo è in aria.1, while the device is in the air.

0, dopo che il ricevitore ha afferrato il dispositivo.0, after the catcher catches the device.
AccelerationAcceleration Restituisce l'accelerazione sotto forma di record.Returns the acceleration as a record. X 0, Y: 264, Z: 0} poiché il Pitcher genera il dispositivo.{ X: 0, Y: 264, Z: 0 } as the pitcher throws the device.
Connection.ConnectedConnection.Connected Restituisce un valore booleano che indica se il dispositivo è connesso a una reteReturns a Boolean value that indicates whether the device is connected to a network truetrue
Connection.MeteredConnection.Metered Restituisce un valore booleano che indica se la connessione è a consumoReturns a Boolean value that indicates whether the connection is metered truetrue
App.ActiveScreen = PlayBallApp.ActiveScreen = PlayBall Restituisce un valore booleano che indica se la schermata PlayBall è visualizzata.Returns a Boolean value that indicates whether PlayBall is displayed. truetrue
App.ActiveScreen.FillApp.ActiveScreen.Fill Restituisce il colore di sfondo per la schermata visualizzata.Returns the background color for the displayed screen. Color.GreenColor.Green