Твоя гра
Гра показує білий екран: як це виправити
Натисни «Показати, що сталося» в попередньому перегляді студії. Ти побачиш файли, які гра запитувала й не отримала, а також помилки, які вона видала. Найчастіше винні великі літери в назвах файлів, абсолютні шляхи або скрипти з чужого сервера.
Перш ніж почати
- Гру завантажено в студію за адресою dev.klyo.pl; вистачить і пакета, який ще чекає на опис.
- Оригінальні файли на твоєму комп’ютері, щоб виправити їх і завантажити знову.
Крок за кроком
Відкрий діагностику
У попередньому перегляді натисни Показати, що сталося. Ти побачиш відсутні файли й помилки браузера в тому порядку, в якому вони виникли. Такий самий список отримує твій ШІ-асистент з інструменту діагностики.
Перевір назви файлів літера за літерою
Наш сервер розрізняє великі й малі літери: Player.png і player.png для нього два різні файли. Гра, яка працює на Windows або macOS, тут може не знайти файлів, тож назви в коді мають точно збігатися з назвами файлів.
Використовуй відносні шляхи
Завантажуй файли як assets/hero.png, а не /assets/hero.png, C:\ чи file:///. Файл index.html тримай у корені ZIP-архіву, а не в підпапці.
Тримай усі файли в пакеті
Гра на klyo завантажує власні файли. Бібліотека, шрифт або скрипт із чужого сервера можуть не завантажитися, а код, що надсилає дані за межі klyo, не пройде перевірку. Додай такий файл у ZIP.
Ігри з рушіїв експортуй у ZIP
GameMaker, Unity і Godot створюють частину назв файлів уже під час гри, тож якщо перенести таку гру з адреси, вона може їх не знайти. Експортуй гру в ZIP у своєму рушії та завантаж усю папку.
Протестуй, перш ніж завантажувати знову
На своєму комп’ютері запусти
node klyo-test.mjs http://localhost:8080/ my-game ./klyo-test. Він перевіряє гру так само, як ми під час випуску, з тими самими порогами, і показує, що побачить гравець.
Якщо щось не працює
Екран довго лишається порожнім
Перший кадр має з’явитися протягом 20 секунд, а перше завантаження на телефоні не має перевищувати 20 МБ. Великі файли завантажуй пізніше, коли меню вже на екрані.
Немає звуку
Браузери вмикають звук лише після першого дотику або кліку. Відновлюй звук у відповідь на дію гравця, зокрема коли гра повертається з фону на iPhone.
Нічого зі списку цього не пояснює
Натисни Поговори з нами у студії та надішли адресу гри зі знімком екрана. Це прочитає жива людина.
Часті запитання
Чому гра працює в мене, а на klyo ні?
Зазвичай через великі літери в назвах файлів, абсолютні шляхи або файли з чужого сервера. Локальний комп’ютер таке прощає, а сервер у мережі вже ні.
Чи знайде ШІ-асистент причину?
Так. Підключений через MCP-сервер klyo, він читає ту саму діагностику, відсутні файли й помилки браузера та може виправити файли в чернетці, яку ти потім сам перевіряєш і випускаєш.