Shape Match — Игра за киоск — Ръководство за ползване.

Shape Match е игра за изтегляне на PHP / HTML5 със сензорен екран за изложения, фоайета и уебсайтове: играчът плъзга всяка целева форма в съответния ѝ изрез, преди времето да изтече. Това ръководство обхваща изтеглянето, инсталирането, настройката на киоска, геймплея, операторското меню, събирането на потенциални клиенти и GDPR.

Внимание: това е софтуер, който хоствате сами — преди всяко публично публикуване, променете стандартния операторски ПИН код и се уверете, че играта данни/ папката никога не може да бъде разглеждана през уеб. Вие сте администраторът на лични данни за всички данни на играчи, които събирате.

Отказ от отговорност

Made for Arcade не дава никакви гаранции по отношение на настоящото ръководство и, до максималната степен, позволена от закона, изрично ограничава своята отговорност за всяко несъответствие с каквато и да е гаранция, произтичащо от замяната на настоящото ръководство с друго. Освен това Made for Arcade си запазва правото да преработи настоящата публикация по всяко време, без да е длъжна да уведомява когото и да било за преработката.

Информацията в настоящата документация съдържа общи описания и/или технически характеристики относно експлоатационните показатели на машината, посочена в нея. Настоящата документация не е предназначена да замести и не трябва да се използва за определяне на пригодността или надеждността на тази машина за конкретни приложения на потребителя.

Задължение на такъв потребител или системен интегратор е да извърши — във връзка със съответното конкретно приложение или употреба на продукта — адекватен и изчерпателен анализ на риска, оценка и изпитване на продуктите.

Моля, имайте предвид: всички изображения, използвани в това ръководство, са само с илюстративна цел и може да се различават от действителния продукт. Причината за това е, че цветовете, размерите и другите характеристики на действителния продукт може да се различават от тези на изображението.

„Made for Arcade“ и/или нейните свързани дружества или дъщерни дружества не носят отговорност за евентуално неправилно използване на информацията, съдържаща се в настоящия документ. Ако имате предложения за подобрения или промени, или сте открили грешки в тази документация, моля, уведомете ни.

При монтажа и експлоатацията на тази машина трябва да се спазват всички приложими национални, регионални и местни правила за безопасност. По съображения за безопасност и за да се гарантира съответствието с документираните системни данни, ремонтът на компонентите може да се извършва единствено от производителя.

Ако машините се използват за приложения, за които важат технически правила за безопасност, трябва да се спазват съответните инструкции. Неспазването на тази информация може да доведе до телесни наранявания и/или повреда на машината.

Тази машина е предназначена единствено за развлекателни цели. Тя е не предназначена за използване с цел печалба, за залагане или изплащане на пари, както и за хазарт или игри на късмета. Made for Arcade не дава никакви гаранции, че използването, инсталирането или експлоатацията на тази машина са разрешени или законни в който и да е конкретен регион, държава, юрисдикция или място. Изцяло е отговорност на купувача и/или крайния потребител да се уверят, че използването на машината от тяхна страна е в съответствие с всички приложими закони, наредби и изисквания за лицензиране или разрешителни (включително всякакви наредби, свързани с хазарта, игрите или развлеченията).

Авторски права

Авторски права © Made for Arcade. Всички права запазени. Никоя част от тази документация не може да бъде възпроизвеждана, разпространявана или предавана под каквато и да е форма или по какъвто и да е начин, включително чрез фотокопиране, записване или други електронни или механични методи, без предварително писмено разрешение от издателя. Моля, изпратете заявка до издателя за получаване на разрешение.

Други езици

Това е ръководството за употреба на английски език (или негов автоматичен превод). Ръководства на други езици могат да бъдат предоставени при поискване.

Поддръжка и обслужване

За допълнителна информация, обслужване, техническа поддръжка, поръчка на ръководства за употреба или при други въпроси, моля, свържете се с:
Made for Arcade
Besterdstraat 9a, 5051HH Гоирле, Нидерландия
Имейл: [email protected] · Уебсайт: madeforarcade.com

Описание на играта

