XRServer

public static bool CameraLockedToOrigin { get; set; }

Если установлено значение true, сцена будет визуализироваться так, как будто камера заблокирована на XROrigin3D. Примечание: Это не очень удобно для пользователей. Эта настройка существует для проведения бенчмаркинга или автоматизированного тестирования, когда вы хотите контролировать то, что визуализируется через код.

public static XRInterface PrimaryInterface { get; set; }

Основной XRInterface, связанный в данный момент с XRServer.

public static Transform3D WorldOrigin { get; set; }

Игровой origin XRServer. Активный XROrigin3D публикует сюда свой мировой трансформ; прямое присваивание может быть перезаписано им. Setter испускает WorldOriginChanged даже при повторе. Для перемещения рига двигайте его origin/тело, не поддерживайте два независимых владельца. GetAdjustedTransform pose не включает это значение.

public static double WorldScale { get; set; }

Общий масштаб tracking относительно игровых единиц, изначально 1. Setter ограничивает конечные значения 0.01…1000 и передаёт состояние рендеру. Проверяйте конечность до вызова: сравнения диапазона не отбрасывают NaN. Меняет поправку pose, не локальный Scale Entity и не сохранённые скорости.

public static void AddInterface(XRInterface @interface);

Регистрирует объект XRInterface.

public static void AddTracker(XRPositionalTracker tracker);

Регистрирует ненулевой объект по текущему имени. Повтор той же ссылки не испускает событие; другой объект с тем же именем заменяет запись и вызывает TrackerUpdated. Новое имя вызывает TrackerAdded. Не обнаруживает устройство и не проверяет аппаратные возможности. Имя сохраняйте стабильным до удаления.

public static void AddTracker(XRTracker tracker);

Регистрирует ненулевой объект по текущему имени. Повтор той же ссылки не испускает событие; другой объект с тем же именем заменяет запись и вызывает TrackerUpdated. Новое имя вызывает TrackerAdded. Не обнаруживает устройство и не проверяет аппаратные возможности. Имя сохраняйте стабильным до удаления.

public static void CenterOnHmd(XRServer.RotationMode rotationMode, bool keepHeight);

Важно правильно понимать эту функцию. Платформы дополненной и виртуальной реальности (AR) и виртуальной реальности (VR) обрабатывают позиционирование немного по-разному. На платформах, не поддерживающих пространственное отслеживание, наша исходная точка (0, 0, 0) — это местоположение нашего шлема виртуальной реальности (HMD), но вы практически не можете контролировать направление взгляда игрока в реальном мире. На платформах, поддерживающих пространственное отслеживание, наша исходная точка сильно зависит от системы. В OpenVR наша исходная точка обычно находится в центре пространства отслеживания на земле. На других платформах это часто местоположение камеры отслеживания. Этот метод позволяет центрировать трекер относительно местоположения шлема виртуальной реальности (HMD). Он берёт текущее местоположение шлема виртуальной реальности и использует его для корректировки всех данных отслеживания; по сути, он адаптирует реальный мир к текущему положению игрока в игровом мире. Для получения приемлемых результатов этот метод должен быть доступен для отслеживания. Это часто происходит через несколько кадров после запуска игры. Вызвать этот метод следует через несколько секунд. Например, когда пользователь запрашивает перенастройку дисплея, удерживая назначенную кнопку на контроллере в течение короткого периода времени, или при реализации механизма телепортации.

public static void ClearReferenceFrame();

Сбрасывает поправку reference frame в Identity, передаёт её рендеру и испускает ReferenceFrameChanged. Не меняет игровой origin, настройки масштаба или сырые pose. Поведение сверено с исходником; реальный recenter не проверен.

public static XRInterface FindInterface(string name);

Находит интерфейс по его name. Например, если ваш проект использует возможности платформы AR/VR, вы можете найти интерфейс для этой платформы по имени и инициализировать его.

public static Reckfell.Collections.Array<Transform3D> GetCameraOffsets(StringName trackerName);

Получает набор перестановок для каждого просмотра для трекера tracker_name. tracker_name должен иметь в виду XRPositionalTracker Используется в качестве камеры. Сначала проверьте наш первичный интерфейс, потом проверьте каждый активный интерфейс. Возвращается пустым, если интерфейсы не управляют этим трекером.

public static Reckfell.Collections.Array<Projection> GetCameraProjections(StringName trackerName, double aspect, double near, double far);

Получает набор матриц проекций для каждого вида для трекера tracker_name. tracker_name должен иметь в виду XRPositionalTracker Используется в качестве камеры. Сначала проверьте наш первичный интерфейс, потом проверьте каждый активный интерфейс. Возвращается пустым, если интерфейсы не управляют этим трекером.

public static Transform3D GetHmdTransform();

Возвращает преобразование основного интерфейса.

public static XRInterface GetInterface(int idx);

