Up to date

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

OpenXRActionMap

Inherits: Resource < RefCounted < Object

Collection of OpenXRActionSet and OpenXRInteractionProfile resources for the OpenXR module.

Description

OpenXR uses an action system similar to Godots Input map system to bind inputs and outputs on various types of XR controllers to named actions. OpenXR specifies more detail on these inputs and outputs than Godot supports.

Another important distinction is that OpenXR offers no control over these bindings. The bindings we register are suggestions, it is up to the XR runtime to offer users the ability to change these bindings. This allows the XR runtime to fill in the gaps if new hardware becomes available.

The action map therefore needs to be loaded at startup and can’t be changed afterwards. This resource is a container for the entire action map.

Properties

Methods

Property Descriptions

Array action_sets = []

• void set_action_sets ( Array value )

• Array get_action_sets ( )

Collection of OpenXRActionSets that are part of this action map.

Array interaction_profiles = []

• void set_interaction_profiles ( Array value )

• Array get_interaction_profiles ( )

Collection of OpenXRInteractionProfiles that are part of this action map.

Method Descriptions

void add_action_set ( OpenXRActionSet action_set )

Add an action set.

void add_interaction_profile ( OpenXRInteractionProfile interaction_profile )

Add an interaction profile.

void create_default_action_sets ( )

Setup this action set with our default actions.

OpenXRActionSet find_action_set ( String name ) const

Retrieve an action set by name.

OpenXRInteractionProfile find_interaction_profile ( String name ) const

Find an interaction profile by its name (path).

OpenXRActionSet get_action_set ( int idx ) const

Retrieve the action set at this index.

int get_action_set_count ( ) const

Retrieve the number of actions sets in our action map.

OpenXRInteractionProfile get_interaction_profile ( int idx ) const

Get the interaction profile at this index.

int get_interaction_profile_count ( ) const

Retrieve the number of interaction profiles in our action map.

void remove_action_set ( OpenXRActionSet action_set )

Remove an action set.

void remove_interaction_profile ( OpenXRInteractionProfile interaction_profile )

Remove an interaction profile.