Potrivire de forme — Joc de chioșc — Manual de utilizare.

Shape Match este un joc PHP/HTML5 cu ecran tactil descărcabil pentru târguri comerciale, lobby-uri și site-uri web: un jucător trage fiecare formă țintă în decupajul corespunzător înainte de expirarea timpului. Acest manual acoperă descărcarea, instalarea, configurarea chioșcului, jocul, meniul operatorului, capturarea de clienți potențiali și GDPR.

Prudență: acesta este un software pe care îl găzduiești singur — înainte de orice implementare publică, schimbă codul PIN implicit al operatorului și asigură-te că jocul data/ Folderul nu poate fi niciodată răsfoit pe web. Tu ești operatorul de date pentru orice date despre jucători pe care le colectezi.

Declinare a responsabilităţii

Made for Arcade nu oferă nicio declarație și nu oferă nicio garanție cu privire la acest manual și, în măsura maximă permisă de lege, își limitează în mod expres răspunderea pentru orice neconformitate cu orice garanție rezultată din înlocuirea acestui manual cu altul. În plus, Made for Arcade își rezervă dreptul de a revizui această publicație în orice moment, fără obligația de a notifica vreo persoană cu privire la revizuire.

Informațiile din această documentație conțin descrieri generale și/sau caracteristici tehnice ale performanței mașinii menționate în această documentație. Această documentație nu este destinată să înlocuiască și nu ar trebui utilizată pentru a determina adecvarea sau fiabilitatea acestei mașini pentru aplicații specifice ale utilizatorilor.

Este obligația unui astfel de utilizator sau integrator de sistem să efectueze — în legătură cu aplicația sau utilizarea specifică relevantă a produsului — o analiză a riscurilor, o evaluare și o testare adecvate și complete ale produselor.

Atenție: toate imaginile utilizate în acest manual sunt doar cu titlu ilustrativ și pot diferi de produsul real. Acest lucru se datorează faptului că culorile, dimensiunile și alte proprietăți ale produsului real pot diferi de imagine.

Made for Arcade și/sau afiliații sau filialele sale nu sunt responsabile pentru nicio utilizare necorespunzătoare a informațiilor conținute în acest document. Dacă aveți sugestii pentru îmbunătățiri sau modificări sau ați găsit erori în această documentație, vă rugăm să ne anunțați.

La instalarea și utilizarea acestei mașini trebuie respectate toate reglementările de siguranță naționale, regionale și locale relevante. Din motive de siguranță și pentru a asigura conformitatea cu datele de sistem documentate, componentele pot fi reparate numai de către producător.

Dacă mașinile sunt utilizate pentru aplicații cu reglementări tehnice de siguranță, trebuie respectate instrucțiunile relevante. Nerespectarea acestor informații poate duce la vătămări corporale și/sau deteriorarea mașinii.

Acest aparat este destinat exclusiv divertismentului. Este nu destinate utilizării în scop lucrativ, pentru parierea sau plata de bani sau pentru jocuri de noroc sau jocuri de noroc. Made for Arcade nu oferă nicio garanție și nu garantează că utilizarea, instalarea sau operarea acestui aparat este permisă sau legală în orice regiune, țară, jurisdicție sau loc anume. Este responsabilitatea exclusivă a cumpărătorului și/sau a utilizatorului final să se asigure că utilizarea aparatului respectă toate legile, reglementările și cerințele de licențiere sau autorizare aplicabile (inclusiv orice reglementări privind jocurile de noroc, jocurile de noroc sau divertismentul).

Drepturi de autor

Copyright © Made for ArcadeToate drepturile rezervate. Nicio parte a acestei documentații nu poate fi reprodusă, distribuită sau transmisă sub nicio formă sau prin niciun mijloc, inclusiv fotocopiere, înregistrare sau alte metode electronice sau mecanice, fără permisiunea prealabilă scrisă a editorului. Trimiteți o cerere editorului pentru permisiune.

Alte limbi

Acesta este manualul de utilizare în limba engleză (sau o traducere automată a acestuia). Manuale în alte limbi pot fi disponibile la cerere.

Asistență și service

Pentru mai multe informații, service, asistență tehnică, comandarea manualelor de utilizare sau pentru orice alte întrebări, vă rugăm să contactați:
Made for Arcade
Besterdstraat 9a, 5051HH Goirle, Țările de Jos
E-mail: [e-mail protejat] · Web: madeforarcade.com

