Руководство по настройке многопользовательских строительных блоков

• Auto Matchmaking (Автоматический подбор игроков). Этот блок помогает создать прототип многопользовательской игры, автоматически объединяя всех подключенных игроков в одной комнате.
  • В интеграции Photon Fusion этот блок использует общий режим из Photon Fusion 2.
  • В интеграции Unity Netcode этот блок использует службу Unity Game Services Relay.
• Custom Matchmaking (Пользовательский подбор игроков) (версия 71). Этот блок гарантирует большую гибкость подбора игроков, позволяя делать его на основании кода комнаты (и при необходимости пароля) как для Photon Fusion, так и для Unity Netcode. Вы можете интегрировать его со своим пользовательским интерфейсом и доставкой в ​​рабочем приложении.
• Friends Matchmaking (Подбор друзей) (версия 74). Этот блок интегрируется с API из Meta Platform SDK, чтобы пользователи могли приглашать в приложение друзей из Quest, которые будут автоматически присоединяться к одной сетевой комнате.
• Local Matchmaking (Подбор игроков поблизости) (версия 74). Этот блок использует Colocation Discovery API для автоматического добавления игроков, которые физически находятся поблизости, в одну и ту же сетевую комнату.
• Colocation (Совместное размещение). Этот блок помогает реализовать возможности "локального многопользовательского режима" смешанной реальности, создав общую точку ссылки с помощью Shared Spatial Anchor API, Colocation Discovery API (версия 74) или Space Sharing API (версия 77). Все сетевые игровые объекты, созданные в пространстве мира или сцены, будут видны в одном и том же месте всем расположенным там игрокам.
• Networked Avatar (Сетевой аватар). Этот блок помогает выполнить интеграцию с аватарами Meta для вашего приложения. Он работает в смешанной и виртуальной реальности.
  • Примечание. Диспетчер ввода, используемый для аватаров, представляет собой реализацию на базе плагина Meta XR Plugin, который сейчас не поддерживает плагин OpenXR Plugin.
• Networked Grabbable Object (Сетевой объект, который можно взять). Этот блок обеспечивает синхронизацию для сети объектов и позволяет игрокам брать объекты.
• Player Name Tag (Тег имени игрока). Этот блок помогает создать прототип многопользовательского режима и представляет пример пользовательского интерфейса, в котором имя игрока в Quest отображается над его головой.
• Player Voice Chat (Голосовой чат игроков). Этот используется только для сетевого решения Photon Fusion. Он интегрирует возможности VOIP с пакетом Photon Voice2, благодаря чему удаленно подключенные игроки могут общаться друг с другом в голосовом чате.
• Shared Spatial Anchor Core (Основа общих пространственных привязок). Этот блок предоставляет основные функции для создания, загрузки, удаления и совместного использования общей пространственной привязки.

• Unity Netcode for Game Objects
  • Расценки⁠ (для Relay)
• Photon Fusion⁠
  • Расценки⁠

1. Откройте менеджер пакетов, выбрав Window (Окно) > Package Manager (Менеджер пакетов).
2. Нажмите на кнопку + и выберите Install package by name (Установить пакет по имени).
3. Введите имя пакета в поле Name (Имя) и нажмите Add (Добавить).

• Unity Netcode for Game Objects — com.unity.netcode.gameobjects;
• Unity Service Relay — com.unity.services.relay;
• Unity Service Lobby — com.unity.services.lobby.

• Photon Fusion⁠
  • Требуется для всех многопользовательских блоков, использующих интеграцию Photon Fusion.
  • Обеспечиваемая блоком интеграция реализуется с использованием Fusion 2.
• Photon Voice⁠
  • Требуется только для блока Player Voice Chat.
  • Для этого пакета Photon Voice нам нужна только интеграция с Photon Fusion, поэтому исключите ненужные файлы в соответствии с официальным руководством⁠.

• Meta Interaction SDK: com.meta.xr.sdk.interaction.ovr
  • Этот пакет SDK необходим для блока Networked Grabbable Object и входит в состав Meta XR All-in-one SDK.
• Meta Platform SDK — com.meta.xr.sdk.platform
  • Этот пакет SDK необходим для блока Colocation / Player Name Tag / Networked Avatar и входит в состав Meta XR All-in-one SDK.
• Meta Avatar SDK — com.meta.xr.sdk.avatars
  • Необходим для блока Networked Avatar.
• Примеры аватаров Meta Avatar SDK — com.meta.xr.sdk.avatars.sample.assets
  • В ряде случаев требуется блоку Networked Avatar для отображения примеров аватаров в качестве запасного варианта для игроков, не настроивших собственные аватары Meta.

• Создание тестовых пользователей и тестирование в гарнитуре поможет обойти проверку использования данных, если анализ ещё не завершен.
• Канал выпуска приложений должен быть настроен так, чтобы в него можно было добавлять пользователей, а APK-файл сборки необходимо загрузить в канал как минимум один раз, чтобы разблокировать тестирование общей пространственной привязки. После загрузки первого APK-файла вы сможете повторно использовать функцию Build and Run (Создать и запустить) из Unity. Важный показатель правильности выполненных действий — появление вашего приложения в списке App Library (Библиотека приложений) на гарнитуре, а не в списке Unknown Sources (Неизвестные источники). Если что-то идет не так, перезапуск гарнитуры может привести к обновлению статусов разрешений приложения.
• При тестировании для гарнитуры должен быть включен параметр Enhanced Spatial Services (Улучшенные пространственные технологии).

