Shape Match — Juego de quiosco — Manual de usuario.

Shape Match es un juego táctil descargable en PHP y HTML5 para ferias comerciales, vestíbulos y sitios web: un jugador arrastra cada forma objetivo a su recorte correspondiente antes de que se acabe el tiempo. Este manual cubre la descarga, instalación, configuración del quiosco, modo de juego, menú del operador, captura de clientes potenciales y GDPR.

Precaución: este es un software que tú mismo hospedas: antes de cualquier despliegue público, cambia el PIN de operador predeterminado y asegúrate de que el juego datos/ La carpeta nunca se puede explorar a través de la web. Usted es el responsable del tratamiento de los datos de cualquier jugador que recopile.

Aviso legal

Made for Arcade no ofrece ninguna declaración ni garantía con respecto a este manual y, en la medida máxima permitida por la ley, limita expresamente su responsabilidad por cualquier incumplimiento de cualquier garantía que se derive de la sustitución de este manual por otro. Además, Made for Arcade se reserva el derecho a revisar esta publicación en cualquier momento sin obligación de notificar dicha revisión a ninguna persona.

La información contenida en esta documentación incluye descripciones generales y/o características técnicas relativas al rendimiento de la máquina mencionada en la misma. Esta documentación no pretende sustituir, ni debe utilizarse para determinar, la idoneidad o fiabilidad de esta máquina para aplicaciones específicas del usuario.

Es obligación de dicho usuario o integrador de sistemas llevar a cabo —en relación con la aplicación o el uso específico del producto en cuestión— un análisis de riesgos, una evaluación y unas pruebas adecuadas y exhaustivas de los productos.

Nota: todas las imágenes utilizadas en este manual tienen únicamente fines ilustrativos y pueden diferir del producto real. Esto se debe a que los colores, las dimensiones y otras características del producto real pueden diferir de los que aparecen en la imagen.

Ni Made for Arcade ni sus filiales o empresas asociadas se hacen responsables del uso indebido de la información contenida en este documento. Si tienes alguna sugerencia de mejora o modificación, o si has detectado algún error en esta documentación, te rogamos que nos lo comuniques.

Durante la instalación y el uso de esta máquina, deben respetarse todas las normas de seguridad nacionales, regionales y locales pertinentes. Por motivos de seguridad y para garantizar el cumplimiento de los datos del sistema documentados, los componentes solo pueden ser reparados por el fabricante.

Si las máquinas se utilizan para aplicaciones sujetas a normativas técnicas de seguridad, deben respetarse las instrucciones correspondientes. El incumplimiento de esta información puede provocar lesiones personales y/o daños en la máquina.

Esta máquina está destinada exclusivamente a fines de entretenimiento. Es no destinada a un uso con fines lucrativos, para la realización de apuestas o el pago de dinero, o para juegos de azar. Made for Arcade no garantiza en modo alguno que el uso, la instalación o el funcionamiento de esta máquina estén permitidos o sean legales en ninguna región, país, jurisdicción o lugar concreto. Es responsabilidad exclusiva del comprador y/o del usuario final asegurarse de que el uso que haga de la máquina cumpla con todas las leyes, normativas y requisitos de licencia o permiso aplicables (incluidas las normativas sobre apuestas, juegos de azar o entretenimiento).

Derechos de autor

Copyright © Made for Arcade. Todos los derechos reservados. Queda prohibida la reproducción, distribución o transmisión total o parcial de esta documentación, en cualquier forma o por cualquier medio —incluidas la fotocopia, la grabación u otros métodos electrónicos o mecánicos— sin la autorización previa por escrito del editor. Envía una solicitud al editor para obtener dicha autorización.

Otros idiomas

Este es el manual de usuario en inglés (o una traducción automática del mismo). Si lo solicitas, es posible que haya manuales disponibles en otros idiomas.

Asistencia y servicio

Para obtener más información, asistencia técnica, realizar pedidos de manuales de usuario o para cualquier otra consulta, ponte en contacto con:
Made for Arcade
Besterdstraat 9a, 5051HH Goirle, Países Bajos
Correo electrónico: [email protected] · Web: madeforarcade.com

Descripción del juego

