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.
Cómo usar el tester
-
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.jsnpx serve .# → http://localhost:3000# Con Pythonpython -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 -
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. -
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_TOKENal juego. El SDK lo recibe y llama aonReady(). -
Juega e interactúa
Juega una partida completa. En el panel derecho verás todos los eventos que llegan:
Evento esperado Cuándo debe aparecer STARTED Cuando tu juego llama a sdk.start()CHECKPOINT Cada vez que tu juego llama a sdk.checkpoint()COMPLETED Cuando tu juego llama a sdk.complete(score)EXIT Cuando tu juego llama a sdk.exit() -
Verifica que
onRewardfuncionaAl recibir el evento
completed, el SDK dispara automáticamente tu callbackonRewardcon 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.
-
Descarga el tester: → Descargar tester.html (clic derecho → Guardar como)
-
Colócalo en cualquier carpeta y sírvelo con un servidor local:
Terminal window # En la carpeta donde guardaste el archivonpx serve .# → Abre http://localhost:3000/tester.html (o index.html si lo renombraste) -
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
onRewardse 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)