SpatialPointerPose Classe

Définition

Espace de noms:

Windows.UI.Input.Spatial

Représente les poses de pointeur spatiales disponibles, telles que le regard de la tête de l’utilisateur, le regard et la pose de pointeur de chaque contrôleur de mouvement, à utiliser pour cibler les mouvements de la main, les pressions du contrôleur de mouvement et les interactions vocales.

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

Héritage

Object Platform::Object IInspectable SpatialPointerPose

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v2.0)

Remarques

SpatialPointerPose fournit l’ensemble des rayons de pointage disponibles à l’heure représentée par la propriété Timestamp.

Lors du ciblage d’une interaction spatiale, telle qu’un mouvement de la main, l’appui du contrôleur de mouvement ou l’interaction vocale, les applications doivent choisir un rayon de pointage disponible à partir du SpatialPointerPose de l’interaction, en fonction de la nature du SpatialInteractionSource de l’interaction :

• Si la source d’interaction ne prend pas en charge le pointage (IsPointingSupported a la valeur false), l’application doit cibler en fonction du regard de la tête de l’utilisateur, disponible via la propriété Head .
• Si la source d’interaction prend en charge le pointage (IsPointingSupported a la valeur true), l’application peut plutôt cibler en fonction de la pose de pointeur de la source, disponible via la méthode TryGetInteractionSourcePose .

L’application doit ensuite croiser le rayon de pointage choisi avec ses propres hologrammes ou avec le maillage de mappage spatial pour afficher les curseurs et déterminer avec quoi l’utilisateur a l’intention d’interagir.

Une fois l’interaction démarrée, les mouvements relatifs de la main ou du contrôleur peuvent être utilisés pour contrôler le mouvement, comme avec le mouvement Manipulation ou Navigation .

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1703	15063	TryGetInteractionSourcePose
1903	18362	Yeux
1903	18362	IsHeadCapturedBySystem

Propriétés

Eyes	Obtient le regard de l’utilisateur pour cet horodatage.
Head	Obtient le regard de la tête de l’utilisateur pour cet horodatage.
IsHeadCapturedBySystem	Obtient si le regard de la tête de l’utilisateur est capturé par l’interface utilisateur système en ce moment (empêchant les pressions pilotées par le regard d’être remises à la vue associée à ce SpatialPointerPose).
Timestamp	Obtient l’horodatage lorsque les rayons pointants sont déterminés.

Méthodes

TryGetAtTimestamp(SpatialCoordinateSystem, PerceptionTimestamp)	Obtient le pointeur du pointeur du regard de la tête et du contrôleur de mouvement pour l’horodatage spécifié.
TryGetInteractionSourcePose(SpatialInteractionSource)	Obtient la pose de pointeur pour une source d’interaction spatiale particulière, telle qu’un contrôleur de mouvement, à un horodatage donné.