Signalerna Acceleration, Program, Compass, Connection och Location i Power Apps

Gäller appar: Arbetsyteappar Modellbaserade program

Returnerar information om programmets miljö, till exempel var användaren befinner sig i världen och vilken skärm som visas.

Beskrivning och syntax

Signaler är värden som kan ändras när som helst, oberoende av hur användaren kan interagera med programmet. Formler som bygger på signaler beräknas automatiskt om när värdena ändras.

Signaler returnerar vanligtvis en post med information. Du kan använda och lagra den här informationen som en post eller så kan du extrahera enskilda egenskaper genom att använda .operator.

Kommentar

Funktionerna Acceleration och Compass returnerar exakta värden i en inbyggd spelare som på iOS eller Android, men dessa funktioner returnerar noll värden om du skapar eller ändrar en app i en webbläsare.

Acceleration

Acceleration-signalen returnerar enhetens acceleration i tre dimensioner relativt till enhetens skärm. Acceleration mäts i g-enheter på 9,81 m/sek2 eller 32.2 fot/sekund2 (den acceleration som jorden ger objekt på ytan på grund av gravitationskraften).

Egenskap Beskrivning
Acceleration.X Höger och vänster. Höger är ett positivt tal.
Acceleration.Y Framåt och bakåt. Framåt är ett positivt tal.
Acceleration.Z Upp och ned. Upp är ett positivt tal.

Program

Bland andra egenskaper innehåller Program-objektet en signal som anger vilken skärm som visas.

Egenskap Beskrivning
Program.ActiveScreen Den skärmbild som visas. Returnerar ett skärmobjekt, vilket du kan använda för att referera till skärmegenskaper eller jämföra med en annan skärm för att fastställa vilken skärm som visas. Du kan använda funktionen Back eller Navigate för att ändra skärmen som visas.

Mer information: Dokumentation om Program-objekt.

Compass

Compass-signalen returnerar kompassriktningen högst upp på skärmen. Riktningen bestäms av den magnetiska nordpolen.

Egenskap Beskrivning
Compass.Heading Riktningen i grader. Returnerar ett tal från 0 till 360, där 0 är norr.

Anslutning

Connection-signalen returnerar information om nätverksanslutningen. När du är på en avgiftsbelagd anslutning, kanske du vill begränsa hur mycket data du skickar eller tar emot via nätverket. Om appen är aktiverad offline kanske du vill visa olika typer av information beroende på det aktuella synkroniseringstillståndet.

Property Description
Connection.Connected Returnerar ett booleskt värde, true eller false, som anger om enheten är ansluten till ett nätverk.
Connection.Metered Returnerar ett booleskt värde, true eller false, som anger om anslutningen är avgiftsbelagd.
Connection.Sync Returnerar ett uppräkning kallad ConnectionSync som har det aktuella synkroniseringstillståndet för en app som är aktiverad för offline.

Nedan visas de uppräkningsvärden som är tillgängliga för Connection.Sync.

Uppräknat värde Description
Connected Enheten är ansluten till nätverket och appen är redo att arbeta offline
ConnectedWithWarning Enheten ansluts med en varning.
ConnectedPendingUpsync Vissa data på enheten måste synkroniseras med tjänsten.
ConnectedError Det uppstod ett fel vid det senaste synkroniseringsförsöket.
ConnectedRefresh Din app synkroniserar för närvarande data med tjänsten.
NotConnected Enheten är inte ansluten till tjänsten.
NotConnectedWithWarning Den sista synkroniseringsvarningen.
NotConnectedPendingUpsync Det finns uppdateringar på enheten som väntar på att synkroniseras.
NotConnectedSyncError Det senaste synkroniseringsfelet.

Plats

Location-signalen returnerar enhetens plats baserat på GPS (global positionering) och annan enhetsinformation som mobilmast-kommunikation och IP-adress.

När en användare begär åtkomst till platsinformationen för första gången, kan enheten be användaren att godkänna åtkomst till informationen.

Allteftersom platsen ändras, kommer platsens beroenden ständigt att omberäknas, vilket drar ström från enhetens batteri. För att spara på batteriet så kan du använda funktionerna Enable och Disable för att aktivera eller inaktivera platsuppdateringar. Location är automatiskt inaktiverad om den visade skärmen inte är beroende av platsinformation.

Egenskap Beskrivning
Location.Altitude Returnerar ett tal som anger höjden, mätt i meter, över havet.
Location.Latitude Returnerar ett tal från -90 till 90 som anger latitud, mätt i grader från ekvatorn. Ett positivt tal innebär en plats norr om ekvatorn.
Location.Longitude Returnerar ett tal från -180 till 180 som anger longitud, mätt i grader om Greenwich, England. Ett positivt tal innebär en plats öster om Greenwich.

Exempel

På ett baseballfält kastar kastaren en telefon från till en kastplatsen till en mottagare vid utslagsplatsen. Telefonen ligger platt relativt mot marken, skärmens topp pekar mot mottagaren och kastaren lägger inte till någon rotation. På den här platsen har telefonen mobilt internet som inte är avgiftsbelagt, men ingen WiFi. PlayBall-skärmen visas. Appen aktiveras offline och är ansluten till tjänsten.

Formel Description Result
Location.Latitude Returnerar latitud för den aktuella platsen. Fältet finns på kartkoordinaterna 47.591 N, 122.333 W. 47.591

Latituden ändras kontinuerligt allteftersom bollen rör sig mellan kastaren och mottagaren.
Location.Longitude Returnerar longituden för den aktuella platsen. 122.333

Longituden ändras kontinuerligt allteftersom bollen rör sig mellan kastaren och mottagaren.
Location Returnerar latitud och longitud för den aktuella platsen som en post. { Latitud: 47.591, Longitud: 122.333 }
Compass.Heading Returnerar compass-riktningen högst upp på skärmen. På det här fältet ligger utslagsplatsen ungefär sydväst från kastplatsen. 230.25
Acceleration.X Returnerar enhetens acceleration från sida till sida. Kastaren kastar telefonen rakt fram relativt skärmens topp så enheten accelererar inte från sida till sida. 0
Acceleration.Y Returnerar enhetens acceleration framåt till bakåt. Kastaren ger inledningsvis enheten en stor acceleration när han kastar enheten. Den går från 0 till 90 miles per timme (132 fot per sekund) på en halv sekund. När enheten är i luften, accelererar den inte med, om vi ignorerar luftfriktionen. Enhetens hastighet minskar när mottagaren fångar den, vilket stoppar den. 8,2 när kastaren kastar enheten.

0, när enheten är i luften.

-8,2, när mottagaren fångar enheten.
Acceleration.Z Returnerar enhetens acceleration från toppen till botten. Medans den befinner sig i luften så upplever enheten gravitation. 0, innan kastaren kastar enheten.

1, när enheten är i luften.

0, när mottagaren har fångat enheten.
Acceleration Returnerar accelerationen som en post. { X: 0, Y: 264, Z: 0 } när kastaren kastar enheten.
Connection.Connected Returnerar ett booleskt värde, vilket anger om enheten är ansluten till ett nätverk true
Connection.Metered Returnerar ett booleskt värde, vilket anger om anslutningen är avgiftsbelagd true
Connection.Sync Returnerar ett uppräkningsvärde som indikerar aktuellt synkroniseringstillstånd. ConnectionSync.Connected
Program.ActiveScreen = PlayBall Returnerar ett booleskt värde som anger om PlayBall visas. true
Program.ActiveScreen.Fill Returnerar bakgrundsfärgen för den visade skärmen. Color.Green