Sinais de Acceleration, App, Compass, Connection e Location no Power Apps

Aplica-se a: Aplicativos de tela Aplicativos controlados 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/segundo² ou 32,2 ft/segundo² (a aceleração que a Terra transmite aos objetos na sua superfície devido à gravidade).

Propriedade	Descrição
Aceleração.X	Direita e esquerda. Direita é um número positivo.
Aceleração.Y	Para a frente e para trás. Para a frente é um número positivo.
Aceleração.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
Bússola.Rumo	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
Conexão.Conectado	Devolve um valor Booleano verdadeiro ou falso que indica se o dispositivo está ligado a uma rede.
Conexão.Medido	Devolve um valor Booleano verdadeiro ou falso que indica se a ligação tem tráfego limitado.
Conexão.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
Localização.Altitude	Devolve um número que indica a altitude, medido em metros, acima do nível do mar.
Localização.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.
Localização.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
Localização.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.
Localização.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.
Localização	Devolve a latitude e a longitude da localização atual, como um registo.	{ Latitude: 47.591, Longitude: 122.333 }
Bússola.Rumo	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
Aceleração.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
Aceleração.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.
Aceleração.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.
Conexão.Conectado	Devolve um valor Booleano que indica se o dispositivo está ligado a uma rede	verdadeiro
Conexão.Medido	Devolve um valor Booleano que indica se a ligação tem tráfego limitado	verdadeiro
Conexão.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.	Cor.Verde