For the complete documentation index, see llms.txt. This page is also available as Markdown.

Photon Fusion 2 BR200

Разместите образец королевской битвы BR200 от Photon (Photon Fusion 2) на выделенных серверах Edgegap: по одному развертыванию на матч, используя комплект Edgegap BR200.

Узнайте, как размещать проекты Unity на Edgegap, используя методы из BR200 Battle Royale Sample, королевской битвы до 200 игроков.

Наш набор Edgegap BR200 — это набор файлов, которые вы копируете в свой проект BR200. Он не изменяет и не включает какой-либо код, лицензированный Photon, так что вы получаете BR200 из Unity Asset Store по собственной лицензии.

В этом примере показано:

  • BR200 как выделенный сервер - одно развертывание на матч, размещается рядом с игроками.

  • Без изменений кода BR200 - скрипт запуска сопоставляет внедряемые переменные с собственными параметрами командной строки BR200.

  • Прямые подключения - сервер привязывается 0.0.0.0, поэтому клиенты подключаются напрямую, а не через ретранслятор Photon.

  • Выбор региона Photon - сервер выбирает регион Photon, ближайший к своему развертыванию.

  • Автоостановка сервера - сервер останавливает собственное развертывание, когда матч заканчивается.

✔️ Подготовка

Прежде чем начать, вам понадобится:

Откройте свой проект и установите инструменты сборки сервера, выполнив Unity шаги подготовки.

Этот набор был протестирован с BR200 2.1.0, Fusion 2.1.1 (build 2177) и Unity 6000.3.11f1 на Windows.

☑️ Чтобы собрать Linux IL2CPP на Windows, добавьте Linux toolchain Unity в Window / Package Manager / + / Add package by name:

  • Unity 6000.3 и новее: com.unity.toolchain.win-x86_64-linux и com.unity.sdk.linux-x86_64,

  • более ранние версии: com.unity.toolchain.win-x86_64-linux-x86_64.

⚡ Развертывание и подключение

1. Добавьте набор в свой проект

☑️ Скопируйте Assets/EdgegapBR200, edgegap/, scripts/, .dockerignore и .gitattributes из набора в корень вашего проекта BR200, рядом с Assets/.

☑️ Вставьте свой Fusion App ID в Tools / Fusion / Realtime Settings и запомните свой версию приложения.

Клиенты и сервер должны использовать один и тот же App ID, App Version и регион Photon, иначе они не найдут друг друга.

☑️ Установите режим Peer в Single в Tools / Fusion / Network Project Config.

☑️ Запустите Tools / Edgegap BR200 / Check Project и исправьте все отмеченные проблемы.

Вам не нужно редактировать сцену или скрипт Loader. Режим сервера, адрес, порт, сессия и регион передаются через командную строку.

Если в консоли отображается Unsafe code may only appear if compiling with /unsafe сразу после первого импорта закройте и снова откройте проект.

✅ Теперь можете перейти к следующему шагу.

2. Соберите и загрузите сервер

☑️ Для начала вам нужно будет создать бесплатную учетную запись в Edgegap. Кредитная карта не требуется.

☑️ Соберите и загрузите свой сервер с помощью плагина Edgegap или из терминала:

☑️ Запустите Tools / Edgegap BR200 / Build Linux Server. Он проверит ваш проект, включит Allow 'unsafe' Code при необходимости и соберет Linux Server подцель в Builds/EdgegapServer.

☑️ Откройте Tools / Edgegap Server Hosting. На шаге 3. Контейнеризуйте свой сервер, нажмите Path To Dockerfile и выберите edgegap/Dockerfile. Оставьте Relative Build Path на Builds/EdgegapServer, затем выполните контейнеризацию и загрузку.

☑️ Оставьте порт 7777 / UDP, когда плагин создаст версию вашего приложения.

☑️ Найдите свой Container Registry имя проекта и учетные данные, затем войдите с помощью docker login registry.edgegap.com.

☑️ Соберите свой сервер, затем упакуйте и отправьте образ (Git Bash работает на Windows):

package.sh выводит новый тег, который он отправил.

☑️ Создайте приложение и версию для вашего образа. Вы также можете использовать examples/app-version.json из набора с POST /v1/app/{app}/version.

☑️ Настройте версию вашего приложения со следующими параметрами:

  • порт 7777, протокол UDP, имя gameport,

  • политика перезапуска never - развертывание завершается, когда матч заканчивается и сервер выходит,

  • максимальная длительность немного выше, чем у вашего самого длинного матча (60 минут в примере),

  • ресурсы 1 vCPU и 2 ГБ — как отправная точка.

✅ Теперь можете перейти к следующему шагу.

3. Локальное тестирование

☑️ Запустите свой образ локально с теми же внедряемыми переменными, что получает реальное развертывание:

☑️ Присоединитесь к напечатанному имени сессии из двух редакторов или двух клиентских сборок, используя Вариант B из следующего шага с этим именем сессии и переданным вами регионом.

Локальные клиенты подключаются Через ретранслятор, поскольку клиенты на одном компьютере не могут напрямую достичь NAT-адреса Docker Desktop. На Edgegap тот же образ подключается Напрямую.

✅ Теперь можете перейти к следующему шагу.

4. Разверните и подключитесь

