SpatialPointerPose Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Input.Spatial
Modifica

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.

Si applica a