Sinais Acceleration, App, Compass, Connection e Location no Power Apps
Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelos
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 |
---|---|
Aceleração.X | Right e left. Right é um número positivo. |
Aceleração.Y | Forward e back. Forward é um número positivo. |
Aceleração.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 |
---|---|
Aplicativo.Tela Ativa | 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 |
---|---|
Bússola.Direção | 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 |
---|---|
Conexão.Conectado | Retorna um valor booliano true ou false que indica se o dispositivo está conectado a uma rede. |
Conexão.Medida | Retorna um valor booliano true ou false que indica se a conexão é limitada. |
Conexão.Sincronização | 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 |
---|---|
Conectado | Seu dispositivo está conectado à rede e seu aplicativo está pronto para trabalhar offline |
ConectadoComAviso | Seu dispositivo está conectado com um aviso. |
ConectadoPendenteUpsync | Alguns dados no seu dispositivo devem ser sincronizados com o serviço. |
Erro conectado | Ocorreu um erro na última tentativa de sincronização. |
ConectadoAtualizar | No momento, seu aplicativo está sincronizando dados com o serviço. |
Não conectado | Seu dispositivo não está conectado ao serviço. |
NãoConectadoComAviso | O último aviso de sincronização. |
Não conectadoPendenteUpsync | Há atualizações no seu dispositivo esperando para serem sincronizadas. |
Erro de sincronização não conectado | 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 |
---|---|
Localização.Altitude | Retorna um número que indica a altitude, medida em metros, acima do nível do mar. |
Localização.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. |
Localização.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 |
---|---|---|
Localização.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. |
Localização.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. |
Localização | Retorna a latitude e a longitude do local atual, como um registro. | { Latitude: 47,591, Longitude: 122,333 } |
Bússola.Direção | 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 |
Aceleração.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 |
Aceleração.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. |
Aceleração.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. |
Conexão.Conectado | Retorna um valor booliano que indica se o dispositivo está conectado a uma rede | verdadeiro |
Conexão.Medida | Retorna um valor booliano que indica se a conexão é limitada | verdadeiro |
Conexão.Sincronização | Retorna um valor de enumeração que indica o estado de sincronização atual. | ConnectionSync.Conectado |
App.ActiveScreen = JogarBall | Retorna um valor booliano que indica se a PlayBall é exibida. | verdadeiro |
Aplicativo.Tela Ativa.Preenchimento | Retorna a cor da tela de fundo da tela exibida. | Cor.Verde |