Partilhar via


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/segundo2 ou 32,2 ft/segundo2 (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