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.

XRNode3D

Hérite de : Node3D < Node < Object

Hérité par : XRAnchor3D, XRController3D

Un nœud 3D qui a sa position automatiquement mise à jour par le XRServer.

Description

Ce nœud peut être lié à une pose spécifique d'un XRPositionalTracker et aura automatiquement sa transformation Node3D.transform mise à jour par le XRServer. Les nœuds de ce type doivent être ajoutés comme enfants du nœud XROrigin3D.

Tutoriels

Propriétés

PhysicsInterpolationMode

physics_interpolation_mode

2 (overrides Node)

StringName

pose

&"default"

bool

show_when_tracked

false

StringName

tracker

&""

Méthodes

bool

get_has_tracking_data() const

bool

get_is_active() const

XRPose

get_pose()

void

trigger_haptic_pulse(action_name: String, frequency: float, amplitude: float, duration_sec: float, delay_sec: float)


Signaux

tracking_changed(tracking: bool) 🔗

Émis lorsque le tracker commence ou arrête de recevoir des données de suivi à jour pour la pose suivie. L'argument tracking indique si le tracker obtient des données de suivi à jour.


Descriptions des propriétés

StringName pose = &"default" 🔗

Le nom de la pose à laquelle nous sommes liés. Quelle pose un tracker supporte n'est pas connu au moment du design.

Godot définit de nombreux noms de pose standard tels que aim et grip, mais d'autres peuvent être configurés dans une XRInterface donnée.


bool show_when_tracked = false 🔗

  • void set_show_when_tracked(value: bool)

  • bool get_show_when_tracked()

Active l'affichage du nœud quand le suivi commence, et cache le nœud quand le suivi est perdu.


StringName tracker = &"" 🔗

Le nom du tracker auquel nous sommes liés. Quels trackers sont disponibles n'est pas connu lors de la conception.

Godot définit un certain nombre de trackers standards tels que left_hand et right_hand, mais d'autres peuvent être configurés dans une XRInterface donnée.


Descriptions des méthodes

bool get_has_tracking_data() const 🔗

Renvoie true si le tracker dispose de données de suivi actuelles pour la pose suivie.


bool get_is_active() const 🔗

Renvoie true si le tracker a été enregistré et que la pose est suivie.


XRPose get_pose() 🔗

Renvoie la XRPose contenant l'état actuel de la pose en cours de suivi. Cela donne accès à des propriétés supplémentaires de cette pose.


void trigger_haptic_pulse(action_name: String, frequency: float, amplitude: float, duration_sec: float, delay_sec: float) 🔗

Déclenche une impulsion haptique sur un appareil associé à cette interface.

action_name est le nom de l'action pour cette impulsion.

frequency est la fréquence de l'impulsion, définie à 0.0 pour que le système utilise une fréquence par défaut.

amplitude est l'amplitude de l'impulsion entre 0.0 et 1.0.

duration_sec est la durée de l'impulsion en secondes.

delay_sec est un délai en secondes avant que l'impulsion ne soit donnée.