Настройка наблюдателей сетки для устройства — MRTK2
В этом руководстве описана настройка встроенного наблюдателя пространственной сетки в MRTK, который поддерживает платформу Windows Mixed Reality (например, HoloLens). Реализация по умолчанию, предоставляемая Смешанная реальность Toolkit, — это класс WindowsMixedRealitySpatialMeshObserver. Многие свойства, приведенные в этой статье, относятся к другим пользовательским реализациям Observer.
Параметры профиля
Следующие два элемента необходимо сначала определить при настройке профиля наблюдателя пространственной сетки для системы пространственной осведомленности.
- Конкретная реализация типа наблюдателя
- список поддерживаемых платформ для запуска этого наблюдателя
Примечание
Все наблюдатели должны расширить интерфейс IMixedRealitySpatialAwarenessObserver .
Общие параметры
Поведение при запуске
Поведение при запуске указывает, начнет ли наблюдатель выполняться при создании первого экземпляра. Эти два варианта указаны ниже:
- Автозапуск — значение по умолчанию, при котором наблюдатель начнет работу после инициализации.
- Запуск вручную — наблюдатель будет ожидать перенаправления на запуск
При использовании ручного запуска их необходимо возобновить и приостановить во время выполнения с помощью кода.
Интервал обновления
Время (в секундах) между запросами к платформе для обновления данных пространственной сетки. Типичные значения попадают в диапазон 0,1 и 5,0 секунды.
Является стационарным наблюдателем
Указывает, будет ли наблюдатель оставаться неподвижным или перемещаться и обновляться вместе с пользователем. Если значение равно true, фигура наблюдателя с объемом, определенным параметром Экстенты наблюдения , останется в источнике при запуске. Если задано значение false, пространство наблюдателя будет следовать за головой пользователя в качестве источника фигуры.
Данные сетки не будут вычисляться для любой физической области за пределами пространства наблюдателя, как определено следующими свойствами: Является ли стационарный наблюдатель, Фигура наблюдателя* и Экстенты наблюдения.
Фигура наблюдателя
Фигура наблюдателя определяет тип тома, который наблюдатель сетки будет использовать при наблюдении за сетками. Поддерживаемые варианты:
- Выровненный по оси куб — прямоугольная форма, которая остается выровненной по осям мировой системы координат, как определено при запуске приложения.
- Выровненный пользователем куб — прямоугольная фигура, которая вращается в соответствии с локальной системой координат пользователей.
- Sphere — сферический том с центром в мировом космическом источнике. Значение X свойства Экстенты наблюдения будет использоваться в качестве радиуса сферы.
Экстенты наблюдения
Экстенты наблюдения определяют расстояние от точки наблюдения, в которой будут наблюдаться сетки.
Параметры физики
Физический слой
Физический слой, на котором будут размещены объекты пространственной сетки для взаимодействия с системами Unity Physics и RayCast.
Примечание
Смешанная реальность Toolkit по умолчанию резервирует уровень 31 для использования наблюдателями пространственной осведомленности.
Пересчет норм
Указывает, будет ли наблюдатель сетки пересчитывать нормальные значения сетки после наблюдения. Этот параметр доступен для обеспечения того, чтобы приложения получали сетки, содержащие допустимые нормальные данные на платформах, которые не возвращают их с помощью сеток.
Уровень детализации параметров
Уровень детализации
Указывает уровень детализации (LOD) данных пространственной сетки. В настоящее время определены значения Грубое, Точное и Настраиваемое.
Грубое — оказывает меньшее влияние на производительность приложения и является отличным выбором для навигации или поиска в плоскости.
Средний — сбалансированный параметр часто используется для работы, которая постоянно сканирует среду на наличие как больших компонентов, полов и стен, так и деталей загораживания.
Штраф . Как правило, это обеспечивает более высокое влияние на производительность приложения и является отличным вариантом для сеток загораживания.
Настраиваемая . Приложение должно указать свойство Треугольники / Кубический метр и позволяет приложениям настраивать точность и производительность наблюдателя пространственной сетки.
Примечание
Не гарантируется, что все значения треугольников/кубических метров учитываются всеми платформами. При использовании пользовательского LOD настоятельно рекомендуется экспериментировать и профилировать.
Треугольники на кубический метр
Допустимо при использовании настраиваемого параметра для свойства Уровень детализации и указывает плотность треугольника для пространственной сетки.
Параметры отображения
Параметр отображения
Указывает, как пространственные сетки должны отображаться наблюдателем. Поддерживаются значения:
- Нет — наблюдатель не будет отображать сетку
- Visible — данные сетки будут видны с помощью видимого материала
- Окклюзия — данные сетки будут заключить элементы в сцене с помощью материала Окклюзии
Пространственные наблюдатели можно возобновить или приостановить во время выполнения с помощью кода.
Предупреждение
Если параметру отображения присвоено значение Нет , наблюдатель не будет работать. Если вы хотите остановить всех наблюдателей, приложения должны будут приостановить всех наблюдателей через CoreServices.SpatialAwareness.SuspendObservers()
Видимый материал
Указывает материал, используемый при визуализации пространственной сетки.
Материал окклюзии
Указывает материал, используемый для того, чтобы заставить пространственную сетку заключить голограммы.