SpatialPointerPose Classe

Definizione

Spazio dei nomi:

Windows.UI.Input.Spatial

Rappresenta la posizione del puntatore spaziale disponibile, ad esempio lo sguardo della testa dell'utente, lo sguardo oculare e la posa del puntatore di ogni controller di movimento, per l'uso in movimenti di destinazione, pressione del controller di movimento e interazioni vocali.

public ref class SpatialPointerPose sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialPointerPose final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialPointerPose

Public NotInheritable Class SpatialPointerPose

Ereditarietà

Object Platform::Object IInspectable SpatialPointerPose

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v2.0)

Commenti

SpatialPointerPose fornisce il set di raggi puntatori disponibili al momento rappresentato dalla proprietà Timestamp.

Quando si punta a un'interazione spaziale, ad esempio un gesto di mano, la pressione del controller di movimento o l'interazione vocale, le app devono scegliere un raggio di puntamento disponibile da SpatialPointerPose dell'interazione, in base alla natura dell'interazione SpatialInteractionSource:

• Se l'origine di interazione non supporta il punto (IsPointingSupported è false), l'app deve essere destinazione in base allo sguardo head dell'utente, disponibile tramite la proprietà Head .
• Se l'origine di interazione supporta il puntatore (IsPointingSupported è true), l'app può invece essere destinazione in base alla posizione del puntatore dell'origine, disponibile tramite il metodo TryGetInteractionSourcePose .

L'app deve quindi intersecare il raggio di puntamento scelto con i propri ologrammi o con la mesh di mapping spaziale per eseguire il rendering dei cursori e determinare con quale utente intende interagire.

Dopo l'avvio di un'interazione, i movimenti relativi della mano o del controller possono essere usati per controllare il movimento, come con il movimento Di manipolazione o navigazione.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1703	15063	TryGetInteractionSourcePose
1903	18362	Occhi
1903	18362	IsHeadCapturedBySystem

Proprietà

Eyes	Ottiene lo sguardo dell'utente per questo timestamp.
Head	Ottiene lo sguardo della testa dell'utente per questo timestamp.
IsHeadCapturedBySystem	Ottiene se lo sguardo della testa dell'utente viene acquisito dall'interfaccia utente del sistema al momento (impedendo che le presse guidate dallo sguardo vengano recapitate alla visualizzazione associata a questo SpatialPointerPose).
Timestamp	Ottiene il timestamp quando vengono determinati i raggi di puntamento.

Metodi

TryGetAtTimestamp(SpatialCoordinateSystem, PerceptionTimestamp)	Ottiene lo sguardo della testa e il puntatore del controller di movimento per il timestamp specificato.
TryGetInteractionSourcePose(SpatialInteractionSource)	Ottiene la posizione del puntatore per una determinata origine di interazione spaziale, ad esempio un controller di movimento, in un determinato timestamp.