bubble-pop – геймификация на брандирани събития и привличане на потенциални клиенти

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

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

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

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

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

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

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

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

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

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

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

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

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

Други езици

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

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

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

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

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

Какво има в пощенския код:

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

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. Уверете се, че data/ поддиректорията е с право на запис (с права 0775 или по-висока) — играта записва настройки, най-високи резултати и (по избор) резултати там.
4. Посетете URL адреса си в браузър, напр. https://yourdomain.com/games/shapematch/Екранът в режим на готовност би трябвало да се зареди в рамките на няколко секунди.
5. Задайте хеш на вашия собствен ПИН код на оператора 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/ (mac OS).
4. Прегледайте http://localhost/shapematch/index.phpПромените в PHP / JS са видими при обновяване.

Ако високите резултати или настройките не успеят да се запазят в Windows, щракнете с десния бутон върху data/ папка → Свойства → Защита и даване на пълен контрол на потребителите.

Работи на киоск с тъчскрийн

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

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

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

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

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

Механика на геймплея

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

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

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

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

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

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

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

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

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

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

Пакети с форма

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

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

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

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

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

Съответствие с 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 адрес, където не провеждате реална кампания.

Музикално лицензиране

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