descriere joc

Shape Match este o activare de potrivire a formelor cu ritm ridicat, livrată ca un pachet PHP/HTML5 autonom — fără bază de date, fără dependențe externe și fără SDK-uri de analiză. Plasați folderul pe orice gazdă web compatibilă cu PHP și acesta funcționează. Același pachet rulează pe ecran complet pe un chioșc cu ecran tactil la un eveniment sau este încorporat ca o demonstrație de browser în propriul site web. Acest manual se aplică și celorlalte titluri de chioșcuri din seria Signature (Bubble-Pop, 4-in-a-Row și Sliders): au în comun instalarea, meniul operatorului, brandingul și gestionarea datelor — diferă doar modul de joc.

Ce se află în codul poștal:

Articol	Scop
index.php	Punct de intrare — asamblează interfața utilizator și servește codul JavaScript pentru joc.
config.php	Paleta de jocuri, texte, setări implicite și DEMO_MODE steag.
save.php / load.php	Puncte finale minuscule pentru setări, scoruri mari și oportunități de tombolă.
UI_parts.php	HUD reutilizabil, tastatură de pe ecran și panouri de asistență.
screens/	O partiție PHP per ecran (inactivitate, numărătoare inversă, joc, dezvăluire scor, recapitulare etc.).
CSS/design.css	Foaie de stil unică cu aspectul caracteristic.
assets/shape_packs/	Pachete opționale de pictograme pe care le poți schimba în funcție de campanie.
sounds/, music/, images/, branding/	Sunetul jocului și grafica implicită.

Utilizarea prevăzută

Shape Match este conceput ca divertisment promoțional — la târguri comerciale, în spații de recepție, showroom-uri și pe propriul site web al campaniei — sub controlul dumneavoastră în calitate de operator. Este un software pe care îl găzduiți și îl rulați; nu este furnizat niciun dispozitiv fizic. Nu există o vârstă minimă, dar copiii mici ar trebui să se joace sub supraveghere.

Cum să obțineți

Fiecare Made for Arcade Titlul este distribuit ca fișier ZIP cu descărcare instantanee.

1. Cumpără jocul pe madeforarcade.com — plata este gestionată de partenerul nostru de finalizare a comenzii.
2. Salvați e-mailul de confirmare — acesta conține linkul de descărcare și cheia de licență.
3. Faceți clic pe linkul de descărcare pentru a prelua shapematch.zip (de obicei sub 20 MB).
4. Dezarhivați local — veți vedea un folder cu index.php, config.php și subfolderele de active.

Linkurile de descărcare sunt valabile timp de 7 zile și pot fi folosite de până la 5 ori. Aveți nevoie de un alt link? Răspundeți la e-mailul de confirmare și vom reemite unul.

Instalați pe gazda dvs. web

Jocul rulează pe orice gazdă web partajată sau dedicată care acceptă PHP 8.0 sau o versiune ulterioarăNu este necesară nicio bază de date.

1. Deschide panoul de control al găzduirii (cPanel, Plesk, DirectAdmin etc.) sau conectează-te prin SFTP.
2. Încărcați folderul dezarhivat în rădăcina web — de obicei public_html/ sau un subfolder, cum ar fi public_html/games/shapematch/.
3. Asigurați-vă că data/ Subdirectorul este accesibil prin scriere (permisiuni 0775 sau mai mari) — jocul scrie setările, scorurile mari și (opțional) lead-urile acolo.
4. Accesați adresa URL într-un browser, de ex. https://yourdomain.com/games/shapematch/Ecranul de repaus ar trebui să se încarce în câteva secunde.
5. Setați propriul cod hash al PIN-ului operatorului server_config.php înainte de a deveni public (modificați mai întâi setarea implicită — consultați meniul Operator).

Rulați jocul sub HTTPSFormularul operatorului trimite o comandă prin POST și setează un cookie de sesiune, iar codul livrat setează automat indicatorul de securitate al cookie-ului atunci când PHP detectează HTTPS.

Instalare locală cu XAMPP

Pentru testarea locală, utilizați XAMPP pe Windows, macOS sau Linux.

1. Descărcați și instalați XAMPP de pe apachefriends.org.
2. Porniți Apache din panoul de control XAMPP.
3. Dezarhivați jocul în C:xampphtdocsshapematch (Windows) sau /Applications/XAMPP/htdocs/shapematch/ (mac OS).
4. Căutați http://localhost/shapematch/index.phpModificările aduse PHP/JS sunt vizibile la reîmprospătare.

