Files
CenaForge/doc/clipador/DETECCAO-JOGO.md
T
MateuusandClaude Opus 5.5 44bb961d1a Clipador: detecção do jogo cruzando categoria e tela (confiança, evidência e sugestão de troca)
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>
2026-11-18 05:08:57 -03:00

4.5 KiB
Raw Blame History

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_status e sessions.game_detect_json (v16): pistas (platform, screen), candidates (até 4, com nota e cada pista), suggestion, pending (checagens seguidas) e checkedAt.
  • 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}] ganha gameStatus e gameDetect = {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 (estado user, 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 é.