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 ( 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 被实例化以管理该设备的状态。