Shape Match es una activación de emparejamiento de formas de ritmo rápido que se ofrece como un paquete PHP / HTML5 autónomo: sin base de datos, sin dependencias externas y sin SDK de análisis. Simplemente coloca la carpeta en cualquier servidor web compatible con PHP y funciona. El mismo paquete se ejecuta a pantalla completa en un quiosco táctil en un evento, o incrustado como una demostración de navegador dentro de su propio sitio web. Este manual también se aplica a los otros títulos de quiosco de la Serie Signature (Bubble-Pop, 4-in-a-Row y Sliders): comparten la misma instalación, menú de operador, marca y manejo de datos; solo cambia la jugabilidad.

¿Qué hay en el archivo ZIP:

Artículo	Propósito
índice.php	Punto de entrada: ensambla la interfaz de usuario y sirve el código JavaScript del juego.
config.php	Paleta del juego, textos, configuración predeterminada y el MODO DEMOSTRACIÓN bandera.
save.php / load.php	Pequeños puntos de conexión para configuraciones, puntuaciones altas y clientes potenciales de sorteos.
UI_parts.php	HUD reutilizable, teclado en pantalla y elementos auxiliares de los paneles.
pantallas/	Una parcial de PHP por pantalla (inactiva, cuenta regresiva, juego, revelación de puntuación, resumen, etc.).
CSS/design.css	Una sola hoja de estilos con el aspecto característico.
assets/shape_packs/	Paquetes de iconos opcionales que puedes cambiar según la campaña.
sonidos/, música/, imágenes/, imagen de marca/	Audio del juego e ilustraciones predeterminadas.

Uso previsto

Shape Match está pensado como entretenimiento promocional —en ferias, vestíbulos, salas de exposición y en la página web de tu propia campaña— bajo tu control como operador. Se trata de un software que tú mismo alojas y gestionas; no se suministra ningún equipo físico. No hay una edad mínima, pero los niños pequeños deben jugar bajo supervisión.

Cómo conseguirlo

Todos los títulos de Made for Arcade se distribuyen en formato ZIP de descarga inmediata.

1. Compra el juego en madeforarcade.com — El pago lo gestiona nuestro socio de pagos.
2. Guarda el correo electrónico de confirmación: contiene el enlace de descarga y la clave de licencia.
3. Haga clic en el enlace de descarga para obtener shapematch.zip (por lo general, de menos de 20 MB).
4. Descomprime el archivo en tu ordenador; verás una carpeta con índice.php, config.php y las subcarpetas de recursos.

Los enlaces de descarga son válidos durante 7 días y se pueden utilizar hasta 5 veces. ¿Necesitas otro enlace? Responde al correo electrónico de confirmación y emitiremos uno nuevo.

Instalar en tu alojamiento web

El juego funciona en cualquier servidor web compartido o dedicado que admita PHP 8.0 o posterior. No se requiere ninguna base de datos.

1. Abre el panel de control de tu alojamiento web (cPanel, Plesk, DirectAdmin, etc.) o conéctate mediante SFTP.
2. Sube la carpeta descomprimida a tu raíz web — normalmente public_html/ o una subcarpeta como public_html/juegos/shapematch/.
3. Asegúrate de que el datos/ El subdirectorio es grabable (permisos 0775 o superiores): el juego guarda allí la configuración, las puntuaciones más altas y (opcionalmente) las listas de líderes.
4. Accede a tu URL en un navegador, por ejemplo:. https://yourdomain.com/games/shapematch/. La pantalla de espera debería cargarse en un par de segundos.
5. Configura tu propio hash del PIN de operador en server_config.php antes de publicarlo (cambia primero el valor por defecto; consulta el menú «Operador»).

Ejecutar el juego bajo HTTPS: el formulario del operador se envía mediante POST y establece una cookie de sesión, y el código enviado activa automáticamente el indicador de seguridad de la cookie cuando PHP detecta HTTPS.

Instalar localmente con XAMPP

Para realizar pruebas locales, utiliza XAMPP en Windows, macOS o Linux.

1. Descarga e instala XAMPP desde apachefriends.org.
2. Inicia Apache desde el panel de control de XAMPP.
3. Descomprime el juego en C:xampp\htdocs\shapematch (Windows) o /Applications/XAMPP/htdocs/shapematch/ (macOS).
4. Ve a http://localhost/shapematch/index.php. Los cambios en PHP y JS se ven al actualizar la página.

Si las puntuaciones más altas o la configuración no se guardan en Windows, haz clic con el botón derecho del ratón en el datos/ carpeta → Propiedades → Seguridad y concede a «Usuarios» control total.

