Quer revender ou alugar máquinas de entretenimento? Os parceiros da MFA Pro têm mais vantagens →
Português

Made for Arcade

Shape Match — Jogo de quiosque — Manual do utilizador.

Está com pressa? Encomende online para obter o prazo de entrega mais rápido — ou solicite um orçamento para projetos personalizados e preços por volume.

O Shape Match é um jogo para ecrãs táteis em PHP/HTML5, disponível para download, destinado a feiras, átrios e sítios Web: o jogador arrasta cada figura-alvo para o recorte correspondente antes que o tempo se esgote. Este manual aborda o download, a instalação, a configuração do quiosque, a jogabilidade, o menu do operador, a recolha de contactos e o RGPD.

Atenção: Este é um software que o próprio utilizador hospeda — antes de qualquer implementação pública, altere o PIN predefinido do operador e certifique-se de que o jogo está dados/ A pasta nunca pode ser consultada através da Internet. O utilizador é o responsável pelo tratamento de quaisquer dados dos jogadores que recolher.

Aviso legal

A Made for Arcade não faz quaisquer declarações nem oferece quaisquer garantias relativamente a este manual e, na medida máxima permitida por lei, limita expressamente a sua responsabilidade por qualquer incumprimento de qualquer garantia resultante da substituição deste manual por outro. Além disso, a Made for Arcade reserva-se o direito de rever esta publicação a qualquer momento, sem obrigação de notificar qualquer pessoa sobre a revisão.

A informação contida nesta documentação inclui descrições gerais e/ou características técnicas relativas ao desempenho da máquina aqui mencionada. Esta documentação não se destina a substituir, nem deve ser utilizada para determinar, a adequação ou fiabilidade desta máquina para aplicações específicas do utilizador.

Compete a esse utilizador ou integrador de sistemas realizar — no que diz respeito à aplicação ou utilização específica em causa do produto — uma análise de riscos, uma avaliação e ensaios adequados e completos dos produtos.

Nota: todas as imagens utilizadas neste manual têm apenas fins ilustrativos e podem diferir do produto real. Isto deve-se ao facto de as cores, dimensões e outras características do produto real poderem diferir das apresentadas na imagem.

A Made for Arcade e/ou as suas afiliadas ou subsidiárias não se responsabilizam por qualquer utilização indevida das informações contidas neste documento. Se tiver alguma sugestão de melhorias ou alterações, ou se tiver encontrado algum erro nesta documentação, por favor, informe-nos.

É obrigatório respeitar todos os regulamentos de segurança nacionais, regionais e locais aplicáveis aquando da instalação e utilização desta máquina. Por razões de segurança e para garantir a conformidade com os dados do sistema documentados, os componentes só podem ser reparados pelo fabricante.

Caso as máquinas sejam utilizadas em aplicações sujeitas a normas técnicas de segurança, devem ser respeitadas as instruções pertinentes. O incumprimento destas informações pode resultar em ferimentos pessoais e/ou danos na máquina.

Esta máquina destina-se exclusivamente a fins de entretenimento. É não destinado a ser utilizado com fins lucrativos, para apostas ou pagamentos em dinheiro, ou para jogos de azar ou jogos de sorte. A Made for Arcade não faz qualquer declaração nem oferece qualquer garantia de que a utilização, instalação ou funcionamento desta máquina seja permitido ou legal em qualquer região, país, jurisdição ou local específico. É da exclusiva responsabilidade do comprador e/ou do utilizador final garantir que a utilização da máquina cumpre todas as leis, regulamentos e requisitos de licenciamento ou autorização aplicáveis (incluindo quaisquer regulamentos relativos a jogos de azar, jogos ou diversão).

Copyright © Made for Arcade. Todos os direitos reservados. Nenhuma parte desta documentação pode ser reproduzida, distribuída ou transmitida sob qualquer forma ou por qualquer meio, incluindo fotocópia, gravação ou outros métodos eletrónicos ou mecânicos, sem a autorização prévia por escrito da editora. Envie um pedido de autorização à editora.

Outros idiomas

Este é o manual do utilizador em inglês (ou uma tradução automática do mesmo). Podem estar disponíveis manuais noutros idiomas, mediante pedido.

Assistência e serviços

Para mais informações, assistência, apoio técnico, encomenda de manuais do utilizador ou para quaisquer outras questões, contacte:
Made for Arcade
Besterdstraat 9a, 5051HH Goirle, Países Baixos
E-mail: [email protected] · Web: madeforarcade.com

