Sinais de aceleração, aplicativo, bússola, conexão e local no PowerAppsAcceleration, App, Compass, Connection, and Location signals in PowerApps

Retorna informações sobre o ambiente do aplicativo, como o lugar no qual o usuário está localizado no mundo e qual tela é exibida.Returns information about the app's environment, such as where the user is located in the world and which screen is displayed.

Descrição e sintaxeDescription and syntax

Todos os sinais retornam um registro de informações.All signals return a record of information. É possível usar e armazenar essas informações como um registro ou extrair propriedades individuais usando o .You can use and store this information as a record, or you can extract individual properties by using the . operador.operator.

AceleraçãoAcceleration

O sinal Aceleração retorna a aceleração do dispositivo em três dimensões com relação à tela do dispositivo.The Acceleration signal returns the device's acceleration in three dimensions relative to the device's screen. 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).Acceleration is measured in g units of 9.81 m/second2 or 32.2 ft/second2 (the acceleration that the Earth imparts to objects at its surface due to gravity).

Propriedade de sinalSignal Property DescriçãoDescription
Acceleration.XAcceleration.X Para a direita e para a esquerda.Right and left. Para a direita é um número positivo.Right is a positive number.
Acceleration.YAcceleration.Y Para frente e para trás.Forward and back. Para frente é um número positivo.Forward is a positive number.
Acceleration.ZAcceleration.Z Para cima e para baixo.Up and down. Para cima é um número positivo.Up is a positive number.

AplicativoApp

O sinal Aplicativo retorna informações sobre o aplicativo em execução.The App signal returns information about the running app.

Propriedade de sinalSignal Property DescriçãoDescription
App.ActiveScreenApp.ActiveScreen Tela exibida.Screen that's displayed. Retorna um objeto de tela, que pode ser usado para referenciar propriedades da tela ou comparar com outra tela para determinar qual tela é exibida.Returns a screen object, which you can use to reference properties of the screen or compare to another screen to determine which screen is displayed. Usando a função Voltar ou Navegar, é possível alterar a tela exibida.By using the Back or Navigate function, you can change the displayed screen.

BússolaCompass

O sinal Bússola retorna a direção da bússola na parte superior da tela.The Compass signal returns the compass heading of the top of the screen. A direção se baseia o norte magnético.The heading is based on magnetic north.

Propriedade de sinalSignal Property DescriçãoDescription
Compass.HeadingCompass.Heading Direção em graus.Heading in degrees. Retorna que um número de 0 a 360, e 0 é Norte.Returns a number 0 to 360, and 0 is north.

ConexãoConnection

O sinal Conexão retorna as informações sobre a conexão de rede.The Connection signal returns the information about the network connection. Em uma conexão limitada, talvez convenha limitar a quantidade de dados enviados ou recebidos pela rede.When on a metered connection, you may want to limit how much data you send or receive over the network.

Propriedade de sinalSignal Property DescriçãoDescription
Connection.ConnectedConnection.Connected Retorna um valor booliano true ou false que indica se o dispositivo está conectado a uma rede.Returns a Boolean true or false value that indicates whether the device is connected to a network.
Connection.MeteredConnection.Metered Retorna um valor booliano true ou false que indica se a conexão é limitada.Returns a Boolean true or false value that indicates whether the connection is metered.

LocalLocation

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.The Location signal returns the location of the device based on the Global Positioning System (GPS) and other device information, such as cell-tower communications and IP address.

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.When a user accesses the location information for the first time, the device may prompt that user to allow access to this information.

Conforme o local é alterado, as dependências no local serão recalculadas continuamente, o que consumirá energia da bateria do dispositivo.As the location changes, dependencies on the location will continuously recalculate, which will consume power from the device's battery. 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.To conserve battery life, you can use the Enable and Disable functions to turn location updates on and off. O local é desativado automaticamente se a tela exibida não depende de informações de localização.Location is automatically turned off if the displayed screen doesn't depend on location information.

Propriedade de sinalSignal Property DescriçãoDescription
Location.AltitudeLocation.Altitude Retorna um número que indica a altitude, medida em pés, acima do nível do mar.Returns a number that indicates the altitude, measured in feet, above sea level.
Location.LatitudeLocation.Latitude Retorna um número de -90 a 90, que indica a latitude, conforme medido em graus com base no Equador.Returns a number, from -90 to 90, that indicates the latitude, as measured in degrees from the equator. Um número positivo indica um local ao norte do Equador.A positive number indicates a location that's north of the equator.
Location.LongitudeLocation.Longitude Retorna um número de 0 a 180, que indica a latitude, medida em graus com base em graus à oeste de Greenwich, Inglaterra.Returns a number, from 0 to 180, that indicates the longitude, as measured in degrees west from Greenwich, England.

ExemplosExamples

Da base do arremessador em Safeco Field em Seattle, Washington, um arremessador de beisebol lança um telefone para um receptor na home plate.From the pitcher's mound at Safeco Field in Seattle, Washington, a baseball pitcher throws a phone to a catcher at 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.The phone is lying flat with respect to the ground, the top of the screen is pointed at the catcher, and the pitcher adds no spin. Nesse local, o telefone tem serviços de rede de celular limitada, mas nenhum WiFi.At this location, the phone has cellular network service that's metered but no WiFi. A tela PlayBall é exibida.The PlayBall screen is displayed.

FórmulaFormula DescriçãoDescription ResultadoResult
Location.LatitudeLocation.Latitude Retorna a latitude do local atual.Returns the latitude of the current location. O Safeco Field está localizado nas coordenadas de mapa 47,591 N, 122,333 O.Safeco Field is located at map coordinates 47.591 N, 122.333 W. 47,59147.591

A latitude será alterada continuamente conforme a bola se mover entre o arremessador e o receptor.The latitude will change continuously as the ball moves between the pitcher and the catcher.
Location.LongitudeLocation.Longitude Retorna a longitude do local atual.Returns the longitude of the current location. 122,333122.333

A longitude será alterada continuamente conforme a bola se mover entre o arremessador e o receptor.The longitude will change continuously as the ball moves between the pitcher and the catcher.
LocalLocation Retorna a latitude e a longitude do local atual, como um registro.Returns the latitude and longitude of the current location, as a record. { Latitude: 47,591, Longitude: 122,333 }{ Latitude: 47.591, Longitude: 122.333 }
Compass.HeadingCompass.Heading Retorna a direção da bússola da parte superior da tela.Returns the compass heading of the top of the screen. Em Safeco Field, a home plate está aproximadamente a sudoeste da base do arremessador.At Safeco Field, home plate is roughly southwest from the pitcher's mound. 230,25230.25
Acceleration.XAcceleration.X Retorna a aceleração do dispositivo lado a lado.Returns the acceleration of the device side to side. 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.The pitcher is throwing the phone straight ahead with respect to the screen's top, so the device isn't accelerating side to side. 00
Acceleration.YAcceleration.Y Retorna a aceleração do dispositivo de frente para trás.Returns the acceleration of the device front to back. 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.The pitcher initially gives the device a large acceleration when throwing the device, going from 0 to 90 miles per hour (132 feet per second) in half a second. Depois que o dispositivo está no ar, ignorando o atrito do ar, o dispositivo não acelera ainda mais.After the device is in the air, ignoring air friction, the device doesn't accelerate further. O dispositivo acelera quando o receptor o pega, fazendo-o parar.The device decelerates when the catcher catches it, bringing it to a stop. 8,2, enquanto o arremessador lança o dispositivo.8.2, while the pitcher throws the device.

0, enquanto o dispositivo está no ar.0, while the device is in the air.

-8,2, assim que o receptor pega o dispositivo.-8.2, as the catcher catches the device.
Acceleration.ZAcceleration.Z Retorna a aceleração do dispositivo de cima para baixo.Returns the acceleration of the device top to bottom. No ar, o dispositivo experimenta os efeitos da gravidade.While in the air, the device experiences the effects of gravity. 0, antes de o arremessador lançá-lo.0, before the pitcher throws the device.

1, enquanto o dispositivo está no ar.1, while the device is in the air.

0, depois que o receptor o pega.0, after the catcher catches the device.
AceleraçãoAcceleration Retorna a aceleração como um registro.Returns the acceleration as a record. { X: 0, Y: 264, Z: 0 } à medida que o receptor lança o dispositivo.{ X: 0, Y: 264, Z: 0 } as the pitcher throws the device.
Connection.ConnectedConnection.Connected Retorna um valor booliano que indica se o dispositivo está conectado a uma redeReturns a Boolean value that indicates whether the device is connected to a network truetrue
Connection.MeteredConnection.Metered Retorna um valor booliano que indica se a conexão é limitadaReturns a Boolean value that indicates whether the connection is metered truetrue
App.ActiveScreen = PlayBallApp.ActiveScreen = PlayBall Retorna um valor booliano que indica se a PlayBall é exibida.Returns a Boolean value that indicates whether PlayBall is displayed. truetrue
App.ActiveScreen.FillApp.ActiveScreen.Fill Retorna a cor da tela de fundo da tela exibida.Returns the background color for the displayed screen. Color.GreenColor.Green