Modo Gaming do Kwiq

Ativação e Acesso

O Modo Gaming pode ser acessado de várias formas:

• Quick Tool "Gaming": toque no ícone de controle nas Quick Tools na Home ou Desktop.
• Atalho na gaveta: use o atalho kwiq_gaming para abrir diretamente.
• Botão de modo do controle: conecte um gamepad e pressione MODE para abrir o Gaming.
• Giro para paisagem: se configurado, girar o dispositivo para paisagem abre automaticamente o Modo Gaming.

A activity abre em paisagem fullscreen (SCREEN_ORIENTATION_SENSOR_LANDSCAPE), maximizando o espaço para jogos.

Dashboard

Ao entrar no Modo Gaming, você vê o dashboard com as seguintes seções:

Suporte a Gamepad

O Kwiq oferece suporte completo a controles físicos:

Conexão: Bluetooth ou OTG — qualquer controle compatível com Android funciona.

Diagnóstico: abra o diagnóstico de gamepad para ver:

• Eixos analógicos (Left X/Y, Right X/Y, Triggers, D-Pad).
• Botões pressionados em tempo real.
• Log dos últimos 8 eventos.
• Lista de dispositivos conectados.

Auto-detect: o Kwiq detecta automaticamente quando um controle é conectado ou desconectado.

Navegação: use o direcional analógico ou D-Pad para navegar pela interface do Gaming.

Biblioteca de Jogos

O Kwiq organiza seus jogos em duas categorias principais:

Android Games

Jogos instalados no dispositivo são detectados automaticamente e exibidos com seus ícones nativos. Você pode:

• Filtrar por nome ou plataforma.
• Ordenar por nome, data de instalação ou uso recente.
• Favoritar jogos para acesso rápido.
• Ver recentes: os 5 jogos mais recentes aparecem no atalho da Quick Tool.

Retro Games (ROMs)

O Kwiq escaneia o sistema de arquivos em busca de ROMs e as organiza por plataforma. O mapeamento de plataformas é baseado nos JSONs do Daijishou, com suporte a mais de 70 plataformas (Nintendo, Sony, Sega, Atari, NEC, SNK, Commodore, etc.).

Cada plataforma possui:

• Nome, ID único, nome abreviado.
• Lista de emuladores compatíveis.
• Extensões de ROM suportadas (.nes, .sfc, .gba, .iso, .rom, etc.).
• Ícone personalizado (mais de 200 mapeamentos de ícones de console).

Emuladores Suportados

O Kwiq detecta automaticamente emuladores instalados e configura a integração. Quando você seleciona uma ROM, o Kwiq mostra os emuladores compatíveis instalados.

Extras (LIBRETRO, CONFIGFILE)

Extras (bootPath)

Data URI

O EmulatorRegistry gerencia a detecção dos emuladores instalados via PackageManager. Se um emulador não estiver instalado, ele simplesmente não aparece como opção.

Gerenciamento de ROMs

O Kwiq facilita o gerenciamento da sua biblioteca de ROMs:

1. Scan automático: ao entrar no Gaming, o Kwiq escaneia as pastas configuradas em busca de ROMs.
2. Organização por plataforma: as ROMs são agrupadas automaticamente pela plataforma correspondente (ex: "Super Nintendo", "PlayStation", "Nintendo 64").
3. Busca e filtros: encontre ROMs por nome, plataforma ou gênero.
4. Favoritos e recentes: marcadores para acesso rápido.
5. Assistente de configuração: ajuda a configurar emuladores para plataformas detectadas.

Artwork e Metadados

Deixe sua biblioteca visualmente atraente com capas e metadados:

• Capa local: atribua imagens da galeria como capa de cada jogo.
• Metadados: edite informações como nome, ano, gênero, desenvolvedor, descrição.

Busca online: com chaves de API, você pode buscar metadados em:

• IGDB (Internet Game Database) — banco de dados abrangente de jogos.
• TheGamesDB — banco de dados colaborativo de jogos.

ROM Patcher

O ROM Patcher do Kwiq permite aplicar patches em ROMs diretamente no dispositivo, sem precisar de computador. Isso é útil para:

• Traduções: aplicar patches de tradução para jogar em português.
• Hacks: aplicar modificações criadas pela comunidade (maior dificuldade, novos níveis, etc.).
• Correções: aplicar patches de bugfix em ROMs.

Formatos suportados: IPS, UPS, APS, BPS, RUP, PPF, BSDIFF, PMSR, VCDIFF.

Como usar:

1. Abra o ROM Patcher pelo File Manager ou pelo menu do Gaming.
2. Selecione o arquivo de patch (.ips, .ups, .bps, etc.).
3. Escolha a ROM original.
4. Defina o destino e aplique.

Consulte a seção "ROM Patcher" na documentação do Gerenciador de Arquivos para detalhes completos.

Cloud Gaming

O Modo Gaming também oferece acesso a serviços de jogos em nuvem:

• Xbox Cloud Gaming: atalho direto para abrir o xCloud no navegador ou app compatível.
• Remote Play: detecta automaticamente apps de remote play instalados (PS Remote Play, Steam Link, Moonlight, etc.).

Os serviços de cloud gaming aparecem como cards no dashboard, integrados à biblioteca para acesso rápido.

Dicas e Personalização

Gaming Management (Web Dashboard)

Além do dashboard no dispositivo, o Kwiq traz um módulo de Gaming Management no dashboard web (/gaming) e tools MCP espelhadas, permitindo gerenciar sua biblioteca de ROMs de qualquer navegador ou assistente de IA:

• Configurar chaves de API: habilite e defina suas credenciais IGDB e TheGamesDB direto na página Gaming, com campos de segredo mascarados.
• Enviar ROMs: arraste e solte ou selecione arquivos no navegador. Cada upload é roteado pela extensão para a pasta da plataforma correta (ex.: .gb para Game Boy, .z64 para Nintendo 64).
• Extensões ambíguas: para formatos compartilhados por várias plataformas (.zip, .iso, .7z), o dashboard pergunta qual plataforma usar antes de salvar.
• Baixar e excluir: exporte qualquer ROM de volta para o computador ou remova-a (junto com metadados e artes em cache).
• Editar detalhes: altere nome, resumo, história, gêneros, plataformas, nota, data de lançamento e links de sites de qualquer ROM.
• Buscar e importar: pesquise jogos no IGDB ou TheGamesDB e importe metadados completos e capa com um clique.
• Artwork: envie, baixe ou limpe capas e fundos locais de cada jogo direto do diálogo de detalhes.
• Cobertura MCP: toda ação do dashboard também é exposta como tools MCP (gaming_list_roms, gaming_rom_import_url, gaming_rom_cover_url, gaming_search_igdb, e mais) para assistentes de IA.