Descrição do jogo

O Shape Match é uma atividade dinâmica de correspondência de formas, disponibilizada como um pacote autónomo em PHP/HTML5 — sem base de dados, sem dependências externas e sem SDKs de análise. Basta colocar a pasta em qualquer servidor web compatível com PHP e fica pronto a funcionar. O mesmo pacote funciona em ecrã inteiro num quiosque com ecrã tátil num evento, ou incorporado como uma demonstração no navegador dentro do seu próprio site. Este manual também se aplica aos outros títulos da série Signature para quiosques (Bubble-Pop, 4-in-a-Row e Sliders): partilham a mesma instalação, menu do operador, identidade de marca e gestão de dados — apenas a jogabilidade difere.

O que está incluído no ficheiro ZIP:

Artigo Objetivo
index.php Ponto de entrada — monta a interface do utilizador e executa o código JavaScript da jogabilidade.
config.php Paleta do jogo, textos, definições predefinidas e o MODO_DE_DEMONSTRAÇÃO bandeira.
save.php / load.php Pequenos endpoints para definições, recordes e contactos de sorteios.
UI_parts.php HUD reutilizável, teclado no ecrã e auxiliares de painel.
ecrãs/ Um parcial PHP por ecrã (estado de inatividade, contagem decrescente, jogabilidade, revelação da pontuação, resumo, etc.).
CSS/design.css Uma única folha de estilo com o visual característico.
assets/shape_packs/ Conjuntos de ícones opcionais que pode alternar consoante a campanha.
sons/, música/, imagens/, imagem de marca/ Áudio do jogo e imagens padrão.

Utilização prevista

O Shape Match destina-se a ser uma forma de entretenimento promocional — em feiras, átrios, salas de exposição e no seu próprio site de campanha — sob o seu controlo enquanto operador. Trata-se de um software que o utilizador hospeda e executa; não é fornecida qualquer máquina física. Não há idade mínima, mas as crianças pequenas devem jogar sob supervisão.

Como obtê-lo

Todos os títulos da série «Made for Arcade» são distribuídos num ficheiro ZIP para download imediato.

  1. Compre o jogo em madeforarcade.com — o pagamento é processado pelo nosso parceiro de pagamentos.
  2. Guarde o e-mail de confirmação — contém o link para o download e a chave de licença.
  3. Clique na ligação de download para fazer o download shapematch.zip (normalmente menos de 20 MB).
  4. Descompacte localmente — irá ver uma pasta com index.php, config.php e as subpastas de recursos.

Os links de download são válidos por 7 dias e podem ser utilizados até 5 vezes. Precisa de outro link? Responda ao e-mail de confirmação e enviar-lhe-emos outro.

Instale no seu servidor web

O jogo funciona em qualquer servidor web partilhado ou dedicado que suporte PHP 8.0 ou posterior. Não é necessário qualquer banco de dados.

  1. Abra o painel de controlo do seu alojamento (cPanel, Plesk, DirectAdmin, etc.) ou ligue-se através de SFTP.
  2. Carregue a pasta descompactada para a raiz do seu site — normalmente public_html/ ou uma subpasta como, por exemplo, public_html/games/shapematch/.
  3. Certifique-se de que o dados/ o subdiretório é gravável (permissões 0775 ou superiores) — o jogo grava aí as definições, os recordes e (opcionalmente) as pontuações.
  4. Aceda ao seu URL num navegador, por exemplo:. https://yourdomain.com/games/shapematch/. O ecrã de espera deverá carregar em poucos segundos.
  5. Defina o seu próprio hash do PIN da operadora em server_config.php antes de publicar (altere primeiro a predefinição — consulte o menu «Operador»).

Executa o jogo em HTTPS: o formulário do operador é enviado através do método POST e define um cookie de sessão, e o código fornecido define automaticamente o sinalizador de segurança do cookie quando o PHP deteta HTTPS.

Instalar localmente com o XAMPP

Para testes locais, utilize o XAMPP no Windows, no macOS ou no Linux.

  1. Descarregue e instale o XAMPP a partir do site apachefriends.org.
  2. Inicie o Apache a partir do painel de controlo do XAMPP.
  3. Descompacte o jogo na pasta C:xampp\htdocs\shapematch (Windows) ou /Applications/XAMPP/htdocs/shapematch/ (macOS).
  4. Aceda a http://localhost/shapematch/index.php. As alterações ao PHP/JS ficam visíveis ao atualizar a página.

