Acceleration-, App-, Compass-, Connection- ja Location-signaalit Power Appsissa

Koskee seuraavia: 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/s² tai 32,2 ft/s² (maan vetovoiman aiheuttama kiihtyvyys maan pinnalla).

Ominaisuus	Kuvaus
Kiihtyvyys.X	Oikealle ja vasemmalle. Oikea on positiivinen luku.
Kiihtyvyys.Y	Eteenpäin ja taaksepäin. Eteenpäin on positiivinen luku.
Kiihtyvyys.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
Kompassi.Suunta	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
Yhteys.Yhdistetty	Palauttaa totuusarvon true tai false, joka ilmaisee, onko laite yhdistetty verkkoon.
Yhteys.Mitattu	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
Yhdistetty	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
Sijainti.Korkeus	Palauttaa luvun, joka ilmaisee korkeutta merenpinnan yläpuolella metreinä mitattuna.
Sijainti.Leveysaste	Palauttaa luvun väliltä -90–90, joka ilmaisee leveysasteen mitattuna asteina päiväntasaajalta. Positiivinen luku ilmaisee päiväntasaajan pohjoispuolella olevaa sijaintia.
Sijainti.Pituusaste	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
Sijainti.Leveysaste	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ä.
Sijainti.Pituusaste	Palauttaa nykyisen sijainnin pituusasteen.	122.333 Pituusaste muuttuu jatkuvasti, kun pallo kulkee syöttäjän ja siepparin välillä.
Paikka	Palauttaa nykyisen sijainnin leveysasteen ja pituusasteen tietueena.	{ Latitude: 47.591, Longitude: 122.333 }
Kompassi.Suunta	Palauttaa näytön ylälaidan kompassisuunnan. Kentän kotipesä on kutakuinkin lounaaseen syöttäjän kummulta.	230.25
Kiihtyvyys.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
Kiihtyvyys.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.
Kiihtyvyys.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.
Kiihtyvyys	Palauttaa kiihtyvyyden tietueena.	{ X: 0, Y: 264, Z: 0 } kun syöttäjä heittää laitteen.
Yhteys.Yhdistetty	Palauttaa totuusarvon, joka ilmaisee, onko laite yhdistetty verkkoon	tosi
Yhteys.Mitattu	Palauttaa totuusarvon, joka ilmaisee, onko yhteys käytön mukaan laskutettava	tosi
Connection.Sync	Palauttaa luettelointiarvon, joka ilmaisee kulloisenkin synkronointitilan.	ConnectionSync.Connected
App.ActiveScreen = PlayBall	Palauttaa totuusarvon, joka ilmaisee, näytetäänkö PlayBall.	tosi
App.ActiveScreen.Fill	Palauttaa näkyvissä olevan näytön taustavärin.	Väri.Vihreä