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.

OpenXRFutureExtension

Eredita: OpenXRExtensionWrapper < Object

L'estensione OpenXR Future consente l'utilizzo di API asincrone.

Descrizione

Questa è un'estensione di supporto in OpenXR che consente ad altre estensioni OpenXR di avviare funzioni asincrone e di ottenere un callback al termine di tali funzioni. Non è pensata per l'utilizzo in GDScript, ma è accessibile da GDExtension.

Metodi

void

cancel_future(future: int)

bool

is_active() const

OpenXRFutureResult

register_future(future: int, on_success: Callable = Callable())


Descrizioni dei metodi

void cancel_future(future: int) 🔗

Annulla un futuro in corso. future deve essere un valore XrFutureEXT restituito in precedenza da un'API che ha avviato una funzione asincrona.


bool is_active() const 🔗

Restituisce true se i future sono disponibili nel runtime OpenXR utilizzato. Questa funzione restituirà un risultato utilizzabile solo dopo l'inizializzazione di OpenXR.


OpenXRFutureResult register_future(future: int, on_success: Callable = Callable()) 🔗

Registra un oggetto OpenXR Future in modo da monitorarne il completamento. future deve essere un valore XrFutureEXT precedentemente restituito da un'API che ha avviato una funzione asincrona.

Facoltativamente, è possibile specificare on_success, il quale sarà invocato al completamento corretto del futuro.

In alternativa, è possibile usare l'oggetto OpenXRFutureResult restituito per attendere (await) il suo segnale OpenXRFutureResult.completed.

var future_result = OpenXRFutureExtension.register_future(future)
await future_result.completed
if future_result.get_status() == OpenXRFutureResult.RESULT_FINISHED:
    # Gestisci il tuo successo
    pass