Se as pontuações mais altas ou as definições não forem guardadas no Windows, clique com o botão direito do rato no dados/ pasta → Propriedades → Segurança e atribua aos «Utilizadores» controlo total.

Funciona num quiosque com ecrã tátil

O jogo foi concebido para o modo retrato 1080 × 1920 ecrã tátil, normalmente um ecrã comercial de 43″–55″ em modo quiosque.

  • Utilize um navegador com suporte a longo prazo (Chrome, Edge ou Firefox) com a atualização automática desativada.
  • Inicie o navegador em ecrã inteiro, por exemplo:. chrome.exe --kiosk --app=http://localhost/shapematch/.
  • Gire o ecrã para a orientação vertical nas definições de ecrã do sistema operativo.
  • Desativar o protetor de ecrã, o modo de suspensão e as notificações do sistema.
  • Manter a função «pinch-to-zoom» desativada (já está definida no nosso CSS, mas verifique se o sistema operativo não a substitui).
  • Para iniciar automaticamente ao arrancar o computador, associe o URL do quiosque a um atalho de arranque com o --quiosque flag — o jogo volta automaticamente ao ecrã de espera.

Incorporar no seu próprio site

Pode incorporar o jogo no seu próprio site corporativo ou de campanha como uma demonstração no navegador, inserindo um iframe que ocupe todo o ecrã numa página.

  • Para uma demonstração pública, defina $DEMO_MODE = true em config.php: o menu do operador está totalmente bloqueado, as definições são repostas sempre que a página é recarregada e o registo de pontuações máximas e líderes está desativado.
  • Para abrir o menu do operador numa URL ativa, acrescente ?operator=1 — no modo normal, isto abre o pedido do PIN; no modo de demonstração, o menu permanece bloqueado.
  • Mantenha a proporção do quadro em 1080/1920, caso contrário o layout ficará distorcido.

Mecânicas de jogo

O Shape Match é um jogo de correspondência com limite de tempo. Em cada ronda, é apresentada uma forma-alvo e uma grelha com recortes possíveis; o jogador arrasta a forma-alvo para o recorte correspondente antes que o tempo se esgote.

  1. Ecrã de inatividade — um painel informativo giratório atrai o jogador.
  2. Prima para iniciar → uma contagem decrescente de 5 segundos.
  3. Nível 1 abre uma grelha simples de 3 × 3; os jogadores arrastam o alvo para a célula correspondente.
  4. Cada nível adiciona células rotativas, células ocultas ou grelhas maiores, e o relógio de formas torna-se mais apertado.
  5. Fim do jogo → revelação da pontuação → registo da pontuação mais alta (nome + e-mail opcional) → Quadro de Honra.
  6. Após 15 segundos, o quiosque volta automaticamente ao modo de espera.

Pontuação: as combinações corretas valem pontos com base no nível × tempo restante do relógio da forma; as combinações erradas bloqueiam a célula e resultam na perda de pontos. Quando uma imagem-alvo personalizada está ativa, uma percentagem configurável das rondas utiliza o seu logótipo ou mascote como alvo, em vez de uma forma geométrica predefinida.

Opções e funcionalidades do jogo

Todas as definições ajustáveis podem ser editadas em tempo real a partir do menu do operador. Os valores predefinidos abaixo provêm de config.php.

Cenário Gama Padrão
Volume 0 – 100 70
Tempo por figura 4 – 20 s 8 s
Formas para passar o nível 1 1 – 20 3
RPM de rotação máxima 1 – 25 12
Células rotativas 0 – 30 5
Tonalidade de fundo da forma 0 – 100 8
Oportunidade de alvo da marca 0 – 100 % 35
Modo de demonstração ligado / desligado desligado
Esquema de cores substituição da cor padrão ou de cor única padrão

No modo de demonstração, as alterações feitas pelo operador aplicam-se apenas à sessão de navegação — ao recarregar a página, é restaurada a configuração inicial guardada em shapematch_settings.json.

Menu do operador

O menu do operador é um painel de definições oculto, protegido por um PIN.

  • Abra-o tocando no ponto ativo invisível de 110 × 110 px no canto inferior direito do ecrã de espera, ou aceda diretamente a index.php?operator=1.
  • Introduza o PIN do operador. A configuração predefinida de fábrica é 2468 e é público — substitua o hash SHA-256 (operator_pin_sha256) em server_config.php antes de qualquer implementação pública, caso contrário, as suas definições ficarão totalmente expostas.

