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.

OpenXRInteractionProfileMetadata

Eredita: Object

Meta-classe che registra i dispositivi supportati in OpenXR.

Descrizione

Questa classe consente alla base e alle estensioni OpenXR di registrare metadati relativi ai dispositivi di interazione supportati, quali controller, tracciatori, dispositivi tattili, ecc. È utilizzata principalmente dall'editor delle mappe di azioni e per ripulire qualsiasi mappa di azioni, rimuovendo le voci dipendenti dall'estensione, dove applicabile.

Metodi

void

register_interaction_profile(display_name: String, openxr_path: String, openxr_extension_names: String)

void

register_io_path(interaction_profile: String, display_name: String, toplevel_path: String, openxr_path: String, openxr_extension_names: String, action_type: ActionType)

void

register_path_rename(old_name: String, new_name: String)

void

register_profile_rename(old_name: String, new_name: String)

void

register_top_level_path(display_name: String, openxr_path: String, openxr_extension_names: String)


Descrizioni dei metodi

void register_interaction_profile(display_name: String, openxr_path: String, openxr_extension_names: String) 🔗

Registra un profilo di interazione utilizzando la sua designazione OpenXR (ad esempio /interaction_profiles/khr/simple_controller è il profilo per il profilo del controller semplice di OpenXR).

display_name è la descrizione visualizzata all'utente. openxr_path è il percorso del profilo di interazione che viene registrato. openxr_extension_names limita facoltativamente questo profilo all'estensione specificata che è abilitata/disponibile. Se l'estensione non è disponibile, il profilo e tutte le voci correlate utilizzate in una mappa di azioni sono filtrate.


void register_io_path(interaction_profile: String, display_name: String, toplevel_path: String, openxr_path: String, openxr_extension_names: String, action_type: ActionType) 🔗

Registra un percorso di input/output per il profilo di interazione interaction_profile. Il profilo dovrebbe essere stato registrato in precedenza tramite register_interaction_profile(). display_name è la descrizione mostrata all'utente. toplevel_path specifica il percorso di associazione a cui questo input/output può essere associato (ad esempio /user/hand/left o /user/hand/right). openxr_path è l'input/output dell'azione che è registrata (ad esempio /user/hand/left/input/aim/pose). openxr_extension_names limita questo input/output a un'estensione abilitata/disponibile, non è necessario che ripeta l'estensione sul profilo, ma si riferisce all'estensione sovrapposta (ad esempio XR_EXT_palm_pose che introduce i percorsi di input …/input/palm_ext/pose). action_type definisce il tipo di input o output fornito da OpenXR.


void register_path_rename(old_name: String, new_name: String) 🔗

Consente di rinominare i vecchi percorsi di input/output in nuovi percorsi, al fine di caricare e elaborare le vecchie mappe di azione.


void register_profile_rename(old_name: String, new_name: String) 🔗

Consente di rinominare i vecchi percorsi dei profili di interazione in nuovi percorsi, al fine di caricare ed elaborare le vecchie mappe di azione.


void register_top_level_path(display_name: String, openxr_path: String, openxr_extension_names: String) 🔗

Registra un percorso di livello superiore a cui è possibile associare i profili. Ad esempio, /user/hand/left si riferisce al punto di associazione per la mano sinistra del giocatore. Le estensioni possono registrare ulteriori percorsi di livello superiore, ad esempio un'estensione di giubbotto tattile potrebbe registrare /user/body/vest.

display_name è il nome visualizzato all'utente. openxr_path è il percorso di livello superiore che viene registrato. openxr_extension_names è facoltativo e assicura che il percorso di livello superiore sia utilizzato solo se l'estensione specificata è disponibile/abilitata.

Quando un percorso di livello superiore viene associato da OpenXR, un XRPositionalTracker viene istanziato per gestire lo stato del dispositivo.