Sinais Acceleration, App, Compass, Connection e Location no Power Apps
Aplica-se a:
Aplicativos de tela Aplicativos baseados em modelo
Retorna informações sobre o ambiente do aplicativo, como o lugar no qual o usuário está localizado no mundo e qual tela é exibida.
Descrição e sintaxe
Os sinais são valores que podem mudar a qualquer momento, independentemente de como o usuário possa estar interagindo com o aplicativo. As fórmulas baseadas em sinais recalculam automaticamente à medida que esses valores mudam.
Geralmente, os sinais retornam um registro de informações. É possível usar e armazenar essas informações como um registro ou extrair propriedades individuais usando o .operador.
Nota
As funções Acceleration e Compass retornam valores precisos em um player nativo, como no iOS ou Android, mas essas funções retornam valores zero quando um aplicativo no navegador é criado ou modificado.
Aceleração
O sinal Acceleration retorna a aceleração do dispositivo em três dimensões com relação à tela do dispositivo. A Acceleration é medida em unidades g de 9,81 m/segundo2 ou 32,2 pés/segundo2 (a aceleração que a Terra transmite aos objetos em sua superfície devido à gravidade).
| Propriedade | Descrição |
|---|---|
| Acceleration.X | Right e left. Right é um número positivo. |
| Acceleration.Y | Forward e back. Forward é um número positivo. |
| Acceleration.Z | Up e down. Up é um número positivo. |
Aplicativo
Entre outras propriedades, o objeto App inclui um sinal que indica qual tela está sendo exibida.
| Propriedade | Descrição |
|---|---|
| App.ActiveScreen | Tela que está sendo mostrada. Retorna um objeto de tela, que pode ser usado para referenciar propriedades da tela ou comparar com outra para determinar qual tela é exibida. Você pode usar a função Back ou Navigate para alterar a tela exibida. |
Mais informações: documentação do objeto App.
Compass
O sinal Compass retorna a direção da bússola na parte superior da tela. A direção se baseia no norte magnético.
| Propriedade | Descrição |
|---|---|
| Compass.Heading | Direção em graus. Retorna um número de 0 a 360, e 0 é o norte. |
Conexão
O sinal Connection retorna as informações sobre a conexão de rede. Em uma conexão limitada, talvez convenha limitar a quantidade de dados enviados ou recebidos pela rede. Ou, se o seu aplicativo estiver habilitado para uso offline, talvez você queira exibir informações diferentes, dependendo do estado de sincronização atual.
| Propriedade | Description |
|---|---|
| Connection.Connected | Retorna um valor booliano true ou false que indica se o dispositivo está conectado a uma rede. |
| Connection.Metered | Retorna um valor booliano true ou false que indica se a conexão é limitada. |
| Connection.Sync | Retorna uma enumeração chamada ConnectionSync que contém o estado de sincronização atual de um aplicativo habilitado para uso offline. |
Abaixo estão os valores de enumeração disponíveis para Connection.Sync.
| Valor de enumeração | Description |
|---|---|
| Connected | Seu dispositivo está conectado à rede e seu aplicativo está pronto para trabalhar offline |
| ConnectedWithWarning | Seu dispositivo está conectado com um aviso. |
| ConnectedPendingUpsync | Alguns dados no seu dispositivo devem ser sincronizados com o serviço. |
| ConnectedError | Ocorreu um erro na última tentativa de sincronização. |
| ConnectedRefresh | No momento, seu aplicativo está sincronizando dados com o serviço. |
| NotConnected | Seu dispositivo não está conectado ao serviço. |
| NotConnectedWithWarning | O último aviso de sincronização. |
| NotConnectedPendingUpsync | Há atualizações no seu dispositivo esperando para serem sincronizadas. |
| NotConnectedSyncError | O último erro de sincronização. |
Localização
O sinal Location retorna o local do dispositivo com base no sistema GPS e outras informações de dispositivo, como comunicações por torre de celular e o endereço IP.
Quando um usuário acessa as informações de local pela primeira vez, o dispositivo pode solicitar que esse usuário permita o acesso a essas informações.
Conforme o local é alterado, as dependências no local serão recalculadas continuamente, o que consumirá energia da bateria do dispositivo. Para conservar a vida útil da bateria, é possível usar as funções Enable e Disable para ativar e desativar as atualizações de localização. O local será desativado automaticamente se a tela exibida não depender de informações de localização.
| Propriedade | Descrição |
|---|---|
| Location.Altitude | Retorna um número que indica a altitude, medida em metros, acima do nível do mar. |
| Location.Latitude | Retorna um número de -90 a 90, que indica a latitude, conforme medido em graus com base no Equador. Um número positivo indica um local ao norte do Equador. |
| Location.Longitude | Retorna um número de -180 a 180, que indica a latitude, medida em graus com base em graus de Greenwich, Inglaterra. Um número positivo indica um local a leste de Greenwich. |
Exemplos
Em um campo de baseball, um arremessador de beisebol lança um telefone da base do arremessador para um receptor na base principal. O telefone se encontra em uma superfície plana com relação ao chão, a parte superior da tela está apontada para o receptor e o arremessador não faz a bola girar. Nesse local, o telefone tem serviços de rede de celular limitada, mas nenhum WiFi. A tela PlayBall é exibida. O aplicativo está habilitado para uso offline e conectado ao serviço.
| Fórmula | Description | Result |
|---|---|---|
| Location.Latitude | Retorna a latitude do local atual. O campo está localizado nas coordenadas de mapa 47,591 N, 122,333 O. | 47.591 A latitude será alterada continuamente conforme a bola se mover entre o arremessador e o receptor. |
| Location.Longitude | Retorna a longitude do local atual. | 122.333 A longitude será alterada continuamente conforme a bola se mover entre o arremessador e o receptor. |
| Location | Retorna a latitude e a longitude do local atual, como um registro. | { Latitude: 47,591, Longitude: 122,333 } |
| Compass.Heading | Retorna a direção da bússola da parte superior da tela. nesse campo, a base principal está aproximadamente a sudoeste da base do arremessador. | 230.25 |
| Acceleration.X | Retorna a aceleração do dispositivo lado a lado. O arremessador está lançando o telefone diretamente para frente com relação à parte superior da tela, assim, o dispositivo não está sendo acelerado lado a lado. | 0 |
| Acceleration.Y | Retorna a aceleração do dispositivo de frente para trás. O arremessador inicialmente imprime ao dispositivo uma grande aceleração ao lançá-lo, indo de 0 a 90 milhas por hora (132 pés por segundo) em meio segundo. Depois que o dispositivo está no ar, ignorando o atrito do ar, o dispositivo não acelera mais. O dispositivo acelera quando o receptor o pega, fazendo-o parar. | 8,2, enquanto o arremessador lança o dispositivo. 0, enquanto o dispositivo está no ar. -8,2, assim que o receptor pega o dispositivo. |
| Acceleration.Z | Retorna a aceleração do dispositivo de cima para baixo. No ar, o dispositivo experimenta os efeitos da gravidade. | 0, antes de o arremessador lançá-lo. 1, enquanto o dispositivo está no ar. 0, depois que o receptor o pega. |
| Aceleração | Retorna a aceleração como um registro. | { X: 0, Y: 264, Z: 0 } à medida que o receptor lança o dispositivo. |
| Connection.Connected | Retorna um valor booliano que indica se o dispositivo está conectado a uma rede | true |
| Connection.Metered | Retorna um valor booliano que indica se a conexão é limitada | true |
| Connection.Sync | Retorna um valor de enumeração que indica o estado de sincronização atual. | ConnectionSync.Connected |
| App.ActiveScreen = PlayBall | Retorna um valor booliano que indica se a PlayBall é exibida. | true |
| App.ActiveScreen.Fill | Retorna a cor da tela de fundo da tela exibida. | Color.Green |