Shape Match е динамична игра за съвпадение на форми, предоставена като самостоятелен PHP / HTML5 пакет – без база данни, без външни зависимости и без аналитични SDK. Вие поставяте папката на всеки уеб хостинг с поддръжка на PHP и тя започва да работи. Същият пакет работи на цял екран на сензорен киоск на събитие или вграден като браузър демо във вашия собствен уебсайт. Това ръководство се отнася и за другите заглавия за киоскове от серията Signature (Bubble-Pop, 4-in-a-Row и Sliders): те споделят една и съща инсталация, операторско меню, брандиране и обработка на данни – различен е само геймплеят.

Какво има в ZIP файла:

Артикул	Цел
index.php	Точка на влизане — сглобява потребителския интерфейс и предоставя JavaScript кода за играта.
config.php	Игрова палитра, текстове, стандартни настройки и ДЕМО_РЕЖИМ знаме.
save.php / load.php	Малки крайни точки за настройки, резултати и потенциални клиенти от томболи.
UI_parts.php	Многократно използваеми HUD, екранна клавиатура и помощни панели.
екранни/	По един PHP файл (partial) за всеки екран (в режим на готовност, обратно броене, игра, показване на резултат, обобщение и т.н.).
CSS/design.css	Единен стилов файл с разпознаваемия външен вид.
assets/shape_packs/	Допълнителни набори от икони, които можете да сменяте за всяка кампания.
звуци/, музика/, изображения/, брандинг/	Аудио и графики по подразбиране в играта.

Предназначение

„Shape Match“ е предназначена като развлекателна промоционална игра — на търговски изложения, във фоайета, в шоуруми и на вашия собствен уебсайт за кампанията — под вашия контрол като оператор. Това е софтуер, който вие хоствате и управлявате; не се предоставя физическо устройство. Няма минимална възраст, но малките деца трябва да играят под надзор.

Как да го получа

Всяка игра от серията „Made for Arcade“ се разпространява под формата на ZIP файл за незабавно изтегляне.

1. Купете играта от madeforarcade.com — плащането се обработва от нашия партньор за плащания.
2. Запазете потвърдителния имейл — в него се съдържат линкът за изтегляне и лицензионният ключ.
3. Кликнете върху линка за изтегляне, за да го изтеглите shapematch.zip (обикновено под 20 MB).
4. Разархивирайте файла на локалния си компютър — ще видите папка с index.php, config.php и подпапките с ресурсите.

Връзките за изтегляне са валидни 7 дни и могат да бъдат използвани до 5 пъти. Нужна ви е друга връзка? Отговорете на имейла за потвърждение и ще ви издадем нова.

Инсталирайте на вашия уеб хост

Играта работи на всеки споделен или специален уеб хостинг, който поддържа PHP 8.0 или по-нова версия. Не се изисква база данни.

1. Отворете контролния панел на хостинга си (cPanel, Plesk, DirectAdmin и др.) или се свържете чрез SFTP.
2. Качете разархивираната папка в уеб корена си — обикновено public_html/ или подпапка като например public_html/games/shapematch/.
3. Уверете се, че данни/ поддиректорията е записаема (права 0775 или по-високи) — играта записва там настройки, рекорди и (по избор) класации.
4. Отворете URL адреса си в браузър, например:. https://yourdomain.com/games/shapematch/. Екранът в режим на готовност трябва да се зареди за няколко секунди.
5. Задайте своя собствен хеш на PIN кода на оператора в server_config.php преди да се публикува (първо променете настройката по подразбиране — вижте менюто „Оператор“).

Стартирайте играта под HTTPS: формулярът на оператора се изпраща чрез POST и създава сесийна бисквитка, а изпратеният код автоматично задава флага за сигурност на бисквитката, когато PHP засече HTTPS.

Инсталиране локално с XAMPP

За локално тестване използвайте XAMPP на Windows, macOS или Linux.

1. Изтеглете и инсталирайте XAMPP от apachefriends.org.
2. Стартирайте Apache от контролния панел на XAMPP.
3. Разархивирайте играта в C:xampphtdocsshapematch (Windows) или /Applications/XAMPP/htdocs/shapematch/ (macOS).
4. Отидете на http://localhost/shapematch/index.php. Промените в PHP / JS се виждат при обновяване на страницата.

Ако високите резултати или настройките не се запазват в Windows, кликнете с десния бутон върху данни/ папка → Свойства → Сигурност и предоставете на „Потребители“ пълни права за достъп.

