Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

OpenXRInteractionProfileMetadata

继承： Object

在 OpenXR 中注册受支持设备的元类。

描述

该类允许 OpenXR 核心和扩展注册与受支持的交互设备（例如控制器、跟踪器、触觉设备等）相关的元数据。它主要由动作映射编辑器使用，并在适用时通过移除依赖于扩展的条目来清理任何动作映射。

方法

void	register_interaction_profile ( String display_name, String openxr_path, String openxr_extension_name )
void	register_io_path ( String interaction_profile, String display_name, String toplevel_path, String openxr_path, String openxr_extension_name, ActionType action_type )
void	register_profile_rename ( String old_name, String new_name )
void	register_top_level_path ( String display_name, String openxr_path, String openxr_extension_name )

---

方法说明

void register_interaction_profile ( String display_name, String openxr_path, String openxr_extension_name )

使用 OpenXR 名称注册交互配置文件（例如 /interaction_profiles/khr/simple_controller 是 OpenXR 简单控制器配置文件的配置文件）。

display_name 是向用户显示的描述。openxr_path 是正被注册的交互配置文件路径。openxr_extension_name 可以选择将该配置文件限制为对给定扩展启用/可用。如果该扩展不可用，则动作映射中使用的配置文件和所有相关条目都会被过滤掉。

---

void register_io_path ( String interaction_profile, String display_name, String toplevel_path, String openxr_path, String openxr_extension_name, ActionType action_type )

为给定的 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_name 将该输入/输出限制为启用的/可用的扩展，这不需要在配置文件上重复该扩展，但与重叠扩展相关（例如引入 …/input/palm_ext/pose 输入路径的 XR_EXT_palm_pose）。action_type 定义 OpenXR 提供的输入或输出的类型。

---

void register_profile_rename ( String old_name, String new_name )

允许将旧的交互配置文件路径重命名为新路径，以保持与旧动作映射的向后兼容性。

---

void register_top_level_path ( String display_name, String openxr_path, String openxr_extension_name )

注册配置文件可以被绑定到的顶级路径。例如 /user/hand/left 指的是玩家左手的绑定点。扩展可以注册额外的顶级路径，例如触觉背心扩展可以注册 /user/body/vest。

display_name 是向用户显示的名称。openxr_path 是正被注册的顶级路径。openxr_extension_name 是可选的，可确保仅在指定的扩展可用/启用时才使用顶级路径。

当顶级路径最终被 OpenXR 绑定时，XRPositionalTracker 被实例化以管理该设备的状态。