A partir do menu, pode ajustar todas as definições acima, bem como as opções de personalização da marca:

Opção O que faz
Meios de comunicação de marca Imagem ou vídeo curto exibido no painel de espera.
Imagem da marca O ficheiro PNG utilizado como forma-alvo da marca.
Nome da marca Substitui a placa de título e a etiqueta do rodapé em modo de inatividade.
Esquema de cores Padrão, ou escolha qualquer cor para alterar a cor de toda a interface do utilizador.

Pacotes de formas

Os pacotes de ícones são ficheiros ZIP com ícones PNG/WebP transparentes (até 30 por pacote, num total de 10 pacotes). Carregue-os a partir do menu do operador — cada pacote é automaticamente normalizado para 512 × 512 e guardado em assets/shape_packs/. Selecione o pacote ativo no menu suspenso; o jogo recorre às suas formas geométricas integradas quando não há nenhum pacote ativo (ou quando há menos de duas formas ativadas). No modo de demonstração, o carregamento de pacotes de formas está desativado, uma vez que implicaria a gravação em disco.

Recuperar a lista de dados

Todos os dados fornecidos pelos jogadores são armazenados como ficheiros simples no interior do jogo dados/ pasta — sem base de dados, sem exportação para a nuvem.

Dados Localização
Melhores pontuações data/high_scores/shapematch_highscores.json — nome, pontuação, nível e formas correspondentes.
Sorteio / contactos data/user_data_csv/shapematch_raffle_leads.csv — uma linha por cliente potencial; abre no Excel, no Numbers ou no Google Sheets.

Para obter os ficheiros: aceda ao servidor via SFTP/SSH e faça o download a partir de /data/high_scores/ e /data/user_data_csv/, ou utilize o Gestor de Ficheiros do painel de controlo do seu alojamento. Atualize o ficheiro de leads após cada ativação e transfira-o para o seu CRM ou ferramenta de mailing.

Nunca exponha dados/ através de HTTP. Adicionar um .htaccess com Negar a todos dentro do dados/ pasta, ou movê-la para fora da raiz do seu site, para que os leads e as pontuações mais altas não fiquem acessíveis ao público.

Conformidade com o RGPD

A Made for Arcade fornece o software; é o responsável pelo tratamento de dados relativamente a qualquer informação fornecida pelo jogador. Todos os dados permanecem no seu próprio servidor — nada é transmitido à Made for Arcade.

O que o jogo pode recolher: o nome de utilizador do jogador (máximo de 18 caracteres); um endereço de e-mail (opcional — apenas se o jogador optar por participar no sorteio de prémios); um campo opcional de texto livre; e o registo da pontuação mais alta. Não recolhe endereços IP, impressões digitais do dispositivo, cookies analíticos nem rastreadores de terceiros.

As suas responsabilidades enquanto operador/responsável pelo tratamento de dados:

  1. Apresente um breve aviso de consentimento no seu stand ou na sua página, explicando por que razão recolhe o nome e o endereço de e-mail.
  2. Ofereça uma opção de aceitação clara (a caixa de seleção do RGPD no jogo) — nunca a marque previamente.
  3. Mantenha um calendário de retenção (muitas campanhas eliminam os contactos 90 dias após o encerramento do sorteio).
  4. Responder aos pedidos de acesso e eliminação — o ficheiro CSV é da sua responsabilidade, pelo que as alterações são feitas manualmente.
  5. Publique o URL da política de privacidade sempre que incorporar o jogo.
  6. Na UE/Reino Unido, pode indicar a Made for Arcade como subcontratante apenas para o software — nunca temos acesso aos contactos.

Quando $DEMO_MODE = true, o registo de dados de contacto está desativado do lado do servidor — mesmo o e-mail de um jogador que tenha dado o seu consentimento é descartado. Utilize o modo de demonstração para qualquer URL pública em que não esteja a realizar uma campanha real.

Licenciamento musical

O jogo inclui uma lista de reprodução de músicas licenciada para apenas para utilização não comercial em quiosques. Se pretender fazer uma reprodução ao estilo das rádios comerciais em espaços públicos, substitua as faixas no música/ pasta com as licenças que controlas.

4.8/5 em
Cesto de compras
Venda por grosso →
Ir para o topo da página