lobsite! Войти Регистрация

Хостинг Unity WebGL

Разместите сборку Unity WebGL с HTTPS, тестовыми версиями и своим доменом. Проверьте настройки сжатия и загрузите готовую папку.

Создайте Web-сборку в build/web с включённым Decompression Fallback и выполните команду из папки проекта.
Перетащите HTML-файл, папку или .zip Проверяется в вашем браузере; ничего не загружается, пока вы не опубликуете.

Опубликуйте веб-сборку Unity по прямой ссылке HTTPS для игроков и тестировщиков. Загрузите полную папку сборки, включая ее загрузчик и данные, и продолжайте обновлять тот же адрес. Здесь имеют значение настройки сжатия Unity: подготовьте сборку для Lobsite перед ее загрузкой.

Как это работает

  1. Build for Web. Выберите веб-платформу Unity (в старых версиях она называлась WebGL). В Player Settings → Publishing Settings включите Decompression Fallback, если вы используете сжатие Gzip или Brotli. Встроить в build/web.
  2. Проверьте файлы и разверните. Большинство сборок Unity превышают ограничения на анонимные файлы и файлы Free, поэтому при необходимости войдите в систему с помощью Standard. Запустите npx lobsite ./build/web или загрузите полную сборку с панели управления.
  3. Поделитесь игрой и обновите ее. Отправьте игрокам опубликованный URL-адрес. Создайте заново и разверните на том же сайте для получения обновлений или используйте npx lobsite --preview для отдельного игрового теста.

Настройки сжатия, работающие на Lobsite

Lobsite обслуживает файлы .br и .gz как сохраненные, без автоматического добавления заголовка Content-Encoding. Сжатая сборка Unity, ожидающая распаковки в собственном браузере, не будет загружаться правильно при этих настройках по умолчанию.

Включите Decompression Fallback, чтобы Unity включал в свою сборку декомпрессор JavaScript. Альтернативно выберите Disabled для сжатия, принимая файлы и загрузки большего размера. Проверьте Документация по развертыванию Unity для вашей версии редактора.

Сохраните index.html, каталог Build/, TemplateData/ и любые другие сгенерированные папки вместе. Загрузка только файла .wasm или .data не приведет к созданию играбельной игры.

Проверьте свой самый большой файл сборки Unity.

Free и анонимный хостинг допускают 5 МБ на файл, всего 50 МБ и 100 файлов. Файлы среды выполнения модуля Unity и файлы данных обычно превышают этот первый предел. Standard допускает 100 МБ на файл, всего 2 ГБ и 10 000 файлов. Сборка может уместиться в пределах 2 ГБ и все равно завершиться неудачей, поскольку размер одного файла данных превышает 100 МБ.

Проверьте готовую сборку перед загрузкой. Если файл превышает ограничение Standard, уменьшите или реструктурируйте сборку перед развертыванием. Область загрузки файлов, указанная выше, ограничена 25 МБ на каждую загрузку; используйте интерфейс командной строки или панель управления с входом в систему для более крупных сборок. Полное сравнение см. в Ограничения игры HTML5.

Темы и частные игровые тесты

Если вы включите Native C/C++ Multithreading, настройте изоляцию между источниками. Поместите это в lobsite.toml рядом с вашим проектом и разверните оттуда с помощью npx lobsite:

dir = "build/web"

[[headers]]
for = "/*"
[headers.values]
Cross-Origin-Opener-Policy = "same-origin"
Cross-Origin-Embedder-Policy = "require-corp"

В области загрузки файлов не указано lobsite.toml. Убедитесь, что все сторонние ресурсы работают изолированно. Для конфиденциальных игровых тестов Standard предлагает пароль, охватывающий каждый адрес сайта, включая предварительные сборки. Многопользовательская игра и другие серверные службы по-прежнему работают отдельно от Lobsite.

У каждого деплоя свой URL

Предпросмотр до публикации. Откат в один клик — вместе с перенаправлениями.

Загружаются только изменённые файлы

Файлы хранятся по хешу. Повторный деплой неизменённого сайта загружает 0 байт.

Защита паролем

На Standard каждый адрес сайта запрашивает пароль. Проверяющие вводят его один раз в каждом браузере.

Свой домен

Даже на бесплатных аккаунтах: добавьте одну DNS-запись, и сайт переедет на ваш домен. У каждого сайта есть HTTPS на любом тарифе.

Конфигурация в одном файле

Перенаправления, заголовки и формы хранятся в lobsite.toml и переезжают с каждым деплоем.

Понятные лимиты

Все лимиты опубликованы, а каждая ошибка подсказывает, что делать дальше.

Unity методы обмена веб-страницами

Метод Что это дает Что проверить
Опубликованный URL-адрес Lobsite Автономный игровой релиз. Настройки сжатия и ограничения плана
URL предварительного просмотра Lobsite Отдельная тестовая сборка Те же настройки, что и опубликованные; предварительный просмотр не заменяет опубликованный
Unity локальный Build and Run Тестирование на вашей машине разработки Публичный хостинг может иметь разные заголовки и пути.

Эквивалентный рабочий процесс WebAssembly в другом движке см. в Godot хостинг. Руководство по играм HTML5 охватывает аудио браузера, встраивание и кеширование.

Частые вопросы

Почему моя сжатая сборка Unity WebGL не загружается?

Проверьте, ожидает ли загрузчик заголовок Content-Encoding. При использовании службы файлов Lobsite по умолчанию выполните перестройку с включенным Decompression Fallback или отключите сжатие. Загрузите полную новую сборку вместе.

Каждая сборка Unity WebGL подходит для Standard?

Нет. Каждый файл должен иметь размер не более 100 МБ, а весь сайт — не более 2 ГБ, при этом количество файлов должно быть не более 10 000. Проверьте фактические файлы среды выполнения двигателя, файлы данных и активов.

Могу ли я публиковать исходные файлы Unity вместо веб-сборки?

Номер Lobsite обслуживает готовую веб-сборку. Он не запускает Unity, не компилирует C# и не превращает исполняемый файл рабочего стола в браузерную игру.

Работает ли многопоточность Unity при загрузке файла в браузер?

При загрузке по умолчанию заголовки изоляции не настраиваются. Используйте CLI и приведенную выше конфигурацию заголовка для сборок, требующих Native C/C++ Multithreading.

См. также