Partager via


SpatialPointerPose Classe

Définition

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

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é.

S’applique à