XrSessionState(bpy_struct)

base class — bpy_struct

class bpy.types.XrSessionState(bpy_struct)

Runtime state information about the VR session

actionmaps
Type

XrActionMaps bpy_prop_collection of XrActionMap, (readonly)

active_actionmap
Type

int in [-inf, inf], default 0

navigation_location

Location offset to apply to base pose when determining viewer location

Type

mathutils.Vector of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)

navigation_rotation

Rotation offset to apply to base pose when determining viewer rotation

Type

mathutils.Quaternion rotation of 4 items in [-inf, inf], default (0.0, 0.0, 0.0, 0.0)

navigation_scale

Additional scale multiplier to apply to base scale when determining viewer scale

Type

float in [-inf, inf], default 0.0

selected_actionmap
Type

int in [-inf, inf], default 0

viewer_pose_location

Last known location of the viewer pose (center between the eyes) in world space

Type

mathutils.Vector of 3 items in [-inf, inf], default (0.0, 0.0, 0.0), (readonly)

viewer_pose_rotation

Last known rotation of the viewer pose (center between the eyes) in world space

Type

mathutils.Quaternion rotation of 4 items in [-inf, inf], default (0.0, 0.0, 0.0, 0.0), (readonly)

classmethod is_running(context)

Query if the VR session is currently running

Returns

Result

Return type

boolean

classmethod reset_to_base_pose(context)

Force resetting of position and rotation deltas

classmethod action_set_create(context, actionmap)

Create a VR action set

Returns

Result

Return type

boolean

classmethod action_create(context, actionmap, actionmap_item)

Create a VR action

Returns

Result

Return type

boolean

classmethod action_binding_create(context, actionmap, actionmap_item, actionmap_binding)

Create a VR action binding

Returns

Result

Return type

boolean

classmethod active_action_set_set(context, action_set)

Set the active VR action set

Parameters

action_set (string, (never None)) – Action Set, Action set name

Returns

Result

Return type

boolean

classmethod controller_pose_actions_set(context, action_set, grip_action, aim_action)

Set the actions that determine the VR controller poses

Parameters

  • action_set (string, (never None)) – Action Set, Action set name

  • grip_action (string, (never None)) – Grip Action, Name of the action representing the controller grips

  • aim_action (string, (never None)) – Aim Action, Name of the action representing the controller aims

Returns

Result

Return type

boolean

classmethod action_state_get(context, action_set_name, action_name, user_path)

Get the current state of a VR action

Parameters

  • action_set_name (string, (never None)) – Action Set, Action set name

  • action_name (string, (never None)) – Action, Action name

  • user_path (string, (never None)) – User Path, OpenXR user path

Returns

Action State, Current state of the VR action. Second float value is only set for 2D vector type actions

Return type

float array of 2 items in [-inf, inf], (never None)

classmethod haptic_action_apply(context, action_set_name, action_name, user_path, duration, frequency, amplitude)

Apply a VR haptic action

Parameters

  • action_set_name (string, (never None)) – Action Set, Action set name

  • action_name (string, (never None)) – Action, Action name

  • user_path (string, (never None)) – User Path, Optional OpenXR user path. If not set, the action will be applied to all paths

  • duration (float in [0, inf]) – Duration, Haptic duration in seconds. 0.0 is the minimum supported duration

  • frequency (float in [0, inf]) – Frequency, Frequency of the haptic vibration in hertz. 0.0 specifies the OpenXR runtime’s default frequency

  • amplitude (float in [0, 1]) – Amplitude, Haptic amplitude, ranging from 0.0 to 1.0

Returns

Result

Return type

boolean

classmethod haptic_action_stop(context, action_set_name, action_name, user_path)

Stop a VR haptic action

Parameters

  • action_set_name (string, (never None)) – Action Set, Action set name

  • action_name (string, (never None)) – Action, Action name

  • user_path (string, (never None)) – User Path, Optional OpenXR user path. If not set, the action will be stopped for all paths

classmethod controller_grip_location_get(context, index)

Get the last known controller grip location in world space

Parameters

index (int in [0, 255]) – Index, Controller index

Returns

Location, Controller grip location

Return type

mathutils.Vector of 3 items in [-inf, inf], (never None)

classmethod controller_grip_rotation_get(context, index)

Get the last known controller grip rotation (quaternion) in world space

Parameters

index (int in [0, 255]) – Index, Controller index

Returns

Rotation, Controller grip quaternion rotation

Return type

mathutils.Quaternion rotation of 4 items in [-inf, inf], (never None)

classmethod controller_aim_location_get(context, index)

Get the last known controller aim location in world space

Parameters

index (int in [0, 255]) – Index, Controller index

Returns

Location, Controller aim location

Return type

mathutils.Vector of 3 items in [-inf, inf], (never None)

classmethod controller_aim_rotation_get(context, index)

Get the last known controller aim rotation (quaternion) in world space

Parameters

index (int in [0, 255]) – Index, Controller index

Returns

Rotation, Controller aim quaternion rotation

Return type

mathutils.Quaternion rotation of 4 items in [-inf, inf], (never None)

classmethod bl_rna_get_subclass(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The RNA type or default when not found.

Return type

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

Inherited Functions

References