Работи на сензорен киоск

Играта е предназначена за изправен режим 1080 × 1920 сензорен екран, обикновено търговски дисплей с диагонал 43″–55″, работещ в режим „киоск“.

• Използвайте браузър с дългосрочна поддръжка (Chrome, Edge или Firefox), при който функцията за автоматично актуализиране е деактивирана.
• Стартирайте браузъра в режим на цял екран, например:. chrome.exe --kiosk --app=http://localhost/shapematch/.
• Завъртете екрана в портретен режим в настройките за дисплея на операционната система.
• Деактивирайте екранната заставка, режима на заспиване и системните известия.
• Оставете функцията „мащабиране с пръсти“ деактивирана (вече е оправено в нашия CSS, но проверете дали операционната система не я преопределя).
• За да се стартира автоматично при зареждане на системата, добавете URL адреса на киоска към прекия път за стартиране с помощта на --киоск flag — играта сама се връща към екрана в режим на изчакване.

Вградете във вашия собствеен уебсайт

Можете да вградите играта в собствения си корпоративен сайт или сайт на кампания като браузърна демо версия, като поставите iframe, заемащ целия прозорец на браузъра, на страницата.

• За публична демонстрация задайте $DEMO_MODE = true в config.php: менюто на оператора е напълно блокирано, настройките се възстановяват при всяко презареждане на страницата, а записването на рекорди и лидерски позиции е деактивирано.
• За да отворите менюто на оператора чрез активен URL адрес, добавете ?operator=1 — в нормален режим това отваря прозореца за въвеждане на ПИН-код; в демо режим менюто остава заключено.
• Запазете съотношението на страните на кадъра 1080/1920, в противен случай оформлението ще се изкриви.

Геймплейни механики

„Shape Match“ е игра за съпоставяне с ограничение във времето. Във всеки рунд се показва целева фигура и решетка с възможни фигури; играчът трябва да плъзне целевата фигура върху подходящата фигура, преди да изтече времето.

1. Екран в режим на готовност — въртяща се информационна платформа привлича вниманието на играча.
2. Натисни, за да стартираш → 5-секундно отброяване.
3. Ниво 1 отваря проста решетка 3 × 3; играчите плъзгат целта в съответната клетка.
4. С всяко ниво се добавят въртящи се клетки, скрити клетки или по-големи решетки, а времето за решаване става все по-ограничено.
5. Край на играта → разкриване на резултата → въвеждане на най-висок резултат (име + имейл по желание) → Зала на славата.
6. След 15 секунди киоскът автоматично преминава в режим на готовност.

Точкуване: при правилни съвпадения се начисляват точки в зависимост от нивото × оставащото време за фигурата; при грешни съвпадения клетката се блокира и се отнемат точки. Когато е активна целева картинка с брандиране, в определен процент от рундовете като цел се използва вашето лого или талисман вместо вградена геометрична фигура.

Опции и функции на играта

Всяка настройка може да се редактира в реално време от менюто на оператора. Показаните по-долу стойности по подразбиране са взети от config.php.

Настройка	Диапазон	По подразбиране
Обем	0 – 100	70
Време за всяка фигура	4 – 20 секунди	8 секунди
Фигури за преминаване на ниво 1	1 – 20	3
Максимални обороти в минута	1 – 25	12
Въртящи се клетки	0 – 30	5
Определяне на цвета на фона	0 – 100	8
Вероятност за достигане на целевата аудитория на марката	0 – 100 %	35
Демо режим	включено / изключено	изключено
Цветова гама	заместване по подразбиране или с един цвят	по подразбиране

В демо режим промените, направени от оператора, важат само за текущата сесия на сърфиране — при презареждане на страницата се възстановява базовото състояние, запазено в shapematch_settings.json.

Меню на оператора

Менюто на оператора е скрит панел с настройки, достъпен само с ПИН код.

• Отворете го, като докоснете невидимата активна зона с размери 110 × 110 пиксела в долния десен ъгъл на екрана в режим на готовност, или използвайте директна връзка към index.php?operator=1.
• Въведете ПИН-кода на оператора. Зададената по подразбиране стойност е 2468 и е публичен — заместете SHA-256 хеш (operator_pin_sha256) в server_config.php преди всяко публично пускане в експлоатация, в противен случай настройките ви ще бъдат напълно отворени.

