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

Todos 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.

Aceleração

O sinal Aceleração retorna a aceleração do dispositivo em três dimensões com relação à tela do dispositivo. A aceleração é 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 de sinal Descrição
Acceleration.X Para a direita e para a esquerda. Para a direita é um número positivo.
Acceleration.Y Para frente e para trás. Para frente é um número positivo.
Acceleration.Z Para cima e para baixo. Para cima é um número positivo.

Aplicativo

O sinal Aplicativo retorna informações sobre o aplicativo em execução.

Propriedade de sinal Descrição
App.ActiveScreen Tela exibida. Retorna um objeto de tela, que pode ser usado para referenciar propriedades da tela ou comparar com outra tela para determinar qual tela é exibida. Usando a função Voltar ou Navegar, é possível alterar a tela exibida.

Bússola

O sinal Bússola retorna a direção da bússola na parte superior da tela. A direção se baseia o norte magnético.

Propriedade de sinal Descrição
Compass.Heading Direção em graus. Retorna que um número de 0 a 360, e 0 é Norte.

Conexão

O sinal Conexão 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.

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

Local

O sinal Local 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 Habilitar e Desabilitar para ligar e desligar as atualizações de localização. O local é desativado automaticamente se a tela exibida não depende de informações de localização.

Propriedade de sinal Descrição
Location.Altitude Retorna um número que indica a altitude, medida em pés, 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 0 a 180, que indica a latitude, medida em graus com base em graus à oeste de Greenwich, Inglaterra.

Exemplos

Da base do arremessador em Safeco Field em Seattle, Washington, um arremessador de beisebol lança um telefone para um receptor na home plate. 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.

Fórmula Descrição Resultado
Location.Latitude Retorna a latitude do local atual. O Safeco Field 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.
Local 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. Em Safeco Field, a home plate 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 ainda 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
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