XRInterface

public bool ArIsAnchorDetectionEnabled { get; set; }

В интерфейсе дополненной реальности, если true включено обнаружение привязки.

public XRInterface.EnvironmentBlendModeEnum EnvironmentBlendMode { get; set; }

Запрошенный режим композиции интерфейса. Базовый getter возвращает Opaque; OpenXR может эмулировать AlphaBlend при другом внутреннем режиме. Setter свойства не сообщает об отказе: для обработки результата используйте SetEnvironmentBlendMode. Это не флаг готовности видеокамер и не настройка TransparentBg.

public bool InterfaceIsPrimary { get; set; }

true , если это основной интерфейс.

public XRInterface.PlayAreaMode XRPlayAreaMode { get; set; }

Режим игровой зоны для этого интерфейса.

public int GetCameraFeedId();

Если это интерфейс дополненной реальности, требующий отображения потока камеры в качестве фона, этот метод возвращает идентификатор потока в CameraServer для этого интерфейса.

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

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

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

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

public uint GetCapabilities();

Возвращает комбинацию флагов XRInterface.Capabilities, предоставляющих информацию о возможностях этого интерфейса.

public XRInterface.EnvironmentBlendModeEnum GetEnvironmentBlendMode();

Возвращает режим, сообщаемый реализацией; в OpenXR — requested mode, в базовом интерфейсе — Opaque. Не подтверждает активную сессию, фокус, получение видео или согласие пользователя. Для alpha отдельно настройте прозрачный фон Viewport.

public StringName GetName();

Возвращает имя этого интерфейса ("OpenXR", "OpenVR", "OpenHMD", "ARKit" и т. д.).

public Vector3[] GetPlayArea();

Возвращает массив векторов, представляющих физическую игровую зону, сопоставленную с виртуальным пространством вокруг точки XROrigin3D. Точки образуют выпуклый многоугольник, который можно использовать для реагирования на игровую зону или ее визуализации. Это возвращает пустой массив, если эта функция не поддерживается или если информация еще недоступна.

public Projection GetProjectionForView(uint view, double aspect, double near, double far);

Возвращает матрицу проекции для вида/глаза.

public Vector2 GetRenderTargetSize();

Возвращает разрешение, с которым следует визуализировать промежуточные результаты, прежде чем VR-платформа применит такие эффекты, как искажение объектива.

public Reckfell.Collections.Array GetSupportedEnvironmentBlendModes();

Возвращает новый контейнер значений EnvironmentBlendModeEnum. Базовая реализация содержит Opaque; OpenXR без внутреннего API возвращает пустой список, после запуска может добавлять эмулируемый AlphaBlend. Проверяйте наличие конкретного значения через Contains, не индекс как bool. Контейнер можно Dispose; интерфейс остаётся заимствованным.

public Reckfell.Collections.Dictionary GetSystemInfo();

Возвращает Reckfell.Collections.Dictionary с дополнительной системной информацией. Интерфейсы должны возвращать XRRuntimeName и XRRuntimeVersion, предоставляя информацию об используемой среде выполнения XR. Дополнительные записи могут быть предоставлены для конкретного интерфейса. **Примечание:**Эта информация может быть доступна только после успешного вызова XRInterface.Initialize.

public XRInterface.TrackingStatus GetTrackingStatus();

Если поддерживается, возвращает статус нашего отслеживания. Это позволит вам предоставить пользователю обратную связь, если есть проблемы с позиционным отслеживанием.

public Transform3D GetTransformForView(uint view, Transform3D camTransform);

Возвращает преобразование для вида/глаза. view — индекс вида/глаза. cam_transform — преобразование, которое сопоставляет координаты устройства с координатами сцены, обычно Entity3D.GlobalTransform текущего XROrigin3D.

public uint GetViewCount();

Возвращает количество видов, которые необходимо отобразить для этого устройства. 1 для Моноскопического, 2 для Стереоскопического.

public bool Initialize();

