Formmatchning — Kioskspel — Användarmanual

Denna manual gäller för:

Shape Match är ett nedladdningsbart PHP/HTML5-pekskärmsspel för mässor, lobbyer och webbplatser: en spelare drar varje målform till dess matchande utklipp innan tiden går ut. Den här manualen täcker nedladdning, installation, kioskkonfiguration, spelupplägg, operatörsmenyn, leadgenerering och GDPR.

Försiktighet: detta är programvara som du själv hostar — innan någon offentlig distribution, ändra standardoperatörens PIN-kod och se till att spelets data/ mappen kan aldrig bläddras via webben. Du är personuppgiftsansvarig för all spelardata du samlar in.

Ansvarsfriskrivning

Made for Arcade lämnar inga utfästelser eller garantier avseende denna manual och begränsar, i den utsträckning lagen tillåter, uttryckligen sitt ansvar för eventuella underlåtenheter att uppfylla någon garanti till följd av att denna manual ersätts med en annan. Dessutom, Made for Arcade förbehåller sig rätten att revidera denna publikation när som helst utan skyldighet att meddela någon person om revideringen.

Informationen i denna dokumentation innehåller allmänna beskrivningar och/eller tekniska egenskaper för maskinens prestanda som nämns i denna dokumentation. Denna dokumentation är inte avsedd att ersätta, och bör inte användas för att avgöra, maskinens lämplighet eller tillförlitlighet för specifika användartillämpningar.

Det är en sådan användares eller systemintegratörs skyldighet att – i förhållande till produktens relevanta specifika tillämpning eller användning – utföra en adekvat och fullständig riskanalys, utvärdering och testning av produkterna.

Observera: alla bilder som används i denna manual är endast i illustrativt syfte och kan skilja sig från den faktiska produkten. Detta beror på att färger, mått och andra egenskaper hos den faktiska produkten kan skilja sig från bilden.

Made for Arcade och/eller dess dotterbolag eller närstående bolag ansvarar inte för eventuellt missbruk av informationen i detta dokument. Om du har några förslag på förbättringar eller ändringar, eller har hittat några fel i denna dokumentation, vänligen meddela oss.

Alla relevanta nationella, regionala och lokala säkerhetsföreskrifter måste följas vid installation och användning av denna maskin. Av säkerhetsskäl och för att säkerställa att dokumenterade systemdata överensstämmer får komponenterna endast repareras av tillverkaren.

Om maskiner används för tillämpningar med tekniska säkerhetsföreskrifter måste relevanta instruktioner följas. Underlåtenhet att följa dessa instruktioner kan leda till personskador och/eller skador på maskinen.

Denna maskin är endast avsedd för underhållningsändamål. Den är inte avsedd för vinstsyfte, för vadslagning eller utbetalning av pengar, eller för hasardspel eller hasardspel. Made for Arcade lämnar inga utfästelser eller garantier för att användning, installation eller drift av denna maskin är tillåten eller laglig i någon specifik region, land, jurisdiktion eller plats. Det är köparens och/eller slutanvändarens eget ansvar att säkerställa att deras användning av maskinen uppfyller alla tillämpliga lagar, förordningar och licens- eller tillståndskrav (inklusive eventuella regler för spel, spel eller nöjen).

Copyright

Copyright © Made for ArcadeAlla rättigheter förbehållna. Ingen del av denna dokumentation får reproduceras, distribueras eller överföras i någon form eller på något sätt, inklusive fotokopiering, inspelning eller andra elektroniska eller mekaniska metoder, utan föregående skriftligt tillstånd från utgivaren. Skicka en begäran till utgivaren om tillstånd.

Andra språk

Detta är den engelska användarmanualen (eller en automatisk översättning därav). Manualer på andra språk kan finnas tillgängliga på begäran.

Support och service

För mer information, service, teknisk support, beställning av användarmanualer eller andra frågor, vänligen kontakta:
Made for Arcade
Besterdstraat 9a, 5051HH Goirle, Nederländerna
E-post: [e-postskyddad] · Webb: madeforarcade.com

Spelbeskrivning

Shape Match är en snabb formmatchningsaktivering som levereras som ett fristående PHP/HTML5-paket – ingen databas, inga externa beroenden och inga analys-SDK:er. Du släpper mappen på valfri PHP-kompatibel webbhotell så fungerar den. Samma paket körs i helskärmsläge på en pekskärmskiosk vid ett evenemang, eller inbäddat som en webbläsardemo på din egen webbplats. Denna manual gäller även för de andra kiosktitlarna i Signature-serien (Bubble-Pop, 4-in-a-Row och Sliders): de delar samma installation, operatörsmeny, varumärke och datahantering – bara spelupplägget skiljer sig.

Vad finns i postnumret:

Artikel	Syfte
`index.php`	Ingångspunkt — monterar användargränssnittet och hanterar spelets JavaScript.
`config.php`	Spelpalett, texter, standardinställningar och `DEMO_MODE` flagga.
`save.php` / `load.php`	Små slutpunkter för inställningar, rekordpoäng och lotteriledningar.
`UI_parts.php`	Återanvändbar HUD, skärmtangentbord och panelhjälpmedel.
`screens/`	En PHP-delversion per skärm (inaktiv, nedräkning, spel, resultatvisning, sammanfattning, etc.).
`CSS/design.css`	Enskilt stilmall med det signaturutseendet.
`assets/shape_packs/`	Valfria ikonpaket som du byter per kampanj.
`sounds/, music/, images/, branding/`	Spelljud och standardbildmaterial.

Avsedd användning

Shape Match är avsett som reklamunderhållning – på mässor, i lobbyer, utställningslokaler och på din egen kampanjwebbplats – under din kontroll som operatör. Det är programvara som du är värd för och driver; ingen fysisk maskin tillhandahålls. Det finns ingen minimiålder, men små barn bör leka under uppsikt.

Hur får det

Var Made for Arcade Titeln distribueras som en ZIP-fil som kan laddas ner direkt.

Köp spelet på madeforarcade.com — Betalning hanteras av vår utcheckningspartner.
Spara bekräftelsemejlet – det innehåller din nedladdningslänk och licensnyckel.
Klicka på nedladdningslänken för att hämta shapematch.zip (vanligtvis under 20 MB).
Packa upp lokalt — du kommer att se en mapp med index.php, config.php och undermapparna för tillgångarna.

Nedladdningslänkarna är giltiga i 7 dagar och kan användas upp till 5 gånger. Behöver du en annan länk? Svara på bekräftelsemejlet så skickar vi en ny länk.

Installera på ditt webbhotell

Spelet körs på alla delade eller dedikerade webbhotell som stöder PHP 8.0 eller senareIngen databas krävs.

Öppna din kontrollpanel för webbhotell (cPanel, Plesk, DirectAdmin, etc.) eller anslut via SFTP.
Ladda upp den uppackade mappen till din webbrot – vanligtvis public_html/ eller en undermapp som t.ex. public_html/games/shapematch/.
Se till data/ Underkatalogen är skrivbar (behörighet 0775 eller högre) — spelet skriver inställningar, rekord och (valfritt) ledningar dit.
Besök din URL i en webbläsare, t.ex. https://yourdomain.com/games/shapematch/Viloskärmen bör laddas inom ett par sekunder.
Ställ in din egen hash för operatörens PIN-kod server_config.php innan den publiceras (ändra standardinställningen först — se Operatörsmenyn).

Kör spelet under HTTPSOperatorformuläret skickas via POST och sätter en sessionscookie, och den levererade koden sätter cookiens säkra flagga automatiskt när PHP upptäcker HTTPS.

Installera lokalt med XAMPP

För lokal testning, använd XAMPP på Windows, macOS eller Linux.

Ladda ner och installera XAMPP från apachefriends.org.
Starta Apache från XAMPP-kontrollpanelen.
Packa upp spelet i C:xampphtdocsshapematch (Windows) eller /Applications/XAMPP/htdocs/shapematch/ (Mac OS).
Bläddra till http://localhost/shapematch/index.phpÄndringar i PHP/JS syns vid uppdatering.

Om höga poäng eller inställningar inte sparas i Windows, högerklicka på data/ mapp → Egenskaper → Säkerhet och ge användarna full kontroll.

Kör på en pekskärmskiosk

Spelet är designat för porträtt 1080 × 1920 pekskärm, vanligtvis en kommersiell skärm på 43–55 tum i kioskläge.

Använd en webbläsare som har haft långsiktigt stöd (Chrome, Edge eller Firefox) och som har inaktiverat automatiska uppdateringar.
Starta webbläsaren i helskärmsläge, t.ex. chrome.exe --kiosk --app=http://localhost/shapematch/.
Rotera skärmen till stående läge i operativsystemets bildskärmsinställningar.
Inaktivera skärmsläckare, viloläge och systemmeddelanden.
Låt nyp-för-att-zooma-funktionen vara inaktiverad (hanteras redan i vår CSS, men kontrollera att operativsystemet inte åsidosätter den).
För att starta automatiskt vid uppstart, fäst kioskens URL till en startgenväg med --kiosk flagga — spelet återupptas till vilolägesskärmen av sig självt.

Bädda in på din egen webbplats

Du kan bädda in spelet på din egen företags- eller kampanjwebbplats som en webbläsarbaserad demo genom att släppa en full viewport iframe på en sida.

För en offentlig demonstration, ställ in $DEMO_MODE = true in config.phpOperatörsmenyn är helt blockerad, inställningarna återställs varje gång sidan laddas om och skrivningar av höga poäng/leads är inaktiverade.
För att öppna operatörsmenyn via en aktiv URL, lägg till ?operator=1 — i normalt läge öppnar detta PIN-frågan; i demoläge förblir menyn låst.
Behåll bildens bildförhållande på 1080/1920, annars sträcks layouten ut.

Spelmekanik

Shape Match är ett matchningsspel med tidsinställning. Varje runda visar en målform och ett rutnät med utklippta figurer; spelaren drar målet in i den matchande utklippta figuren innan formklockan löper ut.

Viloskärm — en roterande informationslek attraherar spelaren.
Tryck för att starta → en 5-sekunders nedräkning.
Nivå 1 öppnar ett enkelt 3 × 3-rutnät; spelarna drar målet till matchande ruta.
Varje nivå lägger till roterande celler, beslöjade celler eller större rutnät, och formklockan blir tajtare.
Spel över → poängavslöjande → högpoängsanmälan (namn + valfri e-postadress) → Hall of Fame.
Efter 15 sekunder återgår kiosken automatiskt till viloläge.

Poängsättning: korrekta matchningar ger poäng baserat på nivå × återstående formklocka; felaktiga matchningar blockerar cellen och kostar poäng. När en varumärkesmärkt målbild är aktiv använder en konfigurerbar andel av rundorna din logotyp eller maskot som mål istället för en inbyggd geometrisk form.

Spelalternativ och funktioner

Varje justerbar inställning kan redigeras live från operatörsmenyn. Standardvärdena nedan kommer från config.php.

Att lägga plattor	Mätområde	Standard
Volym	0 - 100	70
Tid per form	4 - 20 s	8 s
Former att klara nivå 1	1 - 20	3
Max rotationsvarvtal	1 - 25	12
Roterande celler	0 - 30	5
Bakgrundston för form	0 - 100	8
Chans att varumärkesmål	0 - 100%	35
Demo	på / av	sänkt
Färgschema	standard- eller enfärgsöverskridning	standard

I demoläge gäller operatorändringar endast för webbläsarsessionen — om sidan laddas om återställs baslinjen som sparades i shapematch_settings.json.

Operatörsmenyn är en dold inställningspanel bakom en PIN-kod.

Öppna den genom att trycka på den osynliga 110 × 110 px-hotspoten i det nedre högra hörnet av vilolägesskärmen, eller djuplänka till index.php?operator=1.
Ange operatörens PIN-kod. Standardvärdet för leverans är 2468 och är offentlig — ersätt SHA-256-hashen (operator_pin_sha256) i server_config.php före någon offentlig distribution, eller så är dina inställningar vidöppna.

Från menyn kan du justera alla inställningar ovan, plus varumärkesalternativen:

Alternativet	Vad den gör
Varumärkesmedia	Bild eller kort video som visas i vilolägesspelaren.
Varumärkesbild för målgrupp	PNG-filen som används som varumärkesmålform.
Varumärkestitel	Ersätter titelplaketten och sidfotsetiketten för inaktiva uppgifter.
Färgschema	Standard, eller välj valfri färg för att ändra färg på hela användargränssnittet.

Formpaket

Formpaket är ZIP-filer med transparenta PNG-/WebP-ikoner (upp till 30 per paket, totalt 10 paket). Ladda upp från operatörsmenyn — varje paket normaliseras automatiskt till 512 × 512 och lagras i assets/shape_packs/Växla aktivt paket från rullgardinsmenyn; spelet återgår till sina inbyggda geometriska former när inget paket (eller färre än 2 aktiverade former) är aktiva. I demoläge är uppladdning av formpaket inaktiverad eftersom det skulle skriva till disk.

Hämta datalistan

All data som spelaren tillhandahåller lagras som vanliga filer i spelets data/ mapp — ingen databas, ingen molnexport.

Data	Plats
Höga poäng	`data/high_scores/shapematch_highscores.json` — namn, poäng, nivå och former matchade.
Lotteri / utlottningar	`data/user_data_csv/shapematch_raffle_leads.csv` — en rad per lead; öppnas i Excel, Numbers eller Google Sheets.

För att hämta filerna: SFTP / SSH till värden och ladda ner från /data/high_scores/ och /data/user_data_csv/eller använd filhanteraren på din webbhotells kontrollpanel. Rotera leadsfilen efter varje aktivering och flytta den till ditt CRM- eller utskicksprogram.

Utsätt aldrig data/ över HTTP. Lägg till .htaccess med Deny from all inuti data/ mappen, eller flytta den utanför din webbrot, så att leads och höga poäng inte är offentligt tillgängliga.

Made for Arcade levererar programvaran; du är den personuppgiftsansvariga för all information som spelaren tillhandahåller. All data lagras på din egen värd — ingenting överförs till Made for Arcade.

Vad spelet kan samla in: ett spelares visningsnamn (max 18 tecken); en e-postadress (valfritt – endast om spelaren väljer att delta i lotterivinster); ett valfritt fritt formulerat fält; och rekordet för höga poäng. Det samlar inte in någon IP-adress, enhetens fingeravtryck, analyscookie eller spårningsinformation från tredje part.

Dina ansvarsområden som operatör/personuppgiftsansvarig:

Visa ett kort samtyckesmeddelande i din monter eller sida som förklarar varför du samlar in namn och e-postadress.
Erbjud ett tydligt alternativ för att delta (kryssrutan för GDPR i spelet) – förmarkera det aldrig.
Håll ett schema för lagring av leads (många kampanjer tar bort leads 90 dagar efter att lotteriet avslutats).
Svara på åtkomst- och raderingsförfrågningar – du äger CSV-filen, så redigeringar görs manuellt.
Publicera en URL för sekretesspolicyn var du än bäddar in spelet.
I EU/Storbritannien kan du lista Made for Arcade som en processor endast för programvaran — vi ser aldrig ledtrådarna.

När $DEMO_MODE = true, lead-capture-skrivningar är inaktiverade på serversidan – även en samtyckande spelares e-postadress ignoreras. Använd demoläge för alla offentliga URL:er där du inte kör en riktig kampanj.

Musiklicens

Spelet levereras med en paketerad musikspellista licensierad för endast för icke-kommersiell kioskanvändningOm du planerar att spela upp kommersiell radio i offentliga utrymmen, byt ut spåren i music/ mapp med licenser som du kontrollerar.

Formmatchning — Kioskspel — Användarmanual.