SpatialPointerPose Classe
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Attributs
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)
|
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 .
Version de Windows | Version du SDK | Valeur ajoutée |
---|---|---|
1703 | 15063 | TryGetInteractionSourcePose |
1903 | 18362 | Yeux |
1903 | 18362 | IsHeadCapturedBySystem |
Eyes |
Obtient le regard de l’utilisateur pour cet horodatage. |
Head |
Obtient le regard de la tête de l’utilisateur pour cet horodatage. |
Is |
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. |
Try |
Obtient le pointeur du pointeur du regard de la tête et du contrôleur de mouvement pour l’horodatage spécifié. |
Try |
Obtient la pose de pointeur pour une source d’interaction spatiale particulière, telle qu’un contrôleur de mouvement, à un horodatage donné. |
Produit | Versions |
---|---|
WinRT | Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |