Uparivanje oblika — Kiosk igra — Korisnički priručnik.

Shape Match je PHP/HTML5 igra osjetljiva na dodir koja se može preuzeti za sajmove, lobije i web stranice: igrač povlači svaki ciljni oblik u odgovarajući izrez prije nego što vrijeme istekne. Ovaj priručnik pokriva preuzimanje, instalaciju, postavljanje kioska, igranje, meni operatera, prikupljanje potencijalnih klijenata i GDPR.

Oprez: Ovo je softver koji sami hostujete — prije bilo kakve javne implementacije, promijenite zadani PIN operatera i provjerite da li je igra data/ Mapa se nikada ne može pregledavati putem interneta. Vi ste kontrolor podataka za sve podatke o igračima koje prikupljate.

odricanje

Made for Arcade ne daje nikakve izjave ili garancije u vezi s ovim priručnikom i, u najvećoj mjeri dozvoljenoj zakonom, izričito ograničava svoju odgovornost za bilo kakvo nepoštivanje bilo koje garancije koja proizlazi iz zamjene ovog priručnika drugim. Osim toga, Made for Arcade zadržava pravo izmjene ove publikacije u bilo kojem trenutku bez obaveze obavještavanja bilo koje osobe o reviziji.

Informacije u ovoj dokumentaciji sadrže opće opise i/ili tehničke karakteristike performansi mašine spomenute u ovoj dokumentaciji. Ova dokumentacija nije namijenjena kao zamjena za, niti bi se trebala koristiti za određivanje, prikladnosti ili pouzdanosti ove mašine za specifične korisničke primjene.

Dužnost je takvog korisnika ili sistem integratora da provede - u vezi s relevantnom specifičnom primjenom ili upotrebom proizvoda - adekvatnu i potpunu analizu rizika, evaluaciju i testiranje proizvoda.

Napomena: sve slike korištene u ovom priručniku su samo u ilustrativne svrhe i mogu se razlikovati od stvarnog proizvoda. To je zato što se boje, dimenzije i druga svojstva stvarnog proizvoda mogu razlikovati od slike.

Made for Arcade i/ili njegove filijale ili podružnice nisu odgovorne za bilo kakvu zloupotrebu informacija sadržanih u ovom dokumentu. Ako imate bilo kakve prijedloge za poboljšanja ili promjene ili ste pronašli bilo kakve greške u ovoj dokumentaciji, molimo vas da nas obavijestite.

Prilikom instaliranja i korištenja ove mašine moraju se poštovati svi relevantni nacionalni, regionalni i lokalni sigurnosni propisi. Iz sigurnosnih razloga i radi osiguranja usklađenosti s dokumentiranim podacima sistema, komponente smije popravljati samo proizvođač.

Ako se mašine koriste za primjene sa tehničkim sigurnosnim propisima, moraju se poštovati odgovarajuća uputstva. Nepoštivanje ovih informacija može dovesti do povreda osoba i/ili oštećenja mašine.

Ovaj uređaj je namijenjen samo za zabavu. ne namijenjeno za korištenje radi profita, za klađenje ili isplatu novca ili za kockanje ili igre na sreću. Made for Arcade Ne daje nikakvu izjavu niti garanciju da je upotreba, instalacija ili rad ovog uređaja dozvoljen ili zakonit u bilo kojoj određenoj regiji, zemlji, jurisdikciji ili mjestu. Isključiva je odgovornost kupca i/ili krajnjeg korisnika da osigura da je njihova upotreba uređaja u skladu sa svim važećim zakonima, propisima i zahtjevima za licenciranje ili dozvolu (uključujući sve propise o kockanju, igrama na sreću ili zabavi).

autorsko pravo

Copyright © Made for ArcadeSva prava pridržana. Nijedan dio ove dokumentacije ne smije se reproducirati, distribuirati ili prenositi u bilo kojem obliku ili na bilo koji način, uključujući fotokopiranje, snimanje ili druge elektronske ili mehaničke metode, bez prethodne pismene dozvole izdavača. Pošaljite zahtjev izdavaču za dozvolu.

Ostali jezici

Ovo je korisnički priručnik na engleskom jeziku (ili njegov automatski prijevod). Priručnici na drugim jezicima mogu biti dostupni na zahtjev.

Podrška i servis

Za više informacija, servis, tehničku podršku, naručivanje korisničkih priručnika ili za bilo koja druga pitanja, molimo kontaktirajte:
Made for Arcade
Besterdstraat 9a, 5051HH Goirle, Holandija
E-mail: [email zaštićen] · Web: madeforarcade.com

Opis igre