Dacă scorurile mari sau setările nu se salvează în Windows, faceți clic dreapta pe data/ folder → Proprietăți → Securitate și oferiți utilizatorilor control deplin.

Rulați pe un chioșc cu ecran tactil

Jocul este conceput pentru un portret 1080 1920 × ecran tactil, de obicei un afișaj comercial de 43″–55″ în modul chioșc.

• Folosește un browser cu suport pe termen lung (Chrome, Edge sau Firefox) cu actualizarea automată dezactivată.
• Porniți browserul pe ecran complet, de ex. chrome.exe --kiosk --app=http://localhost/shapematch/.
• Rotiți afișajul în modul portret în setările de afișare ale sistemului de operare.
• Dezactivați screensaver-ul, modul de repaus și notificările de sistem.
• Mențineți dezactivată opțiunea pinch-to-zoom (deja gestionată în CSS-ul nostru, dar verificați dacă sistemul de operare nu o suprascrie).
• Pentru a porni automat la pornire, fixați adresa URL a chioșcului la o comandă rapidă de pornire cu --kiosk steag — jocul se reia singur la ecranul de repaus.

Încorporați în propriul site web

Puteți încorpora jocul în propriul site corporativ sau de campanie ca o demonstrație bazată pe browser, plasând un iframe cu fereastră de vizualizare completă pe o pagină.

• Pentru o demonstrație publică, setați $DEMO_MODE = true in config.phpMeniul operatorului este complet blocat, setările revin la fiecare reîncărcare a paginii, iar scrierile cu scoruri mari / clienți potențiali sunt dezactivate.
• Pentru a deschide meniul operatorului printr-o adresă URL activă, adăugați ?operator=1 — în modul normal, aceasta deschide solicitarea PIN; în modul demo, meniul rămâne blocat.
• Păstrează raportul de aspect al cadrului la 1080/1920, altfel aspectul se va întinde.

Mecanica jocului

Jocul de potrivire a formelor este un joc de potrivire cronometrat. Fiecare rundă prezintă o formă țintă și o grilă de decupaje candidate; jucătorul trage ținta în decupajul corespunzător înainte ca ceasul formei să se termine.

1. Ecran inactiv — un pachet de informații rotativ atrage jucătorul.
2. Apăsați pentru a începe → o numărătoare inversă de 5 secunde.
3. Nivel 1 deschide o grilă simplă de 3 × 3; jucătorii trag ținta în celula corespunzătoare.
4. Fiecare nivel adaugă celule rotative, celule voalate sau grile mai mari, iar ceasul formei devine mai precis.
5. Joc peste → dezvăluirea scorului → înscriere cu scorul cel mai mare (nume + e-mail opțional) → Galeria Famei.
6. După 15 secunde, chioșcul revine automat în modul inactiv.

Scor: potrivirile corecte acumulează puncte în funcție de nivelul × forma rămasă a ceasului; potrivirile greșite blochează celula și costă puncte. Când o imagine țintă personalizată este activă, un procent configurabil de runde folosește sigla sau mascota ta ca țintă în loc de o formă geometrică încorporată.

Opțiuni și caracteristici ale jocului

Fiecare setare reglabilă poate fi editată live din meniul operatorului. Valorile implicite de mai jos provin din config.php.

reglaj	Gamă	Mod implicit
Volum	0 - 100	70
Timp per formă	4 - 20 s	8 s
Forme pentru a trece nivelul 1	1 - 20	3
Rotație maximă RPM	1 - 25	12
Celule rotative	0 - 30	5
Ton de fundal al formei	0 - 100	8
Șansa de țintă a mărcii	0 - 100%	35
Demo	pornit / oprit	de pe
Schema de culori	suprascriere implicită sau cu o singură culoare	lipsă

În modul demo, modificările operatorului se aplică numai pentru sesiunea de navigare — reîncărcarea paginii restabilește valoarea de referință salvată în shapematch_settings.json.

Meniul operator

Meniul operatorului este un panou de setări ascuns în spatele unui cod PIN.