Возвращает интерфейс, зарегистрированный по заданному idx индексу в списке интерфейсов.

public static int GetInterfaceCount();

Возвращает количество интерфейсов, зарегистрированных в настоящее время на AR/VR-сервере. Если ваш проект поддерживает несколько AR/VR-платформ, вы можете просмотреть все доступные интерфейсы и либо предложить пользователю выбор, либо просто попытаться инициализировать каждый интерфейс и использовать первый, который вернет true.

public static Reckfell.Collections.Array<Reckfell.Collections.Dictionary> GetInterfaces();

Возвращает список доступных интерфейсов с указанием идентификатора и названия каждого интерфейса.

public static Transform3D GetReferenceFrame();

Копия поправки пространства tracking. GetAdjustedTransform слева умножает на неё pose после масштаба позиции. Это не игровой WorldOrigin. Здесь проверялся только Identity; recenter требует отдельной проверки устройства.

public static XRTracker GetTracker(StringName trackerName);

Возвращает зарегистрированный XRTracker по точному имени или null. Поддерживает в том числе непозиционные tracker, которые текущий GetTrackers пропускает. Объект общий: не освобождайте заимствованную C# обёртку и не меняйте данные поставщика.

public static Reckfell.Collections.Dictionary GetTrackers(int trackerTypes);

Возвращает отдельный Dictionary: ключ — имя, значение — общий объект tracker. Очистка контейнера не снимает регистрацию. Маска сравнивается с Type побитово. Подтверждён дефект: реализация сначала приводит объекты к XRPositionalTracker, поэтому даже Any пропускает непозиционный XRFaceTracker. Для известного имени используйте GetTracker; не считайте этот список полным.

public static Transform3D GetWorldOrigin();

Копия текущего игрового origin сервера, не сырая pose головы. На потоке рендера читается состояние кадра рендера.

public static double GetWorldScale();

Возвращает общий масштаб как double. На потоке рендера читается его сохранённое состояние, на основном — текущее состояние сервера. Синхронизация потоков здесь не проверялась.

public static void RemoveInterface(XRInterface @interface);

Удаляет этот interface.

public static void RemoveTracker(XRPositionalTracker tracker);

Удаляет запись по текущему имени переданного объекта, а не по идентичности ссылки. После замены объекта старая ссылка с тем же именем может удалить новый tracker. TrackerRemoved испускается до удаления записи; в обработчике GetTracker ещё может вернуть её. Не уничтожает внешние ссылки и не синтезирует отпускание кнопок.

public static void RemoveTracker(XRTracker tracker);

Удаляет запись по текущему имени переданного объекта, а не по идентичности ссылки. После замены объекта старая ссылка с тем же именем может удалить новый tracker. TrackerRemoved испускается до удаления записи; в обработчике GetTracker ещё может вернуть её. Не уничтожает внешние ссылки и не синтезирует отпускание кнопок.

public static void SetWorldOrigin(Transform3D worldOrigin);

Игровой origin XRServer. Активный XROrigin3D публикует сюда свой мировой трансформ; прямое присваивание может быть перезаписано им. Setter испускает WorldOriginChanged даже при повторе. Для перемещения рига двигайте его origin/тело, не поддерживайте два независимых владельца. GetAdjustedTransform pose не включает это значение.

public static void SetWorldScale(double scale);

Общий масштаб tracking относительно игровых единиц, изначально 1. Setter ограничивает конечные значения 0.01…1000 и передаёт состояние рендеру. Проверяйте конечность до вызова: сравнения диапазона не отбрасывают NaN. Меняет поправку pose, не локальный Scale Entity и не сохранённые скорости.

public static event XRServer.InterfaceAddedEventHandler InterfaceAdded;

Выдается при добавлении нового интерфейса.

public static event XRServer.InterfaceRemovedEventHandler InterfaceRemoved;

Выдается при удалении интерфейса.

public static event Action ReferenceFrameChanged;

Испускается при изменении преобразования системы отсчета.

public static event XRServer.TrackerAddedEventHandler TrackerAdded;

Событие новой записи после её добавления. Передаёт имя и числовую категорию long, не сам объект. Это регистрация поставщиком, не подтверждение актуальной pose или аппаратного подключения.

public static event XRServer.TrackerRemovedEventHandler TrackerRemoved;

Событие до удаления записи из реестра. В обработчике поиск по имени ещё может вернуть объект; не используйте это как доказательство, что удаление отменилось. После выхода из RemoveTracker запись уже отсутствует.

public static event XRServer.TrackerUpdatedEventHandler TrackerUpdated;

Событие замены объекта другим с тем же именем. Повтор AddTracker той же ссылки не вызывает его. Не является событием каждого кадра tracking; обновления pose идут отдельно.

public static event Action WorldOriginChanged;

Испускается при изменении преобразования начала координат мира.