Shape Match je aktivacija za usklađivanje oblika visokog tempa koja se isporučuje kao samostalni PHP/HTML5 paket - bez baze podataka, bez vanjskih zavisnosti i bez analitičkih SDK-ova. Prebacite mapu na bilo koji web host koji podržava PHP i ona će poslužiti. Isti paket se pokreće preko cijelog ekrana na kiosku sa ekranom osjetljivim na dodir na događaju ili je ugrađen kao demo preglednika unutar vaše vlastite web stranice. Ovaj priručnik se također odnosi na ostale kiosk naslove Signature serije (Bubble-Pop, 4-in-a-Row i Sliders): dijele istu instalaciju, meni operatera, brendiranje i rukovanje podacima - razlikuje se samo način igranja.

Šta se nalazi u poštanskom broju:

stavka	svrha
index.php	Ulazna tačka — sastavlja korisnički interfejs i opslužuje JavaScript za igranje.
config.php	Paleta igara, tekstovi, zadane postavke i DEMO_MODE zastava.
save.php / load.php	Sitne krajnje tačke za postavke, najbolje rezultate i rezultate tombole.
UI_parts.php	Višekratno upotrebljiv HUD, tastatura na ekranu i pomoćni paneli.
screens/	Jedan PHP dio po ekranu (mirovanje, odbrojavanje, igranje, otkrivanje rezultata, sažetak, itd.).
CSS/design.css	Jedan stilski list sa prepoznatljivim izgledom.
assets/shape_packs/	Opcionalni paketi ikona koje mijenjate po kampanji.
sounds/, music/, images/, branding/	Zvuk igre i zadana grafika.

Namjeravanu upotrebu

Shape Match je namijenjen za promotivnu zabavu - na sajmovima, u lobijima, izložbenim salonima i na vašoj vlastitoj web stranici kampanje - pod vašom kontrolom kao operatera. To je softver koji hostirate i pokrećete; ne isporučuje se fizički računar. Ne postoji minimalna starosna granica, ali mala djeca bi se trebala igrati pod nadzorom.

Kako to dobiti

svaki Made for Arcade Naslov se distribuira kao ZIP datoteka za trenutno preuzimanje.

1. Kupite igru ​​na madeforarcade.com — plaćanje obavlja naš partner za naplatu.
2. Sačuvajte e-poruku s potvrdom — ona sadrži vašu vezu za preuzimanje i licencni ključ.
3. Kliknite na link za preuzimanje da biste preuzeli shapematch.zip (obično ispod 20 MB).
4. Raspakujte lokalno — vidjet ćete mapu sa index.php, config.php i podmape resursa.

Linkovi za preuzimanje vrijede 7 dana i mogu se koristiti do 5 puta. Trebate još jedan link? Odgovorite na e-poruku s potvrdom i mi ćemo vam ponovo izdati jedan.

Instalirajte na svom web hostingu

Igra radi na bilo kojem dijeljenom ili namjenskom web hostingu koji podržava PHP 8.0 ili novijiNije potrebna baza podataka.

1. Otvorite kontrolnu ploču vašeg hostinga (cPanel, Plesk, DirectAdmin, itd.) ili se povežite putem SFTP-a.
2. Otpremite raspakiranu mapu u vaš web root direktorij — obično public_html/ ili podmapu kao što je public_html/games/shapematch/.
3. Uverite se data/ Poddirektorij je pisljiv (dozvole 0775 ili više) — igra tamo zapisuje postavke, najbolje rezultate i (opciono) rezultate.
4. Posjetite svoj URL u pregledniku, npr. https://yourdomain.com/games/shapematch/Ekran u stanju mirovanja trebao bi se učitati u roku od nekoliko sekundi.
5. Postavite vlastiti PIN hash operatera u server_config.php prije nego što postanete javni (prvo promijenite zadanu postavku — pogledajte izbornik Operator).

Pokrenite igru ​​pod HTTPS: obrazac operatora se šalje putem POST-a i postavlja kolačić sesije, a isporučeni kod automatski postavlja sigurnosnu zastavicu kolačića kada PHP detektuje HTTPS.

Instalirajte lokalno pomoću XAMPP-a

Za lokalno testiranje koristite XAMPP na Windowsu, macOS-u ili Linuxu.

1. Preuzmite i instalirajte XAMPP sa apachefriends.org.
2. Pokrenite Apache iz XAMPP kontrolne ploče.
3. Raspakujte igru ​​u C:xampphtdocsshapematch (Windows) ili /Applications/XAMPP/htdocs/shapematch/ (mac OS).
4. Browse to http://localhost/shapematch/index.phpPromjene u PHP/JS kodu su vidljive prilikom osvježavanja.

