Sinais de Aceleração, Aplicação, Bússola, Ligação e Localização no Power Apps

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 Aceleração e Bússola 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 Anterior ou Navigar 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.

Propriedade Descrição
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.

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 Ativar e Desativar 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 Greenwhich.

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.

Fórmula Descrição Resultado
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.
Localização 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
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

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).