Sinais de Acceleration, App, Compass, Connection e Location no Power Apps
Aplica-se a:
Aplicações de tela Aplicações condicionadas por modelo
Devolve informações sobre o ambiente da aplicação, como, por exemplo, onde o utilizador está localizado no mundo e que ecrã é apresentado.
Descrição e sintaxe
Os sinais são valores que podem mudar a qualquer momento, independentemente da forma como o utilizador possa estar a interagir com a aplicação. As fórmulas baseadas em sinais são recalculadas automaticamente à medida que estes valores mudam.
Os sinais tipicamente devolvem um registo de informações. Pode utilizar e armazenar estas informações como um registo ou pode extrair propriedades individuais utilizando o .operador.
Nota
As funções Acceleration e Compass devolvem valores precisos num leitor nativo como no iOS ou Android, mas essas funções devolvem valores nulos quando cria ou modifica uma aplicação no browser.
Aceleração
O sinal de Aceleração devolve a aceleração do dispositivo em três dimensões relativamente ao ecrã do dispositivo. A aceleração é medida em unidades g de 9,81 m/segundo2 ou 32,2 ft/segundo2 (a aceleração que a Terra transmite aos objetos na sua superfície devido à gravidade).
| Propriedade | Descrição |
|---|---|
| Acceleration.X | Direita e esquerda. Direita é um número positivo. |
| Acceleration.Y | Para a frente e para trás. Para a frente é um número positivo. |
| Acceleration.Z | Para cima e para baixo. Para cima é um número positivo. |
Aplicação
Entre outras propriedades, o objeto da Aplicação inclui um sinal que indica qual o ecrã que está a ser mostrado.
| Propriedade | Descrição |
|---|---|
| App.ActiveScreen | O ecrã que é exibido. Devolve um objeto de ecrã, que poderá utilizar para fazer referência a propriedades do ecrã ou comparar com outro ecrã para determinar que ecrã é exibido. Pode utilizar a função Back ou Navigate para alterar o ecrã apresentado. |
Mais informações: documentação do objeto da Aplicação.
Compass
O sinal de Bússola devolve o rumo de bússola da parte superior do ecrã. O rumo baseia-se no norte magnético.
| Propriedade | Descrição |
|---|---|
| Compass.Heading | Rumo em graus. Devolve um número de 0 a 360 e 0 corresponde a norte. |
Ligação
O sinal de Ligação devolve as informações sobre a ligação de rede. Numa ligação com tráfego limitado, pode querer limitar a quantidade de dados que envia ou recebe na rede. Ou, se a aplicação estiver ativada para offline, poderá querer apresentar outras informações, dependendo do estado de sincronização atual.
| Property | Description |
|---|---|
| Connection.Connected | Devolve um valor Booleano verdadeiro ou falso que indica se o dispositivo está ligado a uma rede. |
| Connection.Metered | Devolve um valor Booleano verdadeiro ou falso que indica se a ligação tem tráfego limitado. |
| Connection.Sync | Devolve uma enumeração denominada ConnectionSync que detém o estado de sincronização atual de uma aplicação que está ativada para offline. |
Seguem-se os valores de enumerações disponíveis para Connection.Sync.
| Valor de enumeração | Description |
|---|---|
| Ligado | O dispositivo está ligado à rede e a aplicação está pronta para trabalhar offline |
| ConnectedWithWarning | O dispositivo está ligado com um aviso. |
| ConnectedPendingUpsync | Alguns dados no dispositivo têm de ser sincronizados com o serviço. |
| ConnectedError | Ocorreu um erro na última tentativa de sincronização. |
| ConnectedRefresh | Atualmente, a aplicação está a sincronizar dados com o serviço. |
| NotConnected | O seu dispositivo não está ligado ao serviço. |
| NotConnectedWithWarning | O último aviso de sincronização. |
| NotConnectedPendingUpsync | Existem atualizações no dispositivo que estão a aguardar sincronização. |
| NotConnectedSyncError | O último erro de sincronização. |
Localização
O sinal de Localização devolve a localização do dispositivo com base no GPS (Global Positioning System) e outras informações do dispositivo, como comunicações de torre de rede celular e endereço IP.
Quando um utilizador acede às informações de localização pela primeira vez, o dispositivo poderá solicitar a esse utilizador que permita o acesso a estas informações.
À medida que a localização muda, as dependências da localização continuam a ser recalculadas continuamente, o que consome energia da bateria do dispositivo. Para conservar a duração da bateria, pode utilizar as funções Enable e Disable para ativar e desativar as atualizações de localização. A localização é desativada automaticamente se o ecrã apresentado não depender das informações de localização.
| Propriedade | Descrição |
|---|---|
| Location.Altitude | Devolve um número que indica a altitude, medido em metros, acima do nível do mar. |
| Location.Latitude | Devolve um número, de -90 a 90, que indica a latitude, medida em graus a partir do Equador. Um número positivo indica uma localização a norte do Equador. |
| Location.Longitude | Devolve um número, de -180 a 180, que indica a longitude, medida em graus a partir de Greenwich, Inglaterra. Um número positivo indica uma localização a este de Greenwich. |
Exemplos
Num campo de basebol, um lançador de basebol lança um telemóvel a partir do montículo do lançador para um recetor na home plate. O telemóvel está na horizontal em relação ao chão, com a parte superior do ecrã voltada para o recetor, e o lançador não adiciona rotação. Nesta localização, o telemóvel tem um serviço de rede celular com tráfego limitado, mas não tem Wi-Fi. O ecrã PlayBall é apresentado. A aplicação está ativada para offline e está ligada ao serviço.
| Fórmula | Description | Result |
|---|---|---|
| Location.Latitude | Devolve a latitude da localização atual. O Safeco field está localizado nas coordenadas do mapa 47.591 N, 122.333 W. | 47.591 A latitude será alterada continuamente à medida que a bala se desloca entre o lançador e o recetor. |
| Location.Longitude | Devolve a longitude da localização atual. | 122.333 A longitude será alterada continuamente à medida que a bala se desloca entre o lançador e o recetor. |
| Location | Devolve a latitude e a longitude da localização atual, como um registo. | { Latitude: 47.591, Longitude: 122.333 } |
| Compass.Heading | Devolve o rumo de bússola da parte superior do ecrã. Neste campo, a home plate está, aproximadamente, a sudoeste do montículo do lançador. | 230.25 |
| Acceleration.X | Devolve a aceleração do dispositivo, lado a lado. O lançador está a lançar o telemóvel sempre em frente em relação à parte superior do ecrã, pelo que o dispositivo não está a acelerar lado a lado. | 0 |
| Acceleration.Y | Devolve a aceleração do dispositivo, de frente para trás. Inicialmente, o lançador dá ao dispositivo uma grande aceleração quando lança o dispositivo, que vai de 0 a 90 milhas por hora (132 pés por segundo) em meio segundo. Depois de o dispositivo estar no ar, ignorando a fricção do ar, o dispositivo não acelera mais. O dispositivo abranda quando o recetor o apanha, fazendo-o parar. | 8.2, enquanto o lançador lança o dispositivo. 0, enquanto o dispositivo está no ar. -8.2, à medida que o recetor apanha o dispositivo. |
| Acceleration.Z | Devolve a aceleração do dispositivo, de cima para baixo. Enquanto está no ar, o dispositivo sofre os efeitos da gravidade. | 0, antes de o lançador lançar o dispositivo. 1, enquanto o dispositivo está no ar. -0, depois de o recetor apanhar o dispositivo. |
| Aceleração | Devolve a aceleração como um registo. | { X: 0, Y: 264, Z: 0 } à medida que o lançador lança o dispositivo. |
| Connection.Connected | Devolve um valor Booleano que indica se o dispositivo está ligado a uma rede | verdadeiro |
| Connection.Metered | Devolve um valor Booleano que indica se a ligação tem tráfego limitado | verdadeiro |
| Connection.Sync | Devolve um valor de enumeração que indica o estado de sincronização atual. | ConnectionSync.Connected |
| App.ActiveScreen = PlayBall | Devolve um valor Booleano que indica se o ecrã PlayBall é apresentado. | verdadeiro |
| App.ActiveScreen.Fill | Devolve a cor de fundo do ecrã apresentado. | Color.Green |