Ako se najbolji rezultati ili postavke ne uspiju spremiti u sustavu Windows, kliknite desnim gumbom miša na data/ mapa → Svojstva → Sigurnost i dajte korisnicima potpunu kontrolu.

Pokreni na kiosku sa ekranom osjetljivim na dodir

Igra je dizajnirana za portret 1080 × 1920 ekran osjetljiv na dodir, obično komercijalni ekran od 43″–55″ u režimu kioska.

• Koristite preglednik s dugoročnom podrškom (Chrome, Edge ili Firefox) s onemogućenim automatskim ažuriranjem.
• Pokrenite preglednik u režimu cijelog ekrana, npr. chrome.exe --kiosk --app=http://localhost/shapematch/.
• Okrenite ekran u portretni položaj u postavkama ekrana operativnog sistema.
• Onemogućite čuvar ekrana, stanje mirovanja i sistemska obavještenja.
• Ostavite zumiranje pinch-to-zoom onemogućeno (već je obrađeno u našem CSS-u, ali provjerite da li OS to prepisuje).
• Da biste automatski pokrenuli sistem prilikom pokretanja, prikačite URL kioska na prečicu za pokretanje pomoću --kiosk zastavica — igra se sama nastavlja na ekranu u stanju mirovanja.

Ugradite u vlastitu web stranicu

Možete ugraditi igru ​​unutar vlastite korporativne ili kampanjske stranice kao demo verziju u pregledniku tako što ćete na stranicu umetnuti iframe preko cijelog prikaza.

• Za javnu demonstraciju, postavite $DEMO_MODE = true in config.php: meni operatera je potpuno blokiran, postavke se vraćaju na prethodno stanje pri svakom ponovnom učitavanju stranice, a zapisi o najboljim rezultatima / potencijalnim klijentima su onemogućeni.
• Da biste otvorili meni operatera preko aktivne URL adrese, dodajte ?operator=1 — u normalnom režimu ovo otvara upit za PIN; u demo režimu meni ostaje zaključan.
• Omjer širine i visine okvira zadržite na 1080/1920 ili će se raspored rastegnuti.

Mehanika igranja

Shape Match je igra uparivanja s vremenski ograničenim vremenom. Svaka runda prikazuje ciljni oblik i mrežu kandidata za izreze; igrač uvlači metu u odgovarajući izrez prije nego što vrijeme na satu za oblik istekne.

1. Ekran u mirovanju — rotirajući info špil privlači igrača.
2. Pritisnite za početak → odbrojavanje od 5 sekundi.
3. nivo 1 otvara jednostavnu mrežu 3 × 3; igrači povlače metu u odgovarajuću ćeliju.
4. Svaki nivo dodaje rotirajuće ćelije, prekrivene ćelije ili veće mreže, a sat oblika postaje precizniji.
5. Igra je gotova → otkrivanje rezultata → unos najboljeg rezultata (ime + opcionalna e-mail adresa) → Kuća slavnih.
6. Nakon 15 sekundi kiosk se automatski vraća u stanje mirovanja.

Bodovanje: tačna podudaranja donose bodove na osnovu nivoa × preostalog sata oblika; pogrešna podudaranja blokiraju ćeliju i koštaju bodove. Kada je aktivna slika brendirane mete, konfigurabilni procenat rundi koristi vaš logo ili maskotu kao metu umjesto ugrađenog geometrijskog oblika.

Opcije i funkcije igre

Svaka podesiva postavka se može uređivati ​​uživo iz menija operatera. Zadane vrijednosti ispod su iz config.php.

postavljanje	domet	Uobičajeno
zapremina	0 - 100	70
Vrijeme po obliku	4 - 20 s	8 s
Oblici za čišćenje nivoa 1	1 - 20	3
Maks. broj okretaja u minuti	1 - 25	12
Rotirajuće ćelije	0 - 30	5
Ton pozadine oblika	0 - 100	8
Šansa za ciljanu grupu brenda	0 - 100%	35
Demo režim	on / off	isključen
Shema boja	zadano ili jednobojno preklapanje	default

U demo modu, promjene operatora primjenjuju se samo na sesiju pregledavanja — ponovno učitavanje stranice vraća osnovnu vrijednost spremljenu u shapematch_settings.json.

Meni operatera

Meni operatera je skrivena ploča s postavkama iza PIN-a.

• Otvorite ga dodirom nevidljive vruće tačke od 110 × 110 px u donjem desnom uglu ekrana u stanju mirovanja ili putem deeplink-a za index.php?operator=1.
• Unesite PIN operatera. Zadana isporuka je 2468 i javno je — zamijenite SHA-256 heš (operator_pin_sha256) in server_config.php prije bilo kakvog javnog postavljanja ili su vam postavke širom otvorene.

