Tutorial · Replay de quadra

PASSO 1

Lista de compra (Mercado Livre)

Placa USB arcade ~R$ 45, já vem com um fio por botão e o USB que entra no computador. Botoeira de dois fios ~R$ 12 cada. Câmera IP genérica da China serve, desde que tenha endereço de rede (RTSP/Onvif). PC i3 4ª geração + 8 GB. Switch PoE se a câmera for PoE.

Placa USB arcade (encoder HID) — plug and play, sem driver
Botoeira arcade por quadra (dois fios)
Câmera IP por quadra
Cabo USB da placa no PC da recepção
Hospedagem PHP simples (sem MySQL)

Depois do PIX a gente conversa no WhatsApp o modelo exato da câmera e da placa antes de você comprar. Não adianta câmera só Wi‑Fi de aplicativo fechado.

Placa USB arcade com um fio por botão e cabo USB — Placa ~R$ 45 · um fio por botão + USB

Botoeira vermelha de dois fios na borda da quadra — Botoeira ~R$ 12 · dois fios

PASSO 2

Placa no PC, botão na quadra

USB da placa no computador. Não instala driver: o Windows/Linux já enxerga como HID. Os fios da placa vão nos bornes da botoeira (dois fios por botão). Cada botão vira um número. Botão 11 dispara a câmera 11 — no nosso replay.json isso é o campo court (quadra1, quadra2…).

BOTOEIRA
2 fios

PLACA USB
encoder

PC RECEPÇÃO
hidraw / HID

Linux: ls /dev/hidraw* depois de plugar. Coloca o caminho em arcade_device. Um aperto = um clipe. Segurar não dispara de novo.

Encoder USB ligado no computador, fios soltos para as botoeiras — USB no PC. Sem driver. Cada par de fios = um botão.

PASSO 3

Câmera IP na mesma rede

Câmera no switch. Anota IP, usuário e senha. O stream RTSP costuma ser rtsp://usuario:senha@IP:554/stream1 (o caminho muda por marca — a gente testa no Zap). Coloca em rtsp_url. Retrato ou paisagem em orientation. Logo PNG em sponsors/marca.png.

Câmera IP no teto da quadra coberta — Câmera IP no teto · RTSP na mesma rede do PC

PASSO 4

PHP no servidor online

Um arquivo PHP sobe os vídeos. Sem conexão de banco, sem tabela SQL. Cada clique cria (ou usa) uma pasta com o nome da quadra e joga o mp4 lá dentro.

Sobe a pasta site/ na hospedagem. Coloca o mesmo segredo em site/upload.token e em token do replay.json. URL pública: https://sua-arena.com.br/upload.php.

Home lista as quadras. folder.php?dir=quadra1 é onde o jogador assiste e baixa no celular — o mesmo esquema do Summer Club.

Jogador na quadra baixando o clipe no celular — Site no celular · pasta da quadra · download

PASSO 5

Python no computador da recepção

Esse código fica local. O PHP fica na internet. Instala Python 3.11+ e ffmpeg. Copia replay.json.example para replay.json e preenche câmera, token, device e URL de upload.

{
  "court": "quadra1",
  "seconds": 30,
  "orientation": "portrait",
  "rtsp_url": "rtsp://admin:senha@192.168.1.20:554/stream1",
  "logo_path": "sponsors/marca.png",
  "upload_url": "https://sua-arena.com.br/upload.php",
  "token": "o-mesmo-do-php",
  "arcade_device": "/dev/hidraw0"
}

python3 -m replay.main --dry-run
python3 -m replay.main

O ffmpeg fica aberto na câmera o tempo todo e guarda só os últimos 30 segundos. O botão não grava o futuro: puxa o que já aconteceu.

Computador da recepção da arena com o sistema rodando — PC da recepção · Python local · PHP na internet

PASSO 6

No jogo

PC ligado, Python rodando, câmera no ar.
Jogador faz a jogada.
Aperta a botoeira daquela quadra.
Clipe sobe na pasta da quadra no site.
Abre o site no celular, baixa, posta no Stories.

Jogador aperta a botoeira depois do gol — Aperta · 30s pra trás

Clipe no celular para Stories — Baixa · posta

PASSO 7

Apagar vídeo velho

Cron no servidor apaga os arquivos a cada 24h (meia-noite, 1h, 3h — o horário que a arena escolher). Disco não cresce pra sempre. Quem quiser guardar o gol, baixa no mesmo dia.

0 3 * * * find /caminho/site/videos -name '*.mp4' -mtime +1 -delete

Quanto cobrar

Mensalidade no cliente da arena, ou usa na sua quadra. Hardware barato, valor está no recorte e no suporte. A gente fica no Zap na instalação.

WhatsApp da instalação