От менюто можете да настроите всички горепосочени параметри, както и опциите за брандиране:

Опция	Какво прави
Медии за изграждане на марка	Изображение или кратко видео, показвано в панела в режим на готовност.
Изображение на целта с лого	PNG файлът, използван като форма на целевия елемент на марката.
Наименование на марката	Заменя табелката с заглавието на празен ход и етикета в долната част на страницата.
Цветова гама	По подразбиране или изберете произволен цвят, за да промените цвета на целия потребителски интерфейс.

Комплекти с форми

Пакетът с форми представлява ZIP-файл с прозрачни икони във формат PNG / WebP (до 30 на пакет, общо 10 пакета). Качете ги от менюто на оператора — всеки пакет се нормализира автоматично до размер 512 × 512 и се съхранява в assets/shape_packs/. Изберете активния пакет от падащото меню; когато няма активен пакет (или са активирани по-малко от 2 фигури), играта преминава към вградените геометрични фигури. В демо режим качването на пакети с фигури е деактивирано, тъй като това би изисквало записване на диск.

Извлечи списъка с данни

Всички данни, предоставени от играчите, се съхраняват като обикновени файлове в играта данни/ папка — без база данни, без експортиране в облака.

Данни	Местоположение
Рекорди	data/high_scores/shapematch_highscores.json — име, резултат, ниво и съвпадение на фигурите.
Томбола / потенциални клиенти	data/user_data_csv/shapematch_raffle_leads.csv — по един ред за всеки потенциален клиент; отваря се в Excel, Numbers или Google Sheets.

За да изтеглите файловете: свържете се чрез SFTP/SSH с хоста и изтеглете от /data/high_scores/ и /data/user_data_csv/, или използвайте файловия мениджър на контролния панел на хостинга си. Актуализирайте файла с потенциални клиенти след всяка активация и го преместете в CRM системата или инструмента си за изпращане на имейли.

Никога не излагайте данни/ чрез HTTP. Добавете .htaccess с Отказ за всички вътре в данни/ папка или я преместете извън кореновата директория на уебсайта, за да не могат потенциалните клиенти и най-високите резултати да се разглеждат публично.

Съответствие с GDPR

Made for Arcade доставя софтуера; Вие сте администраторът на личните данни за всякаква информация, предоставена от играчите. Всички данни остават на вашия собствен сървър — нищо не се предава на Made for Arcade.

Данните, които играта може да събира: име за показване на играча (максимум 18 символа); имейл адрес (по избор — само ако играчът се съгласи да участва в томбола за награди); поле за свободно въвеждане на текст (по избор); и рекордът за най-висок резултат. Играта не събира IP адрес, отпечатък на устройството, аналитични „бисквитки“ или проследяващи елементи на трети страни.

Вашите задължения като оператор / администратор на лични данни:

1. Поставете на щанда си или на страницата си кратко уведомление за съгласие, в което се обяснява защо събирате име и имейл адрес.
2. Предложете ясна възможност за даване на съгласие (отметката за GDPR в играта) — никога не я отбелязвайте предварително.
3. Съставете график за съхранение на данните (много кампании изтриват потенциалните клиенти 90 дни след приключването на томболата).
4. Отговаряйте на заявки за достъп и изтриване — CSV файлът е ваша собственост, така че промените се извършват ръчно.
5. Публикувайте URL адреса на политиката за поверителност навсякъде, където вграждате играта.
6. В ЕС/Обединеното кралство можете да посочите „Made for Arcade“ като обработващ лични данни единствено по отношение на софтуера — ние никога не получаваме достъп до потенциалните клиенти.

Когато $DEMO_MODE = true, записването на данни за потенциални клиенти е деактивирано от страна на сървъра — дори имейлът на играч, дал съгласие, се изтрива. Използвайте демо режима за всеки публичен URL адрес, където не провеждате реална кампания.

Лицензиране на музика

Играта се предлага с включен музикален плейлист, лицензиран за само за некомерсиална употреба в киоск. Ако планирате възпроизвеждане по подобие на комерсиалните радиостанции в обществени пространства, заместете песните в музика/ папка с лицензи, които управлявате.