Ejecutar en un quiosco de pantalla táctil

El juego está diseñado para el modo vertical 1080 × 1920 pantalla táctil, normalmente una pantalla comercial de entre 43″ y 55″ en modo quiosco.

• Utiliza un navegador con soporte a largo plazo (Chrome, Edge o Firefox) con la actualización automática desactivada.
• Abre el navegador a pantalla completa, por ejemplo:. chrome.exe --kiosk --app=http://localhost/shapematch/.
• Gira la pantalla a la orientación vertical en los ajustes de pantalla del sistema operativo.
• Desactiva el salvapantallas, el modo de suspensión y las notificaciones del sistema.
• Mantén desactivada la función de zoom con los dedos (ya está configurado en nuestro CSS, pero comprueba que el sistema operativo no lo anule).
• Para que se inicie automáticamente al arrancar el sistema, añade la URL del quiosco a un acceso directo de inicio con el --quiosco indicador: el juego vuelve a la pantalla de espera por sí solo.

Incrustar en tu propio sitio web

Puedes integrar el juego en tu propia página web corporativa o de campaña como una demo basada en navegador, insertando un iframe que ocupe todo el área de visualización en una página.

• Para ver una demostración pública, configura $DEMO_MODE = true en config.php: el menú del operador está totalmente bloqueado, la configuración se restablece cada vez que se actualiza la página y no se pueden registrar puntuaciones máximas ni líderes.
• Para abrir el menú del operador en una URL activa, añade al final ?operator=1 — En modo normal, esto abre la ventana de solicitud del PIN; en modo de demostración, el menú permanece bloqueado.
• Mantén la relación de aspecto del fotograma en 1080/1920; de lo contrario, el diseño se deformará.

Mecánicas de juego

Shape Match es un juego de emparejamiento cronometrado. En cada ronda aparece una figura objetivo y una cuadrícula con siluetas candidatas; el jugador debe arrastrar la figura objetivo hasta la silueta correspondiente antes de que se agote el tiempo.

1. Pantalla de espera — Una pantalla informativa giratoria llama la atención del jugador.
2. Pulsa para arrancar → una cuenta atrás de 5 segundos.
3. Nivel 1 abre una sencilla cuadrícula de 3 × 3; los jugadores arrastran el objetivo hasta la casilla correspondiente.
4. En cada nivel se añaden casillas giratorias, casillas ocultas o cuadrículas más grandes, y el reloj de formas se vuelve cada vez más ajustado.
5. Se acabó el juego → publicación de la puntuación → registro de la mejor puntuación (nombre + correo electrónico opcional) → Salón de la Fama.
6. Transcurridos 15 segundos, el quiosco vuelve automáticamente al modo de espera.

Puntuación: las combinaciones correctas suman puntos según el nivel multiplicado por el tiempo restante del reloj de formas; las combinaciones incorrectas bloquean la casilla y restan puntos. Cuando hay una imagen de objetivo personalizada activa, en un porcentaje configurable de rondas se utiliza tu logotipo o mascota como objetivo, en lugar de una forma geométrica predeterminada.

Opciones y características del juego

Todos los parámetros ajustables se pueden modificar en tiempo real desde el menú del operador. Los valores predeterminados que se indican a continuación proceden de config.php.

Configuración	Rango	Por defecto
Volumen	0 – 100	70
Tiempo por figura	4 – 20 s	8 s
Figuras para superar el nivel 1	1 – 20	3
RPM de rotación máxima	1 – 25	12
Células giratorias	0 – 30	5
Tono de fondo de la forma	0 – 100	8
Oportunidad de marca objetivo	0 – 100 %	35
Modo de demostración	encendido / apagado	apagado
Paleta de colores	configuración predeterminada o sustitución de un solo color	por defecto

En el modo de demostración, los cambios realizados por el operador solo se aplican a la sesión de navegación; al recargar la página, se restablece la configuración de referencia guardada en shapematch_settings.json.

Menú del operador

El menú de operador es un panel de configuración oculto protegido por un PIN.

• Ábrelo tocando el punto activo invisible de 110 × 110 píxeles situado en la esquina inferior derecha de la pantalla de espera, o accede directamente a index.php?operator=1.
• Introduce el PIN del operador. El valor predeterminado de fábrica es 2468 y es pública: sustituye el hash SHA-256 (operator_pin_sha256) en server_config.php antes de cualquier implementación pública, o tu configuración quedará totalmente expuesta.

