Topspin — Manual da Câmera

Antes de tudo: como a câmera "conecta"

Não tem cabo nem configuração complicada. O Topspin é um site/app que usa a câmera do próprio celular onde ele está aberto. Conectar = abrir o app no celular e autorizar o acesso à câmera quando ele pedir. Só isso.

A única regra técnica: a câmera só liga se o app estiver aberto pelo endereço https://topspin-cy9.pages.dev (com cadeado), nunca por um arquivo solto. O navegador só libera a câmera em sites seguros (https). O nosso já é.

São duas funções diferentes

Vídeo do treino

Você grava o lance e revê em câmera lenta depois. Serve para mostrar a técnica para o aluno.

Técnica ao vivo (IA)

A câmera desenha o esqueleto do jogador em tempo real e dá dicas de postura na hora.

Passo a passo: conectar a câmera

1

Abra o app no celular

No navegador do celular (Safari no iPhone, Chrome no Android), entre em topspin-cy9.pages.dev. Faça login na sua conta.

2

Escolha a função na tela inicial

Toque em "Vídeo do treino" (gravar/rever) ou em "Técnica ao vivo (IA)" (esqueleto em tempo real).

3

Toque em "Ligar câmera"

Na Técnica ao vivo, aperte o botão Ligar câmera. No Vídeo do treino, toque no campo de vídeo, que abre a câmera direto.

4

Permita o acesso (o passo que mais trava)

O celular vai mostrar um aviso perguntando se o Topspin pode usar a câmera. Toque em Permitir. Sem isso, a tela fica preta. (Detalhes por aparelho logo abaixo.)

5

Aponte e use

A imagem aparece. Use Trocar câmera para frontal/traseira e Parar ao terminar.

Permitir a câmera — por aparelho

iPhone (Safari)

Aparece "topspin... Gostaria de Acessar a Câmera". Toque em Permitir.

Se tiver negado antes: Ajustes → Safari → Câmera → Perguntar/Permitir, ou toque no "aA" na barra de endereço → Configurações do site → Câmera → Permitir. Depois recarregue.

Android (Chrome)

Aparece "Usar sua câmera?". Toque em Permitir / Ao usar o app.

Se tiver negado antes: toque no cadeado ao lado do endereço → Permissões → Câmera → Permitir. Depois recarregue a página.

Importante: a permissão é por aparelho e por navegador. Se trocar de celular ou de navegador, ele vai perguntar de novo — é normal.

Montagem do celular na quadra

A

Altura e posição

Tripé de 1,8–2 m ou suporte preso na grade, atrás da quadra e um pouco elevado.

B

Enquadramento

Para gravar a partida, enquadre a quadra inteira. Para a Técnica ao vivo, filme o jogador de lado e de corpo inteiro — a IA enxerga melhor a postura assim.

C

Qualidade e luz

Na câmera do celular, use 1080p e 60 fps (deixa a câmera lenta nítida). Boa luz sempre — luz fraca atrapalha a imagem e a IA.

Usar "Vídeo do treino" (gravar e rever)

Abra Vídeo do treino.
Escreva o que é o lance (ex.: "Bruno · top spin · erro").
Toque em Vídeo → grave o lance pela câmera e confirme.
O clipe fica salvo na lista, com a anotação e a data.
Toque no vídeo para rever (pausar, câmera lenta) e mostrar ao aluno.

Fica salvo neste aparelho (memória do navegador). Não usa internet e funciona offline. Para liberar espaço, use Apagar em cada clipe.

Usar "Técnica ao vivo" (IA / esqueleto)

Abra Técnica ao vivo (IA) e toque em Ligar câmera.
Permita o acesso (passo 4 acima).
Aponte para o jogador (corpo inteiro, de lado, boa luz).
Aparece o esqueleto sobre a imagem e as dicas de postura embaixo, em tempo real.
Use Trocar câmera e Parar quando terminar.

A IA roda dentro do celular (nada é enviado para servidor). Precisa de internet só na 1ª vez, para baixar a inteligência; depois funciona offline. Roda bem em iPhone 11 Pro ou superior e em Androids recentes.

Como isso "sincroniza" com o sistema

Esta é a maior dúvida, então bem claro:

O vídeo NÃO sincroniza. Fica guardado no aparelho que gravou (vídeo é arquivo grande).
O que sincroniza são os DADOS. Quando você marca os pontos e clica em "Publicar relatório" no painel, o relatório do atleta (pontos fortes, o que melhorar, treino, evolução) vai para a nuvem, e o atleta vê no celular dele.

Câmera = a técnica + Sistema = os dados = treino completo

Quer o vídeo em outro aparelho? Por enquanto, compartilhe por WhatsApp/AirDrop como qualquer vídeo. Guardar vídeo na nuvem é um próximo passo possível (tem custo de armazenamento).

O que a câmera faz e o que não faz

Faz: grava e revê o lance em câmera lenta.
Faz: mostra o esqueleto e dá dicas de postura/técnica ao vivo.
Não faz: contar os pontos sozinha nem dizer se a bola caiu dentro/fora (isso é a marcação manual no Modo Treinador/Atleta).
Não faz: ler a bola. A IA lê o corpo, não a bola. Contagem automática pela bola é outro tipo de sistema (ex.: SwingVision), que pode ser integrado no futuro.

Deu problema? Resolva aqui

!

Tela preta / câmera não liga

Você negou a permissão. Vá no cadeado (Android) ou no "aA" (iPhone) na barra de endereço, libere a Câmera e recarregue a página.

!

Não aparece o pedido de permissão

Confira se está no endereço https://topspin-cy9.pages.dev (com cadeado). A câmera não liga em arquivo aberto direto nem em http sem cadeado.

!

A IA não carrega na Técnica ao vivo

Ela baixa a inteligência na 1ª vez — precisa de internet nesse primeiro uso. Conecte ao Wi-Fi/4G uma vez e recarregue.

!

Outro app está usando a câmera

Feche apps de câmera/vídeo abertos no fundo (a câmera só atende um por vez) e recarregue.

!

Veio a câmera errada (frontal)

Toque em Trocar câmera para mudar para a traseira.

Perguntas rápidas

Precisa de internet? Gravar/rever: não. Técnica ao vivo: só na 1ª vez (baixar a IA).
O vídeo vai para a nuvem? Não — fica no aparelho.
Funciona no Android? Sim (recentes). No iPhone 11 Pro+ roda muito bem.
Posso usar um celular só para a quadra? Sim — é o ideal: ele filma e roda o app ao mesmo tempo.

Abrir Vídeo do treino Abrir Técnica ao vivo