Trabalho de outra sessão, commitado na sincronização de 18/11/2026 (doc/clipador/DETECCAO-JOGO.md). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.5 KiB
Clipador — detecção automática do jogo (18/11/2026)
Pedido do dono
Se ninguém lembrar de dizer o jogo, o Clipador descobre sozinho, a cada ~3 min, cruzando tudo o que a live dá (API da plataforma, título, o que a IA lê na tela, chat e fala), tenta acertar, pede confirmação e deixa trocar se estiver errado.
Pistas (app/game_detect.py, a regra; app/intel.py, juntar e aplicar)
| Fonte | O que é | Peso máx. |
|---|---|---|
platform |
Categoria da live (Streamlink --json), lida a cada 3 min. Categoria genérica ("Just Chatting", "IRL", "Música"…) não conta como jogo. |
0,55 |
screen |
O jogo que a IA vê nos frames (logo, HUD, texto na tela). A varredura de 3 min já devolve screen_game + screen_game_confidence (high/medium/low) + screen_evidence (o que ela leu/viu). Vale por 15 min. |
0,50 × confiança |
title |
O título da live cita um jogo cadastrado (nome ou outro nome). | 0,25 |
chat |
Mensagens dos últimos 6 min citam um jogo cadastrado (mínimo 2 mensagens; força 1 com 6). | 0,35 |
speech |
Trechos de fala dos últimos 6 min (12 blocos) citam um jogo cadastrado (força 1 com 3). | 0,35 |
Nomes iguais viram o mesmo jogo pelos outros nomes (aliases): categoria "Grand Theft Auto VI" + tela "GTA 6" +
chat "gta6" = um jogo só. A busca em texto só acha jogos cadastrados (a lista de Jogos) e só por palavra inteira
(nome com 4+ letras, ou 3 com número, ex. cs2). Acentos não atrapalham.
Decisão
Cada jogo ganha uma nota (ruído-ou das fontes, cada fonte conta uma vez). O estado (sessions.game_status):
| Estado | Quando | O que o Clipador faz |
|---|---|---|
user |
Você confirmou. | Nunca troca sozinho. Se as pistas apontarem outro jogo (várias fontes concordando) em 2 checagens seguidas, grava uma suggestion e o painel pergunta "o streamer trocou de jogo?". |
agreed |
2+ fontes independentes no mesmo jogo, nota ≥ 0,6. | Aplica. |
probable |
Uma fonte boa sozinha (só a categoria; ou só a tela com confiança média). | Aplica e pede "Sim, é X". |
conflict |
Categoria × tela (fontes fortes) em jogos diferentes e sem folga (< 0,25). | Mantém o jogo atual e pergunta qual é o certo. |
unknown |
Sem pista útil (ex.: Just Chatting e nada na tela). | Não mexe. |
Trocar de um jogo já definido (sem confirmação do usuário) exige a categoria da plataforma apoiando ou a mesma resposta em 2 checagens seguidas (evita trocar por um frame de menu). "Detectar agora" pula essa espera.
Estado guardado
sessions.game_statusesessions.game_detect_json(v16): pistas (platform,screen),candidates(até 4, com nota e cada pista),suggestion,pending(checagens seguidas) echeckedAt.sessions.game/game_source(platform|screen|chat|user) /games_json(histórico de trocas) continuam como antes; o perfil do jogo é pesquisado se o jogo é novo.
Contrato (serviço ↔ painel)
GET /v1/sessions[/{id}]ganhagameStatusegameDetect={checkedAt, candidates[{gid, game, score, sources[{source, game, strength, detail}]}], suggestion|null, platform{game, at}, screen{game, confidence, evidence, at}|null}.PUT /v1/sessions/{id}/game {name}: confirma (estadouser, limpa a sugestão).POST /v1/sessions/{id}/game/detect("Detectar agora"): a IA olha 3 frames dos últimos 2 min, cruza com o resto e aplica na hora. Responde{result: {status, candidates, suggestion, screen{game, confidence, evidence}}, session}. Exige IA e visão ligadas (erro 400 em português se não).
Painel (detalhe da sessão)
Selo do estado (confirmado por você · detectado, fontes concordam · provável, confirme · em dúvida · não identificado), "Sim, é X", "Escolher/Trocar jogo" (a lista inclui os candidatos), Detectar agora, aviso de conflito com um botão por candidato, aviso de sugestão de troca (jogo confirmado) e "Como o jogo foi descoberto" (categoria, tela com o que a IA leu, e cada candidato com nota e pistas). Na lista de sessões o selo "confirmar" aparece nos mesmos casos.
Limites conhecidos
- Sem a varredura (IA/visão desligadas) não há pista de tela; o botão "Detectar agora" também precisa da IA.
- Sem leitor de texto (OCR) próprio: o texto na tela é lido pela IA de visão (
screen_evidence). - Chat e fala só reconhecem jogos já cadastrados em Jogos (os que passaram pela categoria entram sozinhos).
- Categoria genérica não vira jogo: a sessão fica sem jogo até a tela, o chat ou você dizerem qual é.