Centro de Soporte Técnico

DOCUMENTACIÓN TÉCNICA

Aprende a integrar y configurar el ecosistema ApexIA y ApexIA-Couch para dominar la pista.

1. Introducción al Ecosistema

El ecosistema ApexIA × ApexIA-Couch es la suite definitiva de telemetría e ingeniería de pista en tiempo real. Está compuesto por dos partes esenciales que trabajan de manera simbiótica:

  • ApexIA (Plataforma Web): El motor analítico central impulsado por inteligencia artificial. Procesa tus datos vuelta a vuelta de forma asincrónica y te entrega reportes detallados en tu navegador sobre más de 25 patrones dinámicos de pilotaje y configuraciones de setup.
  • ApexIA-Couch (App de Escritorio): La aplicación cliente para Windows de peso pluma. Se ejecuta en segundo plano mientras corres, extrayendo datos de telemetría de tu simulador de manera local y transmitiéndotelos vía audio con voz argentina natural en tiempo real (coaching en vivo, spotter y alertas de motor).

2. Requisitos del Sistema

Para garantizar una lectura de telemetría a 30fps sin pérdida de paquetes ni impacto en el rendimiento de tu juego, tu equipo debe cumplir con lo siguiente:

  • Sistema Operativo: Windows 10 u 11 (64-bit).
  • Dependencias: Microsoft .NET Core 8.0 Runtime o superior (incluido por defecto en Windows actualizados).
  • Conexión a Internet: Banda ancha estable para la sincronización con el WebSocket (mínimo 5 Mbps). El spotter local funciona 100% offline si te desconectas.
  • Simuladores Compatibles: SimuV3 (Early Access), iRacing, Assetto Corsa, Assetto Corsa Competizione y rFactor (Shared Memory adaptado).

3. Instalación de ApexIA-Couch

La app de escritorio está diseñada bajo un principio de cero fricción: no requiere procesos de instalación invasivos ni modifica registros de tu sistema.

  1. Descargá el ejecutable portable de ApexIA-Couch desde nuestra página principal.
  2. Ejecutá el archivo ApexIACouch.exe directamente en cualquier ubicación de tu PC (no requiere descompresión ni instalación). Tu firewall o antivirus de Windows podría solicitar confirmación debido al consumo de red para WebSockets; hacé clic en "Permitir acceso".

4. Vinculación vía API Key

Para que tu telemetría local se sincronice con tu panel personal de pilotaje en la web, debes vincular tu app mediante una clave API única:

  1. Inicia sesión o regístrate en nuestra plataforma web: Apex IA.
  2. Entra a la sección Mi Perfil en el menú de usuario de la web y busca el bloque Claves de API / Tokens.
  3. Genera una nueva API Key y cópiala en tu portapapeles.
  4. Abre ApexIA-Couch en tu PC, ve a la sección "Conectar ApexIA", pega tu clave API y haz clic en "Validar y Guardar".

Una vez hecho esto, se encenderá un indicador verde en la app que confirmará que tu cuenta está vinculada con éxito y lista para transmitir.

5. Configuración de Simuladores

La app de escritorio utiliza lectores nativos optimizados para cada simulador de la siguiente forma:

A. Configuración para SimuV3

La integración con SimuV3 es 100% nativa y automática. Solo debes asegurarte de que el plugin `rFactorSharedMemoryMap` esté activado en la carpeta de complementos de tu simulador. La app detectará los canales y la telemetría se levantará sin configuración adicional a 30fps.

B. Configuración para iRacing

Inicia iRacing en modo ventana o pantalla completa. ApexIA-Couch se conectará al SDK de iRacing de manera automática en cuanto salgas al pitlane. No es necesario modificar ningún archivo `.ini`.

C. Configuración para Assetto Corsa / ACC

Asegúrate de que la API de shared memory de Assetto Corsa esté habilitada en tu archivo de configuración del juego. La app leerá los canales de físicas e incidentes de forma automática.

6. Sincronización y Exportación de Telemetría CSV

ApexIA-Couch captura cada variable en una matriz local. Al concluir una sesión de juego (cuando presionas "Esc" y vuelves al garaje):

  • Sincronización Automática: Si estás online y con tu API Key validada, la app enviará un paquete consolidado vía WebSocket a la base de datos de ApexIA. Tu reporte de IA estará disponible en la web en menos de 10 segundos.
  • Exportación Manual (CSV): Si prefieres gestionar tus datos o importarlos a herramientas como MoTeC, puedes hacer clic en "Exportar Sesión en CSV" en la pestaña de historial de la app para guardar el archivo plano con todos los canales mapeados.