O que é um giroscópio?

Um giroscópio é um pequeno sensor dentro do seu telefone, tablet ou laptop que mede a rotação em torno de três eixos. Combinado com o acelerômetro e magnetômetro, ele informa ao dispositivo para qual lado está inclinado, com que velocidade está girando e para qual direção está apontando. Esses dados alimentam a rotação automática de tela, realidade aumentada, jogos de corrida, fotos panorâmicas, contagem de passos e estabilização de imagem.

Os dispositivos modernos expõem essas informações aos navegadores da web através da API DeviceOrientationEvent. O navegador relata três ângulos — alfa, beta e gama — que juntos descrevem a orientação do dispositivo no espaço 3D em relação à Terra.

Entendendo alfa, beta e gama

Os três ângulos de orientação descrevem cada um a rotação em torno de um eixo diferente:

  • Alfa (0–360°) — Rotação em torno do eixo Z (vertical). Pense em girar o dispositivo deitado sobre uma mesa; alfa é a direção tipo bússola.
  • Beta (-180–180°) — Rotação em torno do eixo X (esquerda-direita). Esta é a inclinação frente-para-trás, como inclinar o dispositivo em sua direção ou afastá-lo de você.
  • Gama (-90–90°) — Rotação em torno do eixo Y (cima-para-baixo). Esta é a inclinação esquerda-direita, como inclinar o dispositivo para o lado.

Descrição da ferramenta

Esta ferramenta lê dados de orientação em tempo real do giroscópio do seu dispositivo e os renderiza como um modelo 3D que espelha seu movimento em tempo real. Ela também exibe os valores brutos de alfa, beta e gama em graus para que você possa verificar se o sensor está funcionando corretamente e produzindo leituras precisas.

Exemplos

Posição do dispositivo Alfa Beta Gama
Deitado, tela para cima, topo apontando N 0° 0° 0°
Mantido na vertical em modo retrato 0° 90° 0°
Inclinado com borda direita para baixo (paisagem) 0° 0° 90°
Girado 180° deitado, tela ainda para cima 180° 0° 0°

Recursos

  • Modelo 3D em tempo real que gira em sincronia com seu dispositivo
  • Leituras em tempo real de alfa, beta e gama em graus
  • Detecta se o navegador suporta a API de orientação
  • Trata solicitações de permissão do iOS para acesso de movimento
  • Mostra se os dados de orientação são absolutos (referenciados à Terra) ou relativos

Casos de uso

  • Diagnosticar um sensor com defeito — Verifique se o giroscópio do seu telefone está funcionando corretamente antes de enviá-lo para reparo ou devolvê-lo.
  • Testar aplicativos web que usam movimento — Desenvolvedores que criam experiências de RA, jogos controlados por movimento ou visualizações de VR podem validar a entrada do sensor diretamente no navegador.
  • Verificação de calibração — Confirme que os valores de orientação retornam a zero quando o dispositivo está deitado, ajudando você a detectar desvio ou descalibração.

Como funciona

A ferramenta se inscreve no evento deviceorientation do navegador, que é acionado sempre que a orientação do seu dispositivo muda. Cada evento fornece os valores atuais de alfa, beta e gama. O modelo 3D usa Three.js para converter esses ângulos em uma rotação de quaternion, aplicada com interpolação suave em cada quadro de animação para evitar tremulação.

Limitações

  • Requer um dispositivo com giroscópio integrado (a maioria dos desktops e muitos laptops não possuem um)
  • iOS Safari requer permissão explícita através de um gesto do usuário antes que os dados do sensor sejam compartilhados
  • Requer um contexto seguro (HTTPS) na maioria dos navegadores modernos
  • Alguns navegadores relatam orientação apenas quando a página está em primeiro plano

Dicas

  • Se as leituras permanecerem em zero, seu dispositivo provavelmente não possui giroscópio ou o navegador está bloqueando o acesso
  • No iOS, toque no botão "Ativar movimento" após o carregamento da página — a permissão não pode ser concedida automaticamente
  • Coloque o dispositivo deitado em uma superfície estável para confirmar os valores de linha de base antes de testar inclinações