• Deschideți-l atingând punctul de acces invizibil de 110 × 110 px din colțul din dreapta jos al ecranului de repaus sau creați un link direct către index.php?operator=1.
• Introduceți codul PIN al operatorului. Setarea implicită de livrare este 2468 și este publică — înlocuiește hash-ul SHA-256 (operator_pin_sha256) în server_config.php înainte de orice implementare publică sau setările sunt deschise complet.

Din meniu puteți ajusta fiecare setare de mai sus, plus opțiunile de branding:

Opțiune	Ce face
Media de branding	Imagine sau videoclip scurt afișat în setul inactiv.
Imagine țintă de marcă	PNG-ul folosit ca formă țintă a mărcii.
Titlul mărcii	Înlocuiește plăcuța de titlu și eticheta de subsol de pe pagina inactivă.
Schema de culori	Implicită sau alegeți orice culoare pentru a recolora întreaga interfață.

Pachete de forme

Pachetele de forme sunt fișiere ZIP cu pictograme PNG / WebP transparente (până la 30 per pachet, 10 pachete în total). Încărcați din meniul operatorului — fiecare pachet este normalizat automat la 512 × 512 și stocat în assets/shape_packs/Schimbă pachetul activ din meniul derulant; jocul revine la formele geometrice încorporate atunci când niciun pachet (sau mai puțin de 2 forme activate) nu este activ. În modul demo, încărcarea pachetelor de forme este dezactivată deoarece ar scrie pe disc.

Recuperarea listei de date

Toate datele furnizate de jucători sunt stocate ca fișiere simple în interiorul jocului data/ folder — fără bază de date, fără export în cloud.

Date	Locație
Scoruri mari	data/high_scores/shapematch_highscores.json — nume, scor, nivel și forme potrivite.
Tombola / clienți potențiali	data/user_data_csv/shapematch_raffle_leads.csv — o linie per client potențial; se deschide în Excel, Numbers sau Google Sheets.

Pentru a prelua fișierele: conectați-vă la gazdă prin SFTP / SSH și descărcați de pe /data/high_scores/ și /data/user_data_csv/sau utilizați Managerul de fișiere din panoul de control al găzduirii. Rotiți fișierul de clienți potențiali după fiecare activare și mutați-l în CRM sau în instrumentul de e-mail.

Nu expuneți niciodată data/ prin HTTP. Adauga o .htaccess implementate cu Deny from all în interiorul data/ folder sau mutați-l în afara rădăcinii web, astfel încât clienții potențiali și scorurile mari să nu poată fi răsfoiți public.

Respectarea GDPR

Made for Arcade livrează software-ul; sunteți operatorul de date pentru orice informație furnizată de jucător. Toate datele rămân pe propria gazdă — nimic nu este transmis către Made for Arcade.

Ce poate colecta jocul: numele afișat al jucătorului (maxim 18 caractere); o adresă de e-mail (opțională - numai dacă jucătorul optează pentru premii la tombolă); un câmp opțional cu opțiune liberă; și înregistrarea celui mai mare scor. Nu colectează nicio adresă IP, amprentă digitală a dispozitivului, cookie analitic sau tracker terț.

Responsabilitățile dumneavoastră în calitate de operator / operator de date:

1. Afișați o scurtă notificare de consimțământ pe standul sau pagina dvs., explicând de ce colectați numele și adresa de e-mail.
2. Oferiți o opțiune clară de înscriere (caseta de selectare GDPR din joc) - nu o bifați niciodată în prealabil.
3. Mențineți un program de retenție (multe campanii șterg clienții potențiali la 90 de zile de la închiderea tombolei).
4. Răspundeți la solicitările de acces și ștergere — fișierul CSV este proprietatea dvs., așadar modificările se fac manual.
5. Publică o adresă URL cu politica de confidențialitate oriunde încorporezi jocul.
6. În UE / Regatul Unit, puteți lista Made for Arcade ca procesor doar pentru software — nu vedem niciodată pistele.

Atunci când $DEMO_MODE = true, scrierile pentru captarea de clienți potențiali sunt dezactivate pe server — chiar și adresa de e-mail a unui jucător care își dă consimțământul este eliminată. Folosește modul demo pentru orice adresă URL publică în care nu derulezi o campanie reală.

Licențiere muzicală

Jocul este livrat cu o listă de redare muzicală licențiată pentru doar pentru utilizare în chioșcuri necomercialeDacă intenționați să redați în spații publice, în stil radio comercial, înlocuiți piesele din music/ folder cu licențe pe care le controlezi.