Die Signale „Acceleration“, „App“, „Compass“, „Connection“ und „Location“ in Power Apps
Gilt für:
Canvas-Apps Modellgesteuerte Apps
Gibt Informationen zur App-Umgebung zurück, z.B. den Standort des Benutzers und welcher Bildschirm angezeigt wird
Beschreibung und Syntax
Signale sind Werte, die sich jederzeit ändern können, unabhängig davon, wie der Benutzer mit der App interagiert. Formeln, die auf Signalen basieren, werden automatisch neu berechnet, wenn sich diese Werte ändern.
Signale geben typischerweise eine Aufzeichnung von Informationen zurück. Sie können diese Informationen als Datensatz verwenden und speichern oder einzelne Eigenschaften mithilfe des ..Operator.
Notiz
Die Funktionen Beschleunigung und Kompass geben in einem nativen Player genaue Werte zurück, z.B. auf iOS oder Android, aber diese Funktionen geben Nullwerte zurück, wenn Sie eine App im Browser erstellen oder ändern.
Acceleration
Das Signal Acceleration gibt die Beschleunigung des Geräts dreidimensional im Verhältnis zum Bildschirm des Geräts zurück. Die Beschleunigung wird in g-Einheiten von 9,81 m/Sekunde2 oder 32,2 ft/Sekunde2 gemessen (die Erdbeschleunigung wird aufgrund der Schwerkraft an Objekte auf der Erdoberfläche übertragen).
| Eigenschaft | Beschreibung |
|---|---|
| Acceleration.X | Rechts und links. Rechts ist eine positive Zahl. |
| Acceleration.Y | Vorwärts und zurück. Vorwärts ist eine positive Zahl. |
| Acceleration.Z | Hoch und herunter. Hoch ist eine positive Zahl. |
App
Neben anderen Eigenschaften enthält das Objekt App ein Signal, das angibt, welcher Bildschirm angezeigt wird.
| Eigenschaft | Beschreibung |
|---|---|
| App.ActiveScreen | Bildschirm, der gerade gezeigt wird. Gibt ein Bildschirmobjekt zurück, das Sie zum Verweisen auf Bildschirmeigenschaften oder Vergleichen mit einem anderen Bildschirm verwenden können, um zu bestimmen, welcher Bildschirm angezeigt wird. Sie können die Funktion Back oder Navigate verwenden, um den angezeigten Bildschirm zu ändern. |
Weitere Informationen: App Objekt-Dokumentation.
Compass
Das Signal Compass gibt die Kompassausrichtung des oberen Bildschirmrands zurück. Die Ausrichtung basiert auf dem elektromagnetischen Norden.
| Eigenschaft | Beschreibung |
|---|---|
| Compass.Heading | Ausrichtung in Grad. Gibt eine Zahl von 0 bis 360 zurück, 0 ist Norden. |
Verbindung
Das Signal Connection gibt die Informationen über die Netzwerkverbindung zurück. Bei einer getakteten Verbindung empfiehlt es sich, die über das Netzwerk gesendeten oder empfangenen Daten zu beschränken. Wenn Ihre App offline aktiviert ist, möchten Sie möglicherweise je nach aktuellem Synchronisierungsstatus unterschiedliche Informationen anzeigen.
| Eigenschaften | Beschreibung |
|---|---|
| Connection.Connected | Gibt einen booleschen Wert TRUE oder FALSE zurück, der angibt, ob das Gerät mit einem Netzwerk verbunden ist |
| Connection.Metered | Gibt einen booleschen Wert TRUE oder FALSE zurück, der angibt, ob die Verbindung getaktet ist |
| Connection.Sync | Gibt eine Enumeration mit dem Namen ConnectionSync zurück, die den aktuellen Synchronisierungsstatus für eine App enthält, die offline aktiviert ist. |
Nachfolgend finden Sie die für Connection.Sync verfügbaren Enumerationswerte.
| Enumerationswert | Beschreibung |
|---|---|
| Connected | Das Gerät ist mit dem Netzwerk verbunden, und die App ist bereit für den Offlinebetrieb. |
| ConnectedWithWarning | Ihr Gerät ist mit einer Warnung verbunden. |
| ConnectedPendingUpsync | Einige Daten auf Ihrem Gerät müssen mit dem Dienst synchronisiert werden. |
| ConnectedError | Beim letzten Synchronisierungsversuch ist ein Fehler aufgetreten. |
| ConnectedRefresh | Ihre App synchronisiert derzeit Daten mit dem Dienst. |
| NotConnected | Ihr Gerät ist nicht mit dem Dienst verbunden. |
| NotConnectedWithWarning | Die letzte Synchronisierungswarnung. |
| NotConnectedPendingUpsync | Auf Ihrem Gerät sind Updates vorhanden, die darauf warten, synchronisiert zu werden. |
| NotConnectedSyncError | Der letzte Synchronisierungsfehler. |
Ort
Das Signal Location gibt den Standort des Geräts anhand des Globalen Positionsbestimmungssystems (GPS) und anderer Geräteinformationen zurück, z.B. der Kommunikation von Funktürmen und der IP-Adresse.
Wenn ein Benutzer zum ersten Mal auf die Positionsinformationen zugreift, kann das Gerät diesen Benutzer dazu auffordern, Zugriff auf diese Informationen zu erteilen.
Wenn sich der Standort ändert, werden Abhängigkeiten vom Standort kontinuierlich neu berechnet, was die Batterieleistung beeinträchtigt. Um Akkulaufzeit zu erhöhen, können Sie die Standortupdates mithilfe der Funktionen Enable und Disable an- und ausschalten. Das Signal „Location“ wird automatisch deaktiviert, wenn der angezeigte Bildschirm nicht von Standortinformationen abhängig ist.
| Eigenschaft | Beschreibung |
|---|---|
| Location.Altitude | Gibt eine Zahl zurück, die die Höhe über dem Meeresspiegel, gemessen in Metern, angibt. |
| Location.Latitude | Gibt eine Zahl zwischen -90 und 90 zurück, die den Breitengrad vom Äquator aus in Grad angibt. Eine positive Zahl gibt einen Standort nördlich vom Äquator an. |
| Location.Longitude | Gibt eine Zahl zwischen -180 und 180 zurück, die den Längengrad westwärts von Greenwich, England in Grad angibt. Eine positive Zahl gibt einen Standort östlich von Greenwhich an. |
Beispiele
Auf einem Baseballfeld wirft ein Pitcher ein Telefon vom Pitcher-Hügel auf einen Fänger am Home Plate. Das Telefon fliegt flach über dem Boden, der obere Bildschirmrand zeigt auf den Catcher, und der Pitcher fügt kein Drehmoment hinzu. In diesem Moment hat das Telefon getakteten Mobilfunknetzdienst, jedoch kein WLAN. Die PlayBall-Bildschirm wird angezeigt. Die App ist offline aktiviert und mit dem Dienst verbunden.
| Formel | Beschreibung | Result |
|---|---|---|
| Location.Latitude | Gibt den Breitengrad der aktuellen Position zurück. Das Feld befindet sich bei den Kartenkoordinaten 47,591 N, 122,333 W. | 47.591 Der Breitengrad wird fortlaufend geändert, während sich der Ball vom Pitcher zum Catcher bewegt. |
| Location.Longitude | Gibt den Längengrad der aktuellen Position zurück | 122.333 Der Längengrad wird fortlaufend geändert, während sich der Ball vom Pitcher zum Catcher bewegt. |
| Location | Gibt den Längen- und Breitengrad des aktuellen Standorts in einem Datensatz zurück | { Breitengrad:47,591, Längengrad:122,333 } |
| Compass.Heading | Gibt die Kompassausrichtung des oberen Bildschirmrands zurück In diesem Feld befindet sich die Home Plate ungefähr südwestlich des Wurfhügels. | 230.25 |
| Acceleration.X | Gibt die Beschleunigung des Geräts von linkem zu rechtem Rand an. Der Pitcher wirft das Gerät in Bezug auf den oberen Bildschirmrand geradeaus, sodass das Gerät nicht von Seite zu Seite beschleunigt. | 0 |
| Acceleration.Y | Gibt die Beschleunigung des Geräts zwischen Vorder- und Rückseite an. Der Pitcher beschleunigt das Gerät anfänglich durch den Wurf erheblich, von 0 auf 90 Meilen pro Stunde (132 Fuß pro Sekunde) innerhalb einer halben Sekunde. Einmal in der Luft beschleunigt das Telefon, wenn die Luftreibung außen vor gelassen wird, nicht weiter. Das Gerät wird verlangsamt, wenn der Catcher es fängt, und wird angehalten. | 8.2, während der Pitcher das Geräts wirft 0, während sich das Gerät in der Luft befindet -8.2, während der Catcher das Gerät fängt |
| Acceleration.Z | Gibt die Beschleunigung des Geräts vom oberen zum unteren Rand an. Das Telefon unterliegt in der Luft den Auswirkungen der Schwerkraft. | 0, bevor der Pitcher das Geräts wirft 1, während sich das Gerät in der Luft befindet 0, nachdem der Catcher das Gerät gefangen hat |
| Acceleration | Gibt die Beschleunigung als Datensatz zurück | { X: 0, Y: 264, Z: 0 } während der Pitcher das Telefon wirft |
| Connection.Connected | Gibt einen booleschen Wert zurück, der angibt, ob das Gerät mit einem Netzwerk verbunden ist | true |
| Connection.Metered | Gibt einen booleschen Wert zurück, der angibt, ob die Verbindung getaktet ist | true |
| Connection.Sync | Gibt einen Enumerationswert zurück, der den aktuellen Synchronisierungsstatus angibt. | ConnectionSync.Connected |
| App.ActiveScreen = PlayBall | Gibt einen booleschen Wert zurück, der angibt, ob PlayBall angezeigt wird. | true |
| App.ActiveScreen.Fill | Gibt die Hintergrundfarbe des angezeigten Bildschirms zurück | Color.Green |