Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Observar aceleração
Função para monitorar a aceleração do dispositivo.
Parâmetros
Nome
Tipo
Doc
movimentação atual de um dispositivo móvel. Para mais informações desse recurso, consulte sua documentação oficial.
Image Added
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 | ||||
---|---|---|---|---|
|
Image Added
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.
Image Added
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.
Image Added
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
Image Removed Cliente
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.
Image Removed
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.
Image Removed
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. |
Image Removed
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
Celulares e tablets podem ser usados em diferentes orientações, horizontal ou vertical. As aplicações precisam considerar como a orientação pode causar impacto e se adaptar ao mesmo, com a adaptação da interface para o modo vertical ou horizontal. Dentre os detectores de posição e orientação, o acelerômetro é o mais comum a ser utilizado.