Compartilhar via


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