Предварительные требования к строительному блоку Vivox

Чтобы использовать строительный блок Vivox, настройте следующее в вашем проекте:

• Проект Unity (рекомендуется 6.0 LTS или более поздний).
• Доступ к панели Unity и организации Unity.
• Вход редактора с пользователем, который имеет доступ к организации и проекту.
• Услуга Vivox включена в панели Unity для вашего проекта.
• Сетевой доступ к конечным точкам Unity Услуги.
• Базовое знание UI Toolkit и Префабы (необязательно, но полезно).

Как работает Vivox Building Block

Vivox Building Block предназначен для гибкой, модульной интеграции голосовой и текстовой связи в ваш проект Unity.

Инициализация службы

Прежде чем какие-либо функции Vivox могут функционировать, убедитесь, что следующие шаги уже выполнены:

• Unity Сервисное ядро должно быть инициализовано
• Игрок должен быть аутентифицирован
• Vivox SDK должен быть инициализован.

Building Block содержит VivoxServiceInitializer префаб в папке Ассеты > Blocks > Вивокс > Префабы, который выполняет все три шага в одном готовом к подключению GameObject.

префаб содержит следующие компоненты:

• ServicesInitialization: Инициализация Unity Services Core при запуске.
• PlayerAuthentication: Входит игрок анонимно, как только Core готов.
• VivoxServiceInitializer: Дожидается завершения Core, затем инициализирует Vivox SDK.

Добавьте VivoxServiceInitializer префаб к вашей сцене для настройки с нулевым настройкой. Если ваш проект уже обрабатывает инициализацию и аутентификацию службы через свой собственный поток, вы можете опустить префаб. Компоненты Vivox UI будут работать с любым подходом инициализации, пока все три шага завершены до присоединения канала. Все включенные сцены используют VivoxServiceInitializer префаб.

Реализация: C# скрипты, визуальные элементы и разделение данных

Ключевым архитектурным принципом Building Block является четкое разделение между визуальным представлением и базовыми данными и логикой.

• Скрипты VisualElement: расширяют VisualElement или его производные и отвечают за отображение компонентов UI, с которыми взаимодействуют игроки. Они открывают UxmlAttribute для ChannelSettings ссылку, которая передаётся классу данных.
• Скрипты данных: управление фактическим состоянием Vivox, взаимодействие с Vivox SDK через VivoxObserver, и обработка логики, связанной с событиями канала и участника.

ChannelSettings, ScriptableObject и UXML связывающие

Поведение канала настраивается через ChannelSettings ScriptableObject, который контролирует тип канала (Группа или Эхо) и возможности чата (AudioOnly, TextOnly, или TextAndAudio). Два предустановленных параметра включены в Активы > Блоки > Вивокс > Настройки: ChatSettings_Group для стандартного многопользовательского голоса и текста, и ChatSettings_Echo для тестирования обратной связи. Чтобы создать пользовательский предустановленный параметр, щелкните правой кнопкой мыши в окне Project и выберите Создать > Услуги > Блоки > Вивокс > ChannelSettings.

Примечание: Позиционные (3D) каналы в настоящее время не поддерживаются этим Building Block. Позиционное аудио требует дополнительной конфигурации через Vivox SDK напрямую.

Preset подключается к вашей сцене через систему привязки данных UI Toolkit. В UI Builder выберите корень VisualElement из UXML вашей сцены и установите его источник данных на выбранный ассет ChannelSettings. Настройки автоматически распространяются на компонент JoinChannel оттуда, без изменений кода.

Использование Multiplayer Play Mode с вашими строительными блоками

С помощью Multiplayer Play Mode (MPPM) в Unity можно тестировать многопользовательские игры с несколькими виртуальными игроками.

Установка Multiplayer Play Mode

Чтобы начать тестирование многопользовательской игры, установите пакет Multiplayer Play Mode следующим образом:

1. В главном меню выберите Окно > Управление пакетами > Package Manager.
2. Выберите Unity Реестр.
3. Найдите пакет Multiplayer Play Mode, затем выберите Установка.

Режим игры Unity использует Главный редактор Player для тестирования вашей игры. Добавляя пакет Multiplayer Play Mode, вы можете включить до трех дополнительных экземпляров редактора для четырех игроков для тестирования проектов с несколькими игроками.

Виртуальных игроков нужно включить до входа в режим Play.

Включение дополнительных экземпляров редактора

Чтобы включить дополнительные экземпляры Редактора для режима воспроизведения, выполните следующие действия:

1. Если вы еще не сделали этого, создайте свой сценарий режима игры.
2. Выберите сценарий, который вы создали или который уже существует.
3. Редактор и дополнительные экземпляры Редактора отображаются в правой части окна.
4. Если ни один из них не отображается, убедитесь, что флажок рядом с Редактор установлен.
5. Чтобы добавить дополнительные экземпляры Редактора, нажмите кнопку + в разделе Дополнительные экземпляры Редактора.

Дополнительные ресурсы

• Vivox Unity SDK документация
• UI Toolkit
• Unity Аутентификация
• Multiplayer Play Mode