Перед началом работы
Средство World Locking Tools для Unity предлагают очень мощный API для точного контроля над предоставляемыми сервисами. На первый взгляд он может показаться довольно сложным.
Может возникнуть закономерный вопрос — сколько кода нужно написать для использования WLT?
Ответ, который, возможно, вас удивит, — "нисколько".
WLT было тщательно структурировано, для большинства случаев использования достаточно было работать в простом интерфейсе с использованием перетаскивания. Достаточно некоторых небольших изменений в сцене, как описано здесь, — и ваше приложение привязано к миру без использования привязок.
Настройка поведения с помощью кода
Существует небольшое количество случаев, когда может потребоваться дополнительное программирование с использованием API WLT.
Во первых, может потребоваться настроить взаимодействие с клиентами, особенно в нестандартных ситуациях, например в случае потери отслеживания. Это специальное поведение описано в разделе Обработка исключительных условий.
Во вторых, может потребоваться настроить WLT во время выполнения. Любая конфигурация WLT, которую можно выполнить в Unity Inspector, может выполняться с помощью вызовов сценариев. Аналогичным образом, любой объект или компонент WLT, который можно добавить в сцену и развернуть во время сборки, может быть добавлен в сцену в среде выполнения из сценария.
В последнем случае требуются дополнительные входные данные из приложения для выполнения ее функции. Например, чтобы согласовать систему координат с объектами физического мира нужным образом, необходимо указать, как должна быть согласована система координат. Эти дополнительные входные данные поступают в виде пар положений в виртуальном пространстве и пространстве отслеживания.
Быстрое начало работы
WLT стремится поддерживать этот шаблон все время. Для получения наиболее часто требуемой функциональности не требуется писать код и достаточно минимальной настройки. Поведение по умолчанию реализуется в виде доступных компонентов. Для настройки поведения по умолчанию требуется только кода для переопределения указанного поведения нужным поведением. Для дополнительных функций достаточно лишь взаимодействия с приложением, чтобы указать ваши намерения.
Для WLT предусмотрено много функций API. Это позволяет развивать приложение в будущем, поэтому WLT никогда вас не ограничивает. Но начать лучше с простого. Может оказаться, что WLT делает все необходимое без какого-либо дополнительного кода.
Сначала изучите эту документацию об основных понятиях. В соответствующих местах вы найдете ссылки на документацию по API, как ссылку на точный синтаксис вызова. Ниже приведены прямые ссылки на общую документацию по API.