Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
OpenXRInteractionProfileMetadata
Наследует: Object
Метакласс, регистрирующий поддерживаемые устройства в OpenXR.
Описание
Этот класс позволяет ядру и расширениям OpenXR регистрировать метаданные, относящиеся к поддерживаемым устройствам взаимодействия, таким как контроллеры, трекеры, тактильные устройства и т. д. Он в основном используется редактором карты действий и для очистки любой карты действий путем удаления записей, зависящих от расширения, когда это применимо.
Методы
void |
register_interaction_profile(display_name: String, openxr_path: String, openxr_extension_names: String) |
void |
register_io_path(interaction_profile: String, display_name: String, toplevel_path: String, openxr_path: String, openxr_extension_names: String, action_type: ActionType) |
void |
register_path_rename(old_name: String, new_name: String) |
void |
register_profile_rename(old_name: String, new_name: String) |
void |
register_top_level_path(display_name: String, openxr_path: String, openxr_extension_names: String) |
Описания метода
void register_interaction_profile(display_name: String, openxr_path: String, openxr_extension_names: String) 🔗
Регистрирует профиль взаимодействия, используя его обозначение OpenXR (например, /interaction_profiles/khr/simple_controller — это профиль для простого контроллера OpenXR).
display_name — это описание, отображаемое пользователю. openxr_path — это путь к регистрируемому профилю взаимодействия. openxr_extension_names при необходимости ограничивает этот профиль только включенным/доступным расширением. Если расширение недоступно, профиль и все связанные с ним записи, используемые в карте действий, отфильтровываются.
void register_io_path(interaction_profile: String, display_name: String, toplevel_path: String, openxr_path: String, openxr_extension_names: String, action_type: ActionType) 🔗
Регистрирует путь ввода/вывода для заданного interaction_profile. Профиль должен быть предварительно зарегистрирован с помощью register_interaction_profile(). display_name — это описание, отображаемое пользователю. toplevel_path указывает путь привязки, к которому может быть привязан этот ввод/вывод (например, /user/hand/left или /user/hand/right). openxr_path — это регистрируемый ввод/вывод действия (например, /user/hand/left/input/aim/pose). openxr_extension_names ограничивает этот ввод/вывод включенным/доступным расширением; при этом не обязательно повторять расширение в профиле, но следует учитывать перекрывающиеся расширения (например, XR_EXT_palm_pose, которое вводит пути ввода …/input/palm_ext/pose). action_type определяет тип ввода или вывода, предоставляемый OpenXR.
void register_path_rename(old_name: String, new_name: String) 🔗
Позволяет переименовывать старые пути ввода/вывода в новые пути для загрузки и обработки старых карт действий.
void register_profile_rename(old_name: String, new_name: String) 🔗
Позволяет переименовывать старые пути к профилям взаимодействия в новые пути для загрузки и обработки старых карт действий.
void register_top_level_path(display_name: String, openxr_path: String, openxr_extension_names: String) 🔗
Регистрирует путь верхнего уровня, к которому могут быть привязаны профили. Например, /user/hand/left обозначает точку привязки для левой руки игрока. Расширения могут регистрировать дополнительные пути верхнего уровня, например, расширение тактильного жилета может зарегистрировать /user/body/vest.
display_name — это имя, отображаемое пользователю. openxr_path — это регистрируемый путь верхнего уровня. openxr_extension_names является необязательным и гарантирует, что путь верхнего уровня будет использоваться только в том случае, если указанное расширение доступно/включено.
Когда путь верхнего уровня будет привязан OpenXR, создается экземпляр XRPositionalTracker для управления состоянием устройства.