Função para monitorar a movimentação atual de um dispositivo móvel. 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.


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 Sensors disponí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


  1. Clique nos "..." para exibir o menu de opções e, nele, clique na opção Sensors.
  2. Na opção Orientation, altere a opção "Off" para "Custom orientation".
  3. Por fim, movimente a imagem do celular e observe as alterações nos valores de orientação. São esses valores que serão inseridos nas propriedades do objeto JSON da variável "item" (Figura 2) do parâmetro Sucesso.


Nesta página