Вызовите это, чтобы инициализировать этот интерфейс. Первый инициализированный интерфейс определяется как основной интерфейс, и он будет использоваться для рендеринга вывода. После инициализации интерфейса, который вы хотите использовать, вам необходимо включить режим AR/VR вьюпорта, и рендеринг должен начаться. Примечание: Вы должны включить режим XR на главном вьюпорте для любого устройства, которое использует основной вывод Reckfell, например, для мобильного VR. Если вы сделаете это для платформы, которая обрабатывает свой собственный вывод (например, OpenVR), Reckfell покажет только один глаз без искажений на экране. В качестве альтернативы вы можете добавить отдельный узел вьюпорта в свою сцену и включить AR/VR на этом вьюпорте. Он будет использоваться для вывода на HMD, что позволит вам делать все, что угодно в главном окне, например, использовать отдельную камеру в качестве камеры зрителя или рендерить что-то совершенно другое. Хотя в настоящее время это не используется, вы можете активировать дополнительные интерфейсы. Вы можете сделать это, если хотите отслеживать контроллеры с других платформ. Однако на данный момент только один интерфейс может осуществлять рендеринг на HMD.

public bool IsInitialized();

Возвращает true, если этот интерфейс был инициализирован.

public bool IsPassthroughEnabled();

Устаревший метод. Вместо него сравнивайте GetEnvironmentBlendMode() с AlphaBlend. В OpenXR он только сравнивает сообщаемый режим, не проверяет кадры камеры, session focus или разрешения; в базовом интерфейсе возвращает false.

public bool IsPassthroughSupported();

Устаревший метод; используйте GetSupportedEnvironmentBlendModes и membership AlphaBlend. В текущем OpenXR есть дефект: find возвращает индекс, преобразуемый в bool; −1 даёт true, индекс 0 — false. Воспроизведён true при пустом списке без инициализации. Ошибка не исправлена; результат нельзя использовать как capability gate.

public bool SetEnvironmentBlendMode(XRInterface.EnvironmentBlendModeEnum mode);

Запрашивает режим и возвращает результат setter реализации. Проверяйте список поддерживаемых режимов и bool; отдельно меняйте TransparentBg только после принятого запроса. OpenXR без API возвращает false, а перед завершением инициализации внутренний API может сохранить запрос для поздней проверки. Успех не подтверждает видео или фокус.

public bool SetPlayAreaMode(XRInterface.PlayAreaMode mode);

Устанавливает режим активной игровой зоны, вернет false, если режим не может быть использован с этим интерфейсом. Примечание: Изменение этого после того, как интерфейс уже инициализирован, может быть неприятным для игрока, поэтому рекомендуется выполнить центрирование на HMD с помощью XRServer.CenterOnHmd (при переключении на XRInterface.PlayAreaMode.Stage) или выполнить переключение во время смены сцены.

public bool StartPassthrough();

Устаревший метод. В OpenXR просто вызывает SetEnvironmentBlendMode(AlphaBlend); базовая реализация возвращает false. Не включает прозрачность Viewport и не инициализирует сессию. Для нового кода явно проверяйте список режимов и результат SetEnvironmentBlendMode.

public void StopPassthrough();

Устаревший метод. OpenXR запрашивает Opaque без возвращаемого результата; базовая реализация ничего не делает. Не восстанавливает прежний blend mode или TransparentBg. Сохраните состояние и выполните явное обратное переключение с проверкой bool.

public bool SupportsPlayAreaMode(XRInterface.PlayAreaMode mode);

Вызовите этот метод, чтобы узнать, поддерживается ли данный режим игровой зоны данным интерфейсом.

public void TriggerHapticPulse(string actionName, StringName trackerName, double frequency, double amplitude, double durationSec, double delaySec);

Выключает хаптический импульс на устройстве, связанном с этим интерфейсом. action_name - название действия для этого импульса. tracker_name является факультативным и может использоваться для направления импульса на конкретное устройство при условии, что это устройство связано с этим хаптическим устройством. frequency - частота импульса, установленная на 0.0 для использования системы по умолчанию. amplitude - амплитуда импульса между 0.0 и 1.0. duration_sec - продолжительность импульса в секундах. delay_sec - задержка в секундах перед подачей импульса.

public void Uninitialize();

Отключает интерфейс.

public event XRInterface.PlayAreaChangedEventHandler PlayAreaChanged;

Выдается при изменении игровой зоны. Это может быть результатом сброса игроком границы или входа в новую игровую зону, смены игроком режима игровой зоны, изменения масштаба мира или сброса игроком ориентации гарнитуры.