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/s2 (lub 32,2 st./s2). Jest to wartość przyspieszenia grawitacyjnego na powierzchni Ziemi.
| Właściwość | Opis |
|---|---|
| Acceleration.X | Kierunek prawo-lewo. Zwrot w prawo odpowiada liczbie dodatniej. |
| Acceleration.Y | Kierunek przód-tył. Zwrot do przodu odpowiada liczbie dodatniej. |
| Acceleration.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 |
|---|---|
| Compass.Heading | 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 |
|---|---|
| Connection.Connected | Zwraca wartość logiczną prawda lub fałsz, która wskazuje, czy urządzenie jest połączone z siecią. |
| Connection.Metered | Zwraca wartość logiczną prawda lub fałsz, która wskazuje, czy połączenie jest taryfowe. |
| Connection.Sync | 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 |
|---|---|
| Połączono | Twoje urządzenie jest połączone z siecią, a Twoja aplikacja jest gotowa do działania w trybie offline |
| PołączonoZOstrzeżeniem | Urządzenie jest połączone z ostrzeżeniem. |
| PołączonoCzekanieUpsync | Niektóre dane na urządzeniu muszą zostać zsynchronizowane z usługą. |
| BłądPołączenia | Podczas ostatniej próby synchronizacji wystąpił błąd. |
| PołączonoOdświeżenie | Aplikacja synchronizuje obecnie dane z usługą. |
| NiePołączono | Urządzenie nie jest połączone z usługą. |
| NiePołączonoZOstrzeżeniem | Ostatnie ostrzeżenie o synchronizacji. |
| NiepołączonoCzekanieUpsync | Na urządzeniu znajdują się aktualizacje oczekujące na synchronizację. |
| NiepołączonoBłądSynchronizacji | 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 |
|---|---|
| Location.Altitude | Zwraca wysokość nad poziomem morza, mierzoną w metrach. |
| Location.Latitude | 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. |
| Location.Longitude | 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 |
|---|---|---|
| Location.Latitude | 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. |
| Location.Longitude | Zwraca długość geograficzną bieżącej lokalizacji. | 122.333 Długość geograficzna stale się zmienia, gdy piłka przemieszcza się w kierunku łapacza. |
| Location | Zwraca współrzędne geograficzne bieżącej lokalizacji w postaci rekordu. | { Latitude: 47.591, Longitude: 122.333 } |
| Compass.Heading | 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 |
| Acceleration.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 |
| Acceleration.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. |
| Acceleration.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. |
| Acceleration | Zwraca wartość przyspieszenia w postaci rekordu. | { X: 0, Y: 264, Z: 0 } w początkowej fazie rzutu. |
| Connection.Connected | Zwraca wartość logiczną, która wskazuje, czy urządzenie jest połączone z siecią | true |
| Connection.Metered | Zwraca wartość logiczną, która wskazuje, czy połączenie jest taryfowe | prawda |
| Connection.Sync | Zwraca wartość wyliczeniową wskazującą bieżący stan synchronizacji. | SynchronizacjaPołączenia.Połączono |
| App.ActiveScreen = PlayBall | Zwraca wartość logiczną, która wskazuje, czy wyświetlony jest ekran PlayBall. | true |
| App.ActiveScreen.Fill | Zwraca kolor tła wyświetlanego ekranu. | Color.Green |