Iz menija možete prilagoditi svaku od gore navedenih postavki, kao i opcije brendiranja:

opcija	Šta to radi
Brendiranje medija	Slika ili kratki video prikazani u neaktivnom dijelu ekrana.
Ciljna slika brenda	PNG koji se koristi kao oblik ciljanog brenda.
Naziv brenda	Zamjenjuje naslovnu pločicu i naljepnicu u podnožju u slučaju neaktivnosti.
Shema boja	Zadano ili odaberite bilo koju boju za promjenu boje cijelog korisničkog interfejsa.

Paketi oblika

Paketi oblika su ZIP datoteke prozirnih PNG / WebP ikona (do 30 po paketu, ukupno 10 paketa). Otpremanje iz menija operatera — svaki paket se automatski normalizira na 512 × 512 i pohranjuje u assets/shape_packs/. Prebacite aktivni paket iz padajućeg menija; igra se vraća na svoje ugrađene geometrijske oblike kada nijedan paket (ili manje od 2 omogućena oblika) nije aktivan. U demo modu, otpremanje paketa oblika je onemogućeno jer bi se zapisivalo na disk.

Preuzmite listu podataka

Svi podaci koje igrači dostave pohranjuju se kao obične datoteke unutar same igre. data/ mapa — nema baze podataka, nema izvoza u oblak.

podaci	lokacija
Visoke ocjene	data/high_scores/shapematch_highscores.json — ime, rezultat, nivo i usklađeni oblici.
Tombola / potencijalni klijenti	data/user_data_csv/shapematch_raffle_leads.csv — jedan red po uvodu; otvara se u Excelu, Numbers ili Google Sheets.

Za preuzimanje datoteka: SFTP / SSH pristup hostu i preuzimanje sa /data/high_scores/ i /data/user_data_csv/ili koristite Upravitelj datoteka na kontrolnoj ploči vašeg hostinga. Rotirajte datoteku potencijalnih klijenata nakon svake aktivacije i premjestite je u svoj CRM ili alat za slanje pošte.

Nikada ne izlagati data/ preko HTTP-a. Dodajte .htaccess sa Deny from all unutar data/ folder ili ga premjestite izvan korijenskog direktorija weba, tako da potencijalni klijenti i najbolji rezultati ne budu javno dostupni za pregled.

Usaglašenost GDPR-a

Made for Arcade isporučuje softver; Vi ste kontrolor podataka za sve informacije koje igrač dostavi. Svi podaci ostaju na vašem hostu — ništa se ne prenosi Made for Arcade.

Šta igra može prikupljati: ime igrača (maksimalno 18 znakova); e-mail adresa (opciono - samo ako se igrač prijavi za nagrade na tomboli); opciono polje za izbor u slobodnom obliku; i rekordni rezultat. Ne prikuplja IP adresu, otisak prsta uređaja, analitičke kolačiće ili podatke za praćenje treće strane.

Vaše odgovornosti kao operatera / kontrolora podataka:

1. Na svom štandu ili stranici istaknite kratku obavijest o saglasnosti u kojoj objašnjavate zašto prikupljate ime i e-mail.
2. Ponudite jasnu opciju za prijavu (potvrdni okvir za GDPR u igri) — nikada ga ne označavajte unaprijed.
3. Pridržavajte se rasporeda zadržavanja potencijalnih klijenata (mnoge kampanje brišu potencijalne klijente 90 dana nakon završetka lutrije).
4. Odgovorite na zahtjeve za pristup i brisanje — vi ste vlasnik CSV datoteke, tako da se izmjene vrše ručno.
5. Objavite URL adresu s pravilima o privatnosti gdje god ugrađujete igru.
6. U EU / Velikoj Britaniji možete navesti Made for Arcade kao procesor samo za softver — nikada ne vidimo kontakte.

Kada $DEMO_MODE = true, zapisivanje podataka za prikupljanje potencijalnih klijenata je onemogućeno na strani servera — čak se i e-mail adresa igrača koji je dao pristanak odbacuje. Koristite demo način rada za bilo koji javni URL gdje ne vodite stvarnu kampanju.

Muzičko licenciranje

Igra dolazi s uparenom muzičkom playlistom licenciranom za samo za nekomercijalnu upotrebu na kioskuAko planirate reprodukciju u stilu komercijalnog radija u javnim prostorima, zamijenite pjesme u music/ mapa s licencama koje kontrolirate.