O que Mobile-First 3D faz?
Celulares não são desktops pequenos. Construa um perfil separado, ativado por uma classe: html.mobile.
1. Detecção
const MOBILE = qs.get('m') === '1' || (qs.get('m') !== '0' &&
(matchMedia('(pointer: coarse)').matches || Math.min(innerWidth, innerHeight) < 600));
document.documentElement.classList.toggle('mobile', MOBILE);
?m=1 / ?m=0 forçam a detecção — essencial para testar em emulação de desktop.
2. Perfil de renderização
| Configuração | Desktop | Celular |
|---|---|---|
| Limite de DPR / pixels máximos | 1.5 / 3.2 MP | 1.25 / 1.0 MP |
| Passos geodésicos | 220 | 150 |
| Amostras de volume | 36 | 24 |
| Tamanho do sky bake | 768 / 512 | 384 / 256 |
| Conjunto de texturas | textures/hd (~6 MB) | textures/m (~1.2 MB) |
| Paralaxe com mouse / olhar ao redor | ativado | desativado (apenas toque; emuladores enviam eventos de mouse) |
3. Enquadramento em retrato (de onde vêm a maioria dos bugs "está cortado")
- O FOV horizontal em retrato é pequeno:
tan(hFOV/2) = tan(vFOV/2)·aspect(≈0.22 a 52° e 0.46 de aspecto). - A distância de cada assunto =
max(R·distMul·1.25, visibleRadius·7.6); visibleRadius inclui anéis (Saturno ≈ 2.35 R, Urano ≈ 1.8 R). - Aponte para o assunto, depois incline toda a visão para baixo ≈ 0.21 rad para que fique no terço superior, acima do painel de texto. (Deslocar o alvo em vez disso faz com que ele se mova lateralmente quando a câmera se move.)
- Ilumine mais frontalmente (fase ~45°): planetas iluminados lateralmente, com metade preta, parecem "cortados" em telas pequenas.
- Trave a mira durante retenções de conteúdo (tangentes do alvo zero) — sem desvio do centro.
- Verifique numericamente: renderize um quadro,
readPixelslinhas cruzando o assunto, verifique se o intervalo iluminado está dentro de 5–95 % da largura.
4. Layout
- Painéis → painel inferior:
left:0; right:0; bottom:0; max-height:60vh; overflow:auto, fundo gradiente,padding-bottom: calc(54px + env(safe-area-inset-bottom)). - Títulos
clamp(34px, 10vw, 52px); nome do herói dividido em 2 linhas. - Navegação → hambúrguer + folha desfocada em tela cheia com links serifados de 44 px.
- Oculte trilhos decorativos; encurte rótulos (apenas nome); oculte a dica de scroll de aterrissagem se colidir.
- Scroll mais curto: introdução ~320vh, jornada ~2600vh (celulares rolam mais rápido com momentum).
viewport-fit=cover, estágios fixos100svh, sem overflow horizontal a 320 px.
5. Matriz de teste (emulação não é suficiente, mas é o mínimo)
375×812 e 390×844 retrato, 412×915 Android, 768×1024 tablet. Cada batida de conteúdo: assunto totalmente visível e centralizado acima do painel, texto legível, nada sob o notch/barra inicial. Avise o usuário honestamente quando um teste em dispositivo real não foi feito.