Справочная информация о свойствах конфигурации панели ввода

Компонент Panel Input Configuration предоставляет свойства для настройки параметров ввода для Мирового Пространства UI, а также для указания того, как UI Toolkit взаимодействует с uGUI (Unity UI).

Свойства мировых космических опционов

В следующей таблице описаны свойства, доступные для World Space Options:

Свойство	Описание
Слои взаимодействия	Выберите один или несколько физических слоев, чтобы запустить лучи Мирового Космоса и определить цели событий указателя.
Максимальное расстояние взаимодействия	Установить, насколько далеко взаимодействия с Мировым Пространством UI возможны. По умолчанию неограниченно (бесконечно), но вы можете настроить его для XR или потребностей производительности. Расстояние использует GameObject единицы, согласующиеся с позициями преобразования и Camera плоскостями обрезки.
Событие по умолчанию Camera Является Главным Camera	Включить или отключить использование главной камеры в качестве камеры событий для преобразования позиций экрана в лучи космического пространства. Если включено и главная камера изменяется, камера событий автоматически обновляется до новой камеры. Если главная камера не активна, Unity отключает экранные события до тех пор, пока не активируется главная камера.
Камера событий	Настройка одной или нескольких камер для преобразования позиций экрана в лучи космического пространства, когда основная камера не используется. Если вы указываете несколько камер, Unity обрабатывает их последовательно, пока одна из них не создает луч, который попадает в Collider. Примечание: Если вы не указываете камеры событий, Unity отключает события, основанные на экране.

Свойства взаимодействия системы событий

Вы можете использовать свойства Event System Interaction для настройки взаимодействия UI Toolkit с системой uGUI.

Перенаправление ввода панели

Свойство Перенаправление ввода панели определяет, будет ли uGUI EventSystem перенаправлять ввод панели. Если это свойство включено, вы можете выбрать один из следующих вариантов:

• Автоматический переключатель (перенаправляет с EventSystem, если есть) (по умолчанию): Пока EventSystem активен, он служит источником ввода для всех UI. В противном случае, встроенный вход UIToolkit обрабатывает ввод.
• Нет перенаправления ввода: Встроенный вход UI Toolkit обрабатывает ввод, независимо от того, активен ли EventSystem.
• Всегда перенаправлять из EventSystem (ждать, если недоступно): Ввод остается отключенным до тех пор, пока не активируется EventSystem, в этот момент он становится источником ввода. Используйте этот режим для динамического включения или отключения всех входов UI путем переключения компонента EventSystem.

Автоматическое создание компонентов панели

Свойство Автоматическое создание компонентов панели определяет, следует ли автоматически создавать компоненты UI Toolkit под панелью EventSystem для обработки перенаправления ввода между панелями UI Toolkit и uGUI.

Если вы включите эту опцию, Unity автоматически создаст следующие компоненты:

• Обработчик событий панели
• Панель Рейкастер
• Мировой Документ Рейкастера

Если вы отключите эту опцию, убедитесь, что вы назначили компонент World Document Raycaster для каждой камеры событий World Space. Вы также должны убедиться, что каждая панель имеет связанный компонент Panel Raycaster и Panel Event Handler через ваш код C#. Следующий пример кода показывает, как это сделать:

using UnityEngine.UIElements;

// Add this component to a GameObject to automatically initialize the following components
// - PanelRaycaster
// - PanelEventHandler
public class PanelComponentsInitializer : MonoBehaviour
{
    public PanelSettings panelSettings;

    void Start()
    {
        var panelRaycaster = GetComponent<PanelRaycaster>();
        if (panelRaycaster != null)
            panelRaycaster.panel = panelSettings.panel;

        var panelEventHandler = GetComponent<PanelEventHandler>();
        if (panelEventHandler != null)
            panelEventHandler.panel = panelSettings.panel;
    }
}

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

• Настройки панели Runtime
• 📚 Документация:XR UI Toolkit Всемирная космическая поддержка