Modo Gaming de Kwiq

Activación y Acceso

Se puede acceder al Modo Gaming de varias formas:

• Quick Tool "Gaming": toca el icono de mando en las Quick Tools de Home o Escritorio.
• Acceso directo en el cajón: usa el acceso directo kwiq_gaming para abrirlo directamente.
• Botón de modo del mando: conecta un gamepad y pulsa MODE para abrir Gaming.
• Girar a paisaje: si está configurado, girar el dispositivo a paisaje abre automáticamente el Modo Gaming.

La activity se abre en paisaje a pantalla completa (SCREEN_ORIENTATION_SENSOR_LANDSCAPE), maximizando el espacio para juegos.

Dashboard

Al entrar en el Modo Gaming, ves el dashboard con las siguientes secciones:

Soporte de Gamepad

Kwiq ofrece soporte completo para mandos físicos:

Conexión: Bluetooth u OTG — funciona cualquier mando compatible con Android.

Diagnóstico: abre el diagnóstico de gamepad para ver:

• Ejes analógicos (Left X/Y, Right X/Y, Triggers, D-Pad).
• Botones pulsados en tiempo real.
• Un registro de los últimos 8 eventos.
• Lista de dispositivos conectados.

Auto-detección: Kwiq detecta automáticamente cuando se conecta o desconecta un mando.

Navegación: usa el direccional analógico o el D-Pad para navegar por la interfaz de Gaming.

Biblioteca de Juegos

Kwiq organiza tus juegos en dos categorías principales:

Android Games

Los juegos instalados en el dispositivo se detectan automáticamente y se muestran con sus iconos nativos. Puedes:

• Filtrar por nombre o plataforma.
• Ordenar por nombre, fecha de instalación o uso reciente.
• Marcar como favoritos juegos para acceso rápido.
• Ver recientes: los 5 juegos más recientes aparecen en el acceso directo de la Quick Tool.

Retro Games (ROMs)

Kwiq escanea el sistema de archivos en busca de ROMs y las organiza por plataforma. El mapeo de plataformas se basa en los JSON de Daijishou, con soporte para más de 70 plataformas (Nintendo, Sony, Sega, Atari, NEC, SNK, Commodore, etc.).

Cada plataforma tiene:

• Nombre, ID único, nombre abreviado.
• Lista de emuladores compatibles.
• Extensiones de ROM soportadas (.nes, .sfc, .gba, .iso, .rom, etc.).
• Icono personalizado (más de 200 mapeos de iconos de consola).

Emuladores Soportados

Kwiq detecta automáticamente los emuladores instalados y configura la integración. Cuando seleccionas una ROM, Kwiq muestra los emuladores compatibles instalados.

Extras (LIBRETRO, CONFIGFILE)

Extras (bootPath)

Data URI

El EmulatorRegistry gestiona la detección de emuladores instalados vía PackageManager. Si un emulador no está instalado, simplemente no aparece como opción.

Gestión de ROMs

Kwiq facilita la gestión de tu biblioteca de ROMs:

1. Escaneo automático: al entrar en Gaming, Kwiq escanea las carpetas configuradas en busca de ROMs.
2. Organización por plataforma: las ROMs se agrupan automáticamente según su plataforma correspondiente (ej.: "Super Nintendo", "PlayStation", "Nintendo 64").
3. Búsqueda y filtros: encuentra ROMs por nombre, plataforma o género.
4. Favoritos y recientes: marcadores para acceso rápido.
5. Asistente de configuración: ayuda a configurar emuladores para las plataformas detectadas.

Artwork y Metadatos

Haz tu biblioteca visualmente atractiva con carátulas y metadatos:

• Carátula local: asigna imágenes de la galería como carátula de cada juego.
• Metadatos: edita información como nombre, año, género, desarrollador, descripción.

Búsqueda online: con claves de API, puedes buscar metadatos en:

• IGDB (Internet Game Database) — una base de datos completa de juegos.
• TheGamesDB — una base de datos colaborativa de juegos.

ROM Patcher

El ROM Patcher de Kwiq permite aplicar parches a las ROMs directamente en el dispositivo, sin necesitar un ordenador. Esto es útil para:

• Traducciones: aplicar parches de traducción para jugar en otro idioma.
• Hacks: aplicar modificaciones creadas por la comunidad (mayor dificultad, nuevos niveles, etc.).
• Correcciones: aplicar parches de corrección de errores en las ROMs.

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

Cómo usarlo:

1. Abre el ROM Patcher desde el Gestor de Archivos o el menú de Gaming.
2. Selecciona el archivo de parche (.ips, .ups, .bps, etc.).
3. Elige la ROM original.
4. Define el destino y aplica.

Consulta la sección "ROM Patcher" en la documentación del Gestor de Archivos para más detalles.

Cloud Gaming

El Modo Gaming también ofrece acceso a servicios de juegos en la nube:

• Xbox Cloud Gaming: acceso directo para abrir xCloud en el navegador o una app compatible.
• Remote Play: detecta automáticamente apps de remote play instaladas (PS Remote Play, Steam Link, Moonlight, etc.).

Los servicios de cloud gaming aparecen como tarjetas en el dashboard, integrados en la biblioteca para acceso rápido.

Consejos y Personalización

Gaming Management (Web Dashboard)

Además del dashboard en el dispositivo, Kwiq incluye un módulo de Gaming Management en el dashboard web (/gaming) y tools MCP espejadas, para gestionar tu biblioteca de ROMs desde cualquier navegador o asistente de IA:

• Configurar claves de API: habilita y define tus credenciales de IGDB y TheGamesDB desde la propia página Gaming, con campos secretos enmascarados.
• Subir ROMs: arrastra y suelta o selecciona archivos en el navegador. Cada subida se enruta por extensión a la carpeta de la plataforma correcta (ej.: .gb a Game Boy, .z64 a Nintendo 64).
• Extensiones ambiguas: para formatos compartidos por varias plataformas (.zip, .iso, .7z), el dashboard pregunta qué plataforma usar antes de guardar.
• Descargar y eliminar: exporta cualquier ROM de vuelta al ordenador o elimínala (junto con sus metadatos y arte en caché).
• Editar detalles: cambia nombre, resumen, historia, géneros, plataformas, puntuación, fecha de lanzamiento y enlaces web de cualquier ROM.
• Buscar e importar: busca juegos en IGDB o TheGamesDB e importa metadatos completos y carátula con un clic.
• Artwork: sube, descarga o limpia carátulas y fondos locales de cada juego desde el diálogo de detalles.
• Cobertura MCP: cada acción del dashboard también se expone como tools MCP (gaming_list_roms, gaming_rom_import_url, gaming_rom_cover_url, gaming_search_igdb, y más) para asistentes de IA.