Sygnały Acceleration, App, Compass, Connection i Location w usłudze Power Apps

Dotyczy: Aplikacje kanwy Aplikacje oparte na modelu

Zwraca informacje o środowisku aplikacji, na przykład globalnej lokalizacji użytkownika i wyświetlonym ekranie.

Opis i składnia

Sygnały to wartości, które mogą się w dowolnej chwili zmienić, niezależnie od sposobu, w jaki użytkownik może pracować z aplikacją. Formuły oparte na sygnałach są automatycznie obliczane ponownie, gdy te wartości zostaną zmienione.

Sygnały przeważnie zwracają rekord zawierający informacje. Można korzystać z informacji przechowywanych w tym rekordzie albo wyodrębnić poszczególne właściwości za pomocą .operatora.

Uwaga

Funkcje Akceleracja i Kompas zwracają dokładne wartości w odtwarzaczu natywnym, np. w systemie iOS lub Android, ale te funkcje zwracają wartości zerowe w przypadku tworzenia lub modyfikowania aplikacji w przeglądarce.

Acceleration

Sygnał Acceleration zwraca wartość przyspieszenia ekranu urządzenia w trzech wymiarach. Miarą przyspieszenia jest jednostka g równa 9,81 m/s² (lub 32,2 st./s²). Jest to wartość przyspieszenia grawitacyjnego na powierzchni Ziemi.

Właściwość	Opis
Przyspieszenie.X	Kierunek prawo-lewo. Zwrot w prawo odpowiada liczbie dodatniej.
Przyspieszenie.Y	Kierunek przód-tył. Zwrot do przodu odpowiada liczbie dodatniej.
Przyspieszenie.Z	Kierunek góra-dół. Zwrot do góry odpowiada liczbie dodatniej.

App

Oprócz innych właściwości obiekt Aplikacja uwzględnia sygnał wskazujący, który ekran jest wyświetlany.

Właściwość	Opis
App.ActiveScreen	Pokazywany ekran. Zwraca obiekt ekranu, którego można użyć do odwołania do właściwości ekranu lub porównania z innym ekranem w celu ustalenia, który ekran jest wyświetlany. Możesz użyć funkcji Back lub Navigate, aby zmienić wyświetlany ekran.

Więcej informacji: dokumentacja dotycząca Appobject.

Compass

Sygnał Compass zwraca kierunek wskazywany przez kompas względem górnej części ekranu. Kierunek ten uwzględnia położenie magnetycznej północy.

Właściwość	Opis
Kompas.Nagłówek	Kierunek w stopniach. Zwraca liczbę od 0 do 360, gdzie 0 odpowiada kierunkowi północnemu.

Connection

Sygnał Connection zwraca informacje dotyczące połączenia sieciowego. Jeśli korzystasz z połączenia taryfowego, możesz chcieć ograniczyć ilość danych wysyłanych lub odbieranych przez sieć. Lub, jeśli aplikacja jest włączona dla trybu offline, możesz chcieć wyświetlać różne informacje w zależności od bieżącego stanu synchronizacji.

Właściwości	opis
Połączenie.Połączone	Zwraca wartość logiczną prawda lub fałsz, która wskazuje, czy urządzenie jest połączone z siecią.
Połączenie.Mierzone	Zwraca wartość logiczną prawda lub fałsz, która wskazuje, czy połączenie jest taryfowe.
Połączenie.Synchronizacja	Zwraca wyliczenie o nazwie ConnectionSync, które przechowuje bieżący stan synchronizacji dla aplikacji włączonej w trybie offline.

Poniżej znajdują się wartości enums dostępne dla Connection.Sync.

Wartość wyliczenia	opis
Spójny	Twoje urządzenie jest połączone z siecią, a Twoja aplikacja jest gotowa do działania w trybie offline
ConnectedWithWarning	Urządzenie jest połączone z ostrzeżeniem.
ConnectedPendingUpsync	Niektóre dane na urządzeniu muszą zostać zsynchronizowane z usługą.
Połączony błąd	Podczas ostatniej próby synchronizacji wystąpił błąd.
Połączone odświeżanie	Aplikacja synchronizuje obecnie dane z usługą.
Nie połączony	Urządzenie nie jest połączone z usługą.
NotConnectedWithWarning	Ostatnie ostrzeżenie o synchronizacji.
NotConnectedPendingUpsync	Na urządzeniu znajdują się aktualizacje oczekujące na synchronizację.
NotConnectedSyncError (Błąd synchronizacji)	Ostatni błąd synchronizacji.

Lokalizacja

Sygnał Location zwraca lokalizację urządzenia na podstawie systemu GPS i innych informacji, takich jak dane komunikacyjne ze stacjami bazowymi sieci komórkowych i adres IP urządzenia.