• Параметр Use Colocation Session (Использование сеанса колокации) отключен. Подбор игроков осуществляется через сетевой фреймворк: для подбора игроков используйте сетевой фреймворк (например, Photon Fusion или NGO). Общие привязки синхронизируются с помощью фреймворка, так что требуется более сложная настройка приложения, чем в случае, описанном ниже. Параметр Install Matchmaking (Установить подбор игроков) позволяет выбрать конкретный способ подбора.
• Параметр Use Colocation Session (Использование сеанса колокации) включен. Подбор игроков с использованием сеанса колокации: на основе Colocation Session/Colocation Discovery API, который использует Bluetooth и Wi-Fi для обнаружения находящихся рядом игроков и автоматического создания группы для них. Привязки и другая информация могут передаваться по локальной сети через Bluetooth или Wi-Fi. Это более простая настройка, чем та, которая описана выше.

• Параметр Share Space To Guests отключен — через одну общую пространственную привязку. Игроки выравниваются относительно одной общей привязки, созданной организатором. Подходит для простых сценариев.
• Параметр Share Space To Guests включен — через предоставление общего доступа к пространству на базе Space Sharing API. Все приглашенные игроки используют конфигурацию пространства, полученную от организатора, а все привязки комнаты выровнены. Этот вариант больше подходит для сценариев, в которых гости должны взаимодействовать с окружающей средой. Если гость взаимодействует с окружением (например, разбрызгивает краску на стену), использование этой опции гарантирует, что все игроки увидят цветовой эффект в одном и том же месте, точно совмещенном с реальной стеной.

• Используйте несколько экземпляров редактора Unity Editor через ParrelSync. Это поможет связать проект с его клонами с помощью символьных ссылок, благодаря чему потребуется только одна итерация.
• Используйте несколько экземпляров Meta XR Simulator для тестирования взаимодействий с вводом при поддержке функции MR.
• Используйте настройки полностью независимой платформы в Platform SDK, чтобы настроить различных тестовых пользователей в редакторе (для проверки аватара, имени игрока, функций колокации).

• Все версии Core SDK поддерживают версии Avatar SDK 24.1 и более ранние.
• При использовании Avatar SDK версии выше 24.1 с Core SDK версии 74 или более ранней блок Networked Avatar, скорее всего, будет некорректно обрабатывать ввод. В этом случае выполните следующий обходной шаг:
  • После установки блока Networked Avatar в сцене найдите GameObject [Строительный блок] Networked Avatar. Этот объект содержит дочерний GameObject AvatarSDK с компонентом EntityInputManager. Замените EntityInputManager компонентом SampleInputManager из пакета примеров объектов, а затем установите значение None для режима отслеживания движений тела. Начиная с Core SDK версии 76 это действие не требуется.
• Компонент SampleInputManager из Avatar SDK, используемый блоком Networked Avatar, не поддерживает Unity OpenXR Plugin до версии Avatar SDK 35.2. Если вы используете Unity OpenXR Plugin, необходимо использовать Avatar SDK версии 35.2 или более поздней.

• Начиная с версии 71 в реализации блока Custom Matchmaking (Пользовательский подбор игроков) в Photon Fusion возникла известная проблема, когда при работе с блоком Networked Grabbable Object (Сетевой объект, который можно взять) (по сути, с сетевыми объектами в текущей сцене) объект вообще не синхронизируется. Это вызвано тем, что текущая сцена не была встроена в параметры при запуске сетевого сеанса.
• В версии 74 блок Colocation (Колокация) с включенным параметром Use Colocation Session (Использовать сеанс колокации) также зависит от блока Custom Matchmaking (Пользовательский подбор игроков), где возникает аналогичная проблема.
• В качестве временного решения проблемы предлагаем изменения кода для скрипта CustomMatchmakingFusion в игровом объекте [Building Blocks] Custom Matchmaking ([Строительные блоки] Пользовательский подбор игроков):

        // CustomMatchmakingFusion.cs
        // Step1. define these functions somewhere in the class
        private static NetworkSceneInfo GetSceneInfo()
        {
            SceneRef sceneRef = default;
            if (TryGetActiveSceneRef(out var activeSceneRef))
            {
                sceneRef = activeSceneRef;
            }
            var sceneInfo = new NetworkSceneInfo();
            if (sceneRef.IsValid) {
                sceneInfo.AddSceneRef(sceneRef, LoadSceneMode.Additive);
            }
            return sceneInfo;
        }

        private static bool TryGetActiveSceneRef(out SceneRef sceneRef)
        {
            var activeScene = SceneManager.GetActiveScene();
            if (activeScene.buildIndex < 0 || activeScene.buildIndex >= SceneManager.sceneCountInBuildSettings) {
                sceneRef = default;
                return false;
            }
            sceneRef = SceneRef.FromIndex(activeScene.buildIndex);
            return true;
        }

        // Step2. within several public functions like `CreateRoom` `JoinRoom` `JoinOpenRoom` with `StartGame` call
        var result = await runner.StartGame(new StartGameArgs
        {
            GameMode = gameMode,
            Scene = GetSceneInfo(), // <- Add this line as apart of the StartGameArgs
            CustomLobbyName = options.LobbyName,
            SessionName = sessionName,
            PlayerCount = options.MaxPlayersPerRoom,
            IsVisible = !options.IsPrivate
        });

• FUSION_WEAVER
• PHOTON_VOICE_DEFINED
• PHOTON_FUSION_PHYSICS_ADDON_DEFINED