Acceleration-, App-, Compass-, Connection- ja Location-signaalit Power Appsissa
Soveltuu:
Pohjaan perustuvat sovellukset Mallipohjaiset sovellukset
Palauttavat tietoja sovelluksen ympäristöstä, kuten käyttäjän sijainnin maailmassa ja tiedon siitä, mikä näyttö näytetään.
Kuvaus ja syntaksi
Signaalit ovat arvoja, jotka voivat muuttua milloin tahansa, riippumatta siitä, miten käyttäjä voi olla yhteydessä sovellukseen. Signaaleihin perustuvat kaavat laskevat automaattisesti uudelleen, kun nämä arvot muuttuvat.
Signaalit palauttavat yleensä tietueen tiedoista. Voit käyttää tietoja ja tallentaa ne tietueeksi. Voit myös poimia yksittäisiä ominaisuuksia käyttämällä .-operaattoria
Muistiinpano
Acceleration- ja Compass-funktiot palauttavat tarkat arvot alkuperäisessä toistimessa, kuten iOS- tai Android-laitteessa, mutta sovellus luodaan tai sitä muokataan selaimessa, ne palauttavat nolla-arvot.
Nopeuttaminen
Acceleration-signaali palauttaa laitteen kiihtyvyyden kolmessa ulottuvuudessa suhteessa laitteen näyttöön. Kiihtyvyys mitataan g-yksikköinä 9,81 m/s2 tai 32,2 ft/s2 (maan vetovoiman aiheuttama kiihtyvyys maan pinnalla).
| Ominaisuus | Kuvaus |
|---|---|
| Acceleration.X | Oikealle ja vasemmalle. Oikea on positiivinen luku. |
| Acceleration.Y | Eteenpäin ja taaksepäin. Eteenpäin on positiivinen luku. |
| Acceleration.Z | Ylös ja alas. Ylös on positiivinen luku. |
Sovellus
App-objektissa on muiden ominaisuuksien ohella signaali, joka ilmaisee, mikä näyttö on näkyvissä.
| Ominaisuus | Kuvaus |
|---|---|
| App.ActiveScreen | Näkyvissä oleva näyttö. Palauttaa näytön ohjausobjektin, jota voit käyttää viittaamaan näytön ominaisuuksiin tai vertaamaan toiseen näyttöön määrittääksesi, mikä näyttö näytetään. Voit muuttaa näkyvissä olevaa näyttöä Back- tai Navigate-funktiolla. |
Lisätietoja on App-objektin dokumentaatiossa.
Compass
Compass-signaali palauttaa näytön ylälaidan kompassisuunnan. Suunta perustuu magneettiseen pohjoiseen.
| Ominaisuus | Kuvaus |
|---|---|
| Compass.Heading | Suunta asteina. Palauttaa luvun väliltä 0–360. 0 on pohjoinen. |
Yhteys
Connection-signaali palauttaa tietoja verkkoyhteydestä. Jos käytät käytön mukaan laskutettavaa yhteyttä, sinun kannattaa rajoittaa verkon kautta lähetettävän ja vastaanotettavan tiedon määrää. Jos taas sovelluksesi on otettu käyttöön offline-käyttöä varten, voi kannattaa näyttää eri tietoja kulloisenkin synkronointitilan mukaan.
| Ominaisuus | Description |
|---|---|
| Connection.Connected | Palauttaa totuusarvon true tai false, joka ilmaisee, onko laite yhdistetty verkkoon. |
| Connection.Metered | Palauttaa totuusarvon true tai false, joka ilmaisee, onko yhteys käytön mukaan laskutettava. |
| Connection.Sync | Palauttaa luetteloinnin nimeltä ConnectionSync, joka sisältää offline-tilassa käytettäväksi määritetyn sovelluksen kulloisenkin synkronointitilan. |
Alla ovat Connection.Sync-luetteloinnin luettelointiarvot.
| Luettelointiarvo | Description |
|---|---|
| Connected | Laitteesi on yhdistetty verkkoon, ja sovelluksesi on valmis toimimaan offline-tilassa |
| ConnectedWithWarning | Laitteesi on yhteydessä varoituksella. |
| ConnectedPendingUpsync | Tietyt laitteellasi olevat tiedot on synkronoitava palveluna kanssa. |
| ConnectedError | Viimeisimmässä synkronointiyrityksessä tapahtui virhe. |
| ConnectedRefresh | Sovellus suorittaa tällä hetkellä tietojen synkronointia palvelun kanssa. |
| NotConnected | Laitteesi ei ole yhdistettynä palveluun. |
| NotConnectedWithWarning | Viimeisin synkronointivaroitus. |
| NotConnectedPendingUpsync | Laitteessasi on päivityksiä, jotka odottavat synkronointia. |
| NotConnectedSyncError | Viimeisin synkronointivirhe. |
Sijainti
Location-signaali palauttaa laitteen sijainnin GPS-järjestelmän ja laitteen muiden tietojen, kuten maston viestinnän ja IP-osoitteen, perusteella.
Kun käyttäjä käyttää sijaintitietoja ensimmäisen kerran, laite voi pyytää käyttäjää sallimaan näiden tietojen käytön.
Kun sijainti muuttuu, sijainnin riippuvaisuudet lasketaan jatkuvasti uudelleen. Tämä kuluttaa laitteen akun virtaa. Akun säästämiseksi voit käyttää Enable- ja Disable-funktioita ottaaksesi sijaintipäivitykset käyttöön ja poistaaksesi ne käytöstä. Sijainti on automaattisesti poistettu käytöstä, jos näytetty näyttö ei ole riippuvainen sijaintitiedoista.
| Ominaisuus | Kuvaus |
|---|---|
| Location.Altitude | Palauttaa luvun, joka ilmaisee korkeutta merenpinnan yläpuolella metreinä mitattuna. |
| Location.Latitude | Palauttaa luvun väliltä -90–90, joka ilmaisee leveysasteen mitattuna asteina päiväntasaajalta. Positiivinen luku ilmaisee päiväntasaajan pohjoispuolella olevaa sijaintia. |
| Location.Longitude | Palauttaa luvun väliltä -180–180, joka ilmaisee pituusasteen mitattuna asteina Greenwichistä, Englannista. Positiivinen luku ilmaisee Greenwhichin itäpuolella olevaa sijaintia. |
Esimerkkejä
Baseball-kentällä syöttäjä heittää laitteen kotipesällä olevalle siepparille. Puhelin on suorassa linjassa suhteessa maahan, näytön yläosa on siepparia kohden eikä syöttäjä lisää heittoon kierrettä. Tässä sijainnissa puhelimessa on käytön mukaan laskutettava mobiiliverkkopalvelu, mutta ei Wi-Fi-yhteyttä. PlayBall-näyttö tulee näkyviin. Sovellus on valmiina käytettäväksi offline-tilassa ja yhteydessä palveluun.
| Kaava | Description | Result |
|---|---|---|
| Location.Latitude | Palauttaa nykyisen sijainnin leveysasteen. Kenttä sijaitsee kartan koordinaateissa 47.591 N, 122.333 W. | 47.591 Leveysaste muuttuu jatkuvasti, kun pallo kulkee syöttäjän ja siepparin välillä. |
| Location.Longitude | Palauttaa nykyisen sijainnin pituusasteen. | 122.333 Pituusaste muuttuu jatkuvasti, kun pallo kulkee syöttäjän ja siepparin välillä. |
| Location | Palauttaa nykyisen sijainnin leveysasteen ja pituusasteen tietueena. | { Latitude: 47.591, Longitude: 122.333 } |
| Compass.Heading | Palauttaa näytön ylälaidan kompassisuunnan. Kentän kotipesä on kutakuinkin lounaaseen syöttäjän kummulta. | 230.25 |
| Acceleration.X | Palauttaa laitteen kiihtyvyyden sivuttain. Syöttäjä heittää puhelimen suoraan eteenpäin suhteessa näytön ylälaitaan, joten laite ei kiihdy sivuttain. | 0 |
| Acceleration.Y | Palauttaa laitteen kiihtyvyyden edestä taaksepäin. Syöttäjä saa heittäessään laitteen kiihtymään aluksi voimakkaasti, niin että sen nopeus kasvaa nollasta 90 mailiin tunnissa (132 jalkaa sekunnissa) puolessa sekunnissa. Kun laite on ilmassa (eikä ilmanvastusta huomioida), laite ei kiihdy enempää. Laitteen kiihtyvyys hidastuu, kun sieppari ottaa kopin, ja lopulta laitteen liike pysähtyy. | 8.2, kun syöttäjä heittää laitteen. 0, kun laite on ilmassa. -8.2, kun sieppari ottaa laitteesta kopin. |
| Acceleration.Z | Palauttaa laitteen kiihtyvyyden alhaalta ylöspäin. Kun laite on ilmassa, painovoiman vaikutukset vaikuttavat siihen. | 0, ennen kuin syöttäjä heittää laitteen. 1, kun laite on ilmassa. 0, kun sieppari on ottanut laitteesta kopin. |
| Nopeuttaminen | Palauttaa kiihtyvyyden tietueena. | { X: 0, Y: 264, Z: 0 } kun syöttäjä heittää laitteen. |
| Connection.Connected | Palauttaa totuusarvon, joka ilmaisee, onko laite yhdistetty verkkoon | true |
| Connection.Metered | Palauttaa totuusarvon, joka ilmaisee, onko yhteys käytön mukaan laskutettava | true |
| Connection.Sync | Palauttaa luettelointiarvon, joka ilmaisee kulloisenkin synkronointitilan. | ConnectionSync.Connected |
| App.ActiveScreen = PlayBall | Palauttaa totuusarvon, joka ilmaisee, näytetäänkö PlayBall. | true |
| App.ActiveScreen.Fill | Palauttaa näkyvissä olevan näytön taustavärin. | Color.Green |