Przy pierwszej próbie uzyskania dostępu do informacji o lokalizacji może zostać wyświetlony monit o zezwolenie na dostęp do tych informacji.

Wraz ze zmianą lokalizacji stale zmieniają się obliczenia dotyczące jej zależności, co zużywa energię z baterii urządzenia. Aby oszczędzać energię baterii, można za pomocą funkcji Enable i Disable włączać i wyłączać aktualizacje lokalizacji. Lokalizacja jest automatycznie wyłączana, jeśli wyświetlany ekran nie korzysta z informacji o lokalizacji.

Właściwość	Opis
Lokalizacja.Wysokość n.p.m.	Zwraca wysokość nad poziomem morza, mierzoną w metrach.
Lokalizacja.Szerokość geograficzna	Zwraca liczbę od -90 do 90 odpowiadającą szerokości geograficznej mierzonej w stopniach. Liczba dodatnia wskazuje na lokalizację znajdującą się na północ od równika.
Lokalizacja.Długość geograficzna	Zwraca liczbę od -180 do 180 odpowiadającą długości geograficznej mierzonej w stopniach od Greenwich w Anglii. Liczba dodatnia oznacza lokalizację na wschód od Greenwich.

Przykłady

Na stadionie baseballowym miotacz zajmuje pozycję do rzutu i rzuca telefon w stronę łapacza znajdującego się w bazie domowej. Telefon leci równolegle do ziemi, górna część jego ekranu jest skierowana w stronę łapacza i nie występuje obrót urządzenia. Telefon jest połączony z taryfową siecią komórkową, ale nie jest połączony z siecią Wi-Fi. Wyświetlony jest ekran PlayBall. Aplikacja działa w trybie offline i jest połączona z usługą.

Formuła	opis	Result
Lokalizacja.Szerokość geograficzna	Zwraca szerokość geograficzną bieżącej lokalizacji. Stadion ma współrzędne geograficzne 47,591°N i 122,333°W.	47.591 Szerokość geograficzna stale się zmienia, gdy piłka przemieszcza się w kierunku łapacza.
Lokalizacja.Długość geograficzna	Zwraca długość geograficzną bieżącej lokalizacji.	122.333 Długość geograficzna stale się zmienia, gdy piłka przemieszcza się w kierunku łapacza.
Lokalizacja	Zwraca współrzędne geograficzne bieżącej lokalizacji w postaci rekordu.	{ Latitude: 47.591, Longitude: 122.333 }
Kompas.Nagłówek	Zwraca kierunek wskazywany przez kompas względem górnej części ekranu. Na tym stadionie baza domowa znajduje się nieco na południowy zachód od położenia miotacza.	230.25
Przyspieszenie.X	Zwraca wartość przyspieszenia bocznego urządzenia. Podczas rzutu góra ekranu urządzenia jest skierowana prosto, więc nie występuje przyspieszenie boczne.	0
Przyspieszenie.Y	Zwraca wartość przyspieszenia wzdłużnego urządzenia. W początkowej fazie rzutu urządzenie doznaje dużego przyspieszenia — w ciągu pół sekundy jego prędkość rośnie od 0 do 90 mil na godzinę (132 stopy na sekundę). Gdy urządzenie leci nad ziemią, już nie przyspiesza (opór powietrza jest pomijany). Gdy łapacz chwyci urządzenie, zwalnia ono aż do całkowitego zatrzymania.	8,2 w początkowej fazie rzutu. 0, gdy urządzenie znajduje się w powietrzu. -8,2 po chwyceniu urządzenia przez łapacza.
Przyspieszenie.Z	Zwraca wartość przyspieszenia urządzenia skierowanego w dół. W fazie lotu na urządzenie działa siła grawitacji.	0 w początkowej fazie rzutu. 1, gdy urządzenie znajduje się w powietrzu. 0 po chwyceniu urządzenia przez łapacza.
Przyspieszenie	Zwraca wartość przyspieszenia w postaci rekordu.	{ X: 0, Y: 264, Z: 0 } w początkowej fazie rzutu.
Połączenie.Połączone	Zwraca wartość logiczną, która wskazuje, czy urządzenie jest połączone z siecią	prawdziwy
Połączenie.Mierzone	Zwraca wartość logiczną, która wskazuje, czy połączenie jest taryfowe	prawdziwy
Połączenie.Synchronizacja	Zwraca wartość wyliczeniową wskazującą bieżący stan synchronizacji.	ConnectionSync.Connected
App.ActiveScreen = Piłka do gry	Zwraca wartość logiczną, która wskazuje, czy wyświetlony jest ekran PlayBall.	prawdziwy
App.ActiveScreen.Fill	Zwraca kolor tła wyświetlanego ekranu.	Kolor.Zielony