Desde el menú puedes ajustar todos los parámetros anteriores, además de las opciones de personalización de marca:

Opción	Para qué sirve
Medios de comunicación de marca	Imagen o vídeo breve que se muestra en la pantalla de espera.
Imagen de marca del objetivo	El archivo PNG utilizado como forma de la marca objetivo.
Nombre de la marca	Sustituye la placa del título en reposo y la etiqueta del pie de página.
Paleta de colores	Por defecto, o elige cualquier color para cambiar el color de toda la interfaz de usuario.

Paquetes de formas

Los paquetes de formas son archivos ZIP que contienen iconos PNG / WebP transparentes (hasta 30 por paquete, 10 paquetes en total). Súbelos desde el menú del operador: cada paquete se normaliza automáticamente a 512 × 512 y se almacena en assets/shape_packs/. Cambia el paquete activo en el menú desplegable; el juego volverá a utilizar sus formas geométricas integradas cuando no haya ningún paquete activo (o haya menos de dos formas habilitadas). En el modo de demostración, la carga de paquetes de formas está desactivada, ya que implicaría escribir en el disco.

Recuperar la lista de datos

Todos los datos proporcionados por los jugadores se almacenan como archivos de texto sin formato dentro del juego datos/ carpeta: sin base de datos, no se puede exportar a la nube.

Datos	Ubicación
Mejores puntuaciones	data/high_scores/shapematch_highscores.json — nombre, puntuación, nivel y formas coincidentes.
Sorteo / clientes potenciales	data/user_data_csv/shapematch_raffle_leads.csv — una línea por cliente potencial; se abre en Excel, Numbers o Google Sheets.

Para obtener los archivos: conéctate al servidor mediante SFTP o SSH y descárgalos desde /data/high_scores/ y /data/user_data_csv/, o utiliza el gestor de archivos del panel de control de tu alojamiento web. Actualiza el archivo de clientes potenciales tras cada activación y transfiere los datos a tu CRM o herramienta de mailing.

Nunca expongas datos/ a través de HTTP. Añade un .htaccess con Denegar el acceso a todos dentro del datos/ carpeta, o bien trasládala fuera de la raíz de tu sitio web, para que los «leads» y las puntuaciones más altas no sean accesibles públicamente.

Cumplimiento del RGPD

Made for Arcade se encarga de la distribución del software; Usted es el responsable del tratamiento de datos por cualquier información facilitada por los jugadores. Todos los datos permanecen en tu propio servidor; no se transmite nada a Made for Arcade.

Datos que puede recopilar el juego: el nombre de usuario del jugador (máximo 18 caracteres); una dirección de correo electrónico (opcional —solo si el jugador se inscribe para participar en el sorteo de premios—); un campo de texto libre opcional; y el récord de puntuación más alta. No recopila direcciones IP, huellas digitales de dispositivos, cookies de análisis ni rastreadores de terceros.

Tus responsabilidades como operador o responsable del tratamiento:

1. Muestra un breve aviso de consentimiento en tu stand o página web en el que se explique por qué recopilas el nombre y la dirección de correo electrónico.
2. Ofrece una opción de consentimiento clara (la casilla de verificación del RGPD dentro del juego); nunca la marques por defecto.
3. Mantén un calendario de conservación de datos (muchas campañas eliminan los datos de los clientes potenciales 90 días después de que finalice el sorteo).
4. Responde a las solicitudes de acceso y eliminación: el archivo CSV es de tu propiedad, por lo que las modificaciones se realizan manualmente.
5. Publica la URL de la política de privacidad siempre que incrustes el juego.
6. En la UE y el Reino Unido, puedes incluir a Made for Arcade como encargado del tratamiento únicamente para el software; nosotros nunca vemos los datos de los clientes potenciales.

Cuando $DEMO_MODE = true, la recopilación de datos de contacto está desactivada en el servidor; incluso el correo electrónico de un jugador que haya dado su consentimiento se descarta. Utiliza el modo de demostración para cualquier URL pública en la que no estés llevando a cabo una campaña real.

Licenciamiento musical

El juego incluye una lista de reproducción musical con licencia para Únicamente para uso no comercial en quioscos. Si tienes pensado reproducir música al estilo de las emisoras de radio comerciales en espacios públicos, sustituye las pistas del música/ carpeta con las licencias que gestionas.