Skip to content

GameCenter Tester

El GameCenter Tester es una herramienta que simula el entorno de Ecotic en tu navegador. Carga tu juego en un iframe, le envía un token de prueba y muestra en tiempo real los eventos que tu juego envía al SDK — todo sin tocar la API de producción.

Abrir GameCenter Tester


Cómo usar el tester

  1. Sirve tu juego desde un servidor local

    El tester necesita una URL accesible — no puede cargar archivos directamente desde el disco (file://). Usa cualquiera de estas opciones:

    Terminal window
    # Con Node.js
    npx serve .
    # → http://localhost:3000
    # Con Python
    python -m http.server 8080
    # → http://localhost:8080
    # Con VS Code: instala "Live Server" y haz clic en "Go Live"
    # → http://127.0.0.1:5500
  2. Abre el tester y carga tu juego

    Ve a sdk-ecotic.ced.com.co/tester/, ingresa la URL de tu servidor local (p.ej. http://localhost:3000) y haz clic en Cargar juego.

  3. El tester envía el token automáticamente

    Al cargar el iframe, el tester simula lo que haría el GameCenter real: envía un mensaje ECOTIC_GAME_TOKEN al juego. El SDK lo recibe y llama a onReady().

  4. Juega e interactúa

    Juega una partida completa. En el panel derecho verás todos los eventos que llegan:

    Evento esperadoCuándo debe aparecer
    STARTEDCuando tu juego llama a sdk.start()
    CHECKPOINTCada vez que tu juego llama a sdk.checkpoint()
    COMPLETEDCuando tu juego llama a sdk.complete(score)
    EXITCuando tu juego llama a sdk.exit()
  5. Verifica que onReward funciona

    Al recibir el evento completed, el SDK dispara automáticamente tu callback onReward con una recompensa simulada (xp: 50, coins: 10). Así puedes probar tu UI de premios sin necesitar la API real.


Juego en localhost y el tester en HTTPS

El tester está alojado en https://sdk-ecotic.ced.com.co/tester/. Cuando ingresas una URL como http://localhost:3000, el navegador intenta cargar un iframe HTTP desde una página HTTPS — esto se llama contenido mixto.

El comportamiento depende del navegador:

Navegador¿Funciona con localhost?
Chrome / Edge✅ Sí — localhost es una excepción permitida
Firefox⚠️ Puede bloquear — ver solución abajo
Safari❌ Bloquea contenido mixto

Solución para Firefox y Safari: descarga el tester y sírvelo desde tu máquina.


Usar el tester localmente (recomendado para todos los navegadores)

Descarga el archivo HTML del tester y sírvelo junto a tu juego. Así ambos están en HTTP y no hay ningún conflicto.

  1. Descarga el tester:Descargar tester.html (clic derecho → Guardar como)

  2. Colócalo en cualquier carpeta y sírvelo con un servidor local:

    Terminal window
    # En la carpeta donde guardaste el archivo
    npx serve .
    # → Abre http://localhost:3000/tester.html (o index.html si lo renombraste)
  3. Ingresa la URL de tu juego (http://localhost:XXXX) — al estar ambos en HTTP, funciona en cualquier navegador.


Qué valida el tester

Antes de enviar tu repositorio al equipo Ecotic, verifica que:

  • El juego carga correctamente en el iframe del tester
  • El evento STARTED aparece al primer gesto del jugador
  • El evento CHECKPOINT aparece en cada progreso relevante
  • El evento COMPLETED aparece al terminar la partida
  • Tu onReward se dispara y muestra la UI de recompensa (recompensa simulada: xp 50, coins 10)
  • El evento EXIT aparece al cerrar el juego
  • No hay errores rojos en la consola del navegador (F12)