☑️ Запустите развертывание из плагина, панели управления, или POST /v2/deployments с examples/deploy-request.json. Передайте публичные IP ваших игроков в разверните рядом с ними.

FQDN вашего развертывания (например 0a1b2c3d4e5f.pr.edgegap.net) также является именем сессии и сервера BR200. Первые строки журнала сервера показывают адрес привязки, публичный адрес и выбранный регион Photon:

☑️ Подключите клиента одним из следующих способов:

  • Вариант A: Меню - откройте TPSBR/Scenes/Menu, нажмите ▶️ Play, выберите тот же регион и подключитесь к серверу из списка,

  • Вариант B: автоматическое присоединение Standalone Manager - откройте сцену, заданную как Batch Mode Scene. В Standalone Manager, установите Game Mode в Client, установите Server Name и Session Name равными вашему FQDN, установите Region равным региону сервера, затем нажмите ▶️ Play.

☑️ Нажмите Tab в подключенном клиенте. В левом верхнем углу оверлея отображается CT (Connection Type), что должно означать Напрямую.

🙌 Поздравляем с вашим первым развертыванием на Edgegap!

🔄 Жизненный цикл матча

  1. Edgegap запускает развертывание и внедряет ARBITRIUM_* переменные.

  2. edgegap/start-server.sh преобразует их в параметры командной строки BR200. Он всегда передает -dedicatedServer -ip 0.0.0.0 -port 7777, называет сессию по FQDN развертывания и выбирает регион Photon, ближайший к развертыванию.

  3. Клиенты находят сервер в том же регионе Photon и подключаются напрямую.

  4. Когда BR200 завершается в конце матча, скрипт вызывает ARBITRIUM_DELETE_URL чтобы остановить развертывание, поэтому завершенный матч сразу прекращает списание средств. Когда Edgegap останавливает развертывание, скрипт вместо этого пересылает сигнал остановки в BR200.

См. Развертывания чтобы узнать больше.

⚙️ Переменные среды

Edgegap внедряет ARBITRIUM_* переменные автоматически. Установите эти BR200_* переменные в версии вашего приложения (каждый матч) или в запросе на развертывание (только этот матч):

Переменная
По умолчанию
параметр BR200

BR200_SESSION

FQDN развертывания, <ARBITRIUM_REQUEST_ID>.pr.edgegap.net

-sessionName

BR200_SERVER_NAME

То же, что и сессия

-serverName

BR200_REGION

auto: ближайший к развертыванию регион Photon. best: пусть Fusion пингует. Или код, такой как eu.

-region

BR200_REGION_ALLOWLIST

Все регионы Photon. Коды через запятую, из которых auto можно выбирать.

BR200_MAX_PLAYERS

200 (1 до 200)

-maxPlayers

BR200_MODE

по умолчанию BR200. battleRoyale, deathmatch или elimination.

-battleRoyale / -deathmatch / -elimination

BR200_SCENE

Batch Mode Scene загрузчика

-scene

BR200_LOBBY

по умолчанию BR200

-lobby

BR200_FPS

частота тиков Fusion

-fps

BR200_RECORD

false. true записывает статистику сессии в /data.

-recordSession -dataPath /data

BR200_EXTRA_ARGS

Нет. Другие параметры, добавляемые в конце.

BR200_SELF_STOP

true. Останавливайте развертывание, когда BR200 завершает работу.

Если ваши клиенты используют фиксированный регион Photon или ваше приложение Photon разрешает только некоторые регионы, установите BR200_REGION в развертывании, или ограничьте auto из набора с BR200_REGION_ALLOWLIST.

🔌 Прямое подключение

BR200 IP и Порт установите адрес, к которому ваш сервер привязывается . Набор привязывается 0.0.0.0:7777, Fusion находит публичный адрес развертывания самостоятельно, и клиенты подключаются Напрямую - даже несмотря на то, что Edgegap дает игрокам другой внешний порт.

Server IP

Результат

0.0.0.0 (этот набор)

Напрямую на Edgegap.

127.0.0.1

Сервер запускается, но клиенты Через ретранслятор через Photon, что добавляет задержку. Ничто вне контейнера не может достичь адреса loopback.

Публичный IP развертывания

Сервер не запускается (Не удалось привязать сокет), потому что контейнер не владеет этим адресом. Клиенты получают GameNotFound.

🚨 Устранение неполадок

MethodAccessException ... CheckInvokeRpc в журнале сервера
  • Ваш сервер был собран с Mono. Пересоберите его с IL2CPP.

Не найден Toolchain для платформы хоста или Не найден Linux sysroot
Клиент получает GameNotFound
  • Версия приложения или регион Photon отличаются между клиентом и сервером. Сравните с строкой журнала photon_region= .

Клиент получает InvalidAuthentication
  • Ваш App ID Fusion указан неверно или отсутствует в сборке.

Вкладка Overlay показывает CT Relayed
Сервер не отображается в меню
  • Регион клиента отличается от региона сервера, или 120-секундный таймер ожидания уже истек.

Развертывание немедленно завершается с ошибка: ...
  • Значение BR200_* недопустимо. В строке журнала указано, какое именно.

Если вам нужна помощь, свяжитесь с нами через Discord. Для поддержки по играм в реальном времени см. нашу систему тикетов.

Последнее обновление

Это было полезно?