Observar aceleração
Função para monitorar a aceleração do movimentação atual de um dispositivo móvel.
Parâmetros
Nome
Tipo
Doc
Para mais informações desse recurso, consulte sua documentação oficial.
Figura 1 - Bloco Observar Aceleração
Compatibilidade
- Bloco cliente: cronapi.util.watchAcceleration()
Retorno
Retorna, por meio da variável de retorno "item", um objeto JSON contendo os dados de movimentação do dispositivo.
Parâmetros
Sucesso
Executa uma ação caso os dados de movimentação do dispositivo sejam obtidos com sucesso.
- Posição: 1
- Inglês: Success
- Tipo: Comando com retorno ("item") / Command with return ("item")
- Exemplo: uso do bloco imprimir ou Obter propriedade
Exemplo
A função abaixo mostra um exemplo de uso do bloco Observar Aceleração. Nela, utilizamos dois blocos imprime, o primeiro imprimirá, no console do navegador, o objeto JSON da variável de retorno "item" do parâmetro Sucesso e o segundo imprimirá somente uma propriedade específica desse objeto, para isso, utilizamos o bloco Obter Propriedade.
Para facilitar a visualização dos resultados de execução, vamos demonstrar este exemplo em uma aplicação web e, assim, poderemos observar os resultados no console do navegador.
| Âncora | ||||
|---|---|---|---|---|
|
Figura 2 - Exemplo de uso do bloco Observar Aceleração
A imagem a seguir mostra o resultado de execução da função da Figura 2, com a impressão do objeto JSON completo e, em seguida, apenas uma de suas propriedades. Para mais detalhes de cada propriedade exibida, acesse a documentação oficial desse recurso.
Figura 2.1 - Resultado de execução da função da Figura 2
Para testar a função acima e observar as mudanças na movimentação de um dispositivo, você pode usar a funcionalidade Sensorsdisponível no console do navegador, que permite visualizar e manipular os dados de movimentação. Em alguns navegadores, essa opção pode não estar visível, confira abaixo como ativá-la.
Figura 2.2 - Habilitando a aba Sensors no console do navegador
Retorno
A variável padrão item armazena os dados do acelerômetro. Esses dados são exibidos em formato JSON através do parâmetro Sucesso, representando as coordenadas do acelerômetro.
Compatibilidade
Cliente (mobile)
Exemplo
No exemplo da figura 1, estamos atribuindo ao retorno a variável item, e em seguida imprimimos no console do navegador, através do parâmetro Sucesso, o resultado.
Figura 1 - Bloco Observar Aceleração.
Na figura 1.1 o retorno é exibido no console do navegador contendo as informações relativas aos dados do acelerômetro.
Figura 1.1 - Retorno no console do navegador.
| Informações | ||
|---|---|---|
| ||
Em alguns navegadores a opção Sensors não está visível, ela serve para nos mostrar os dados do acelerômetro. Confira na figura 2 como habilitar essa opção. |
Figura 2 - Habilitando a aba Sensores
- Clique nos "..." para exibir o menu de opções ;Escolha a e, nele, clique na opção Sensors;.
- Na opção Orientations Orientation, altere a opção "Off"para "Custom Orientationorientation".
- Por fim, movimente a imagem . Movimente a figura do celular e observa os valores do acelerômetro mudando, são observe as alterações nos valores de orientação. São esses valores que serão inseridos na variável item (figura 1) e mostrados no parâmetro Sucesso,nas propriedades do objeto JSON da variável "item" (Figura 2) do parâmetro Sucesso.
Nesta página
| Índice |
|---|
Sobre o bloco
O acelerômetro é um sensor de movimento cuja função é monitorar o movimento do dispositivo, como inclinação, trepidação, rotação ou giro. Podemos citar como uma aplicação do acelerômetro, jogos que precisam mover o celular, como um jogo de corrida por exemplo. Para mais informações sobre esse componente, acesse a documentação oficial do Android.