SpatialPointerPose Classe

Definição

Namespace:

Windows.UI.Input.Spatial

Representa as poses de ponteiro espacial disponíveis, como o foco da cabeça do usuário, o olhar e a pose do ponteiro de cada controlador de movimento, para uso em gestos de direcionamento da mão, pressionamentos do controlador de movimento e interações de fala.

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

Herança

Object Platform::Object IInspectable SpatialPointerPose

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v2.0)

Comentários

O SpatialPointerPose fornece o conjunto de raios apontadores disponíveis no momento representado pela propriedade Timestamp .

Ao direcionar uma interação espacial, como um gesto de mão, pressionamento do controlador de movimento ou interação de fala, os aplicativos devem escolher um raio apontador disponível no SpatialPointerPose da interação, com base na natureza de SpatialInteractionSource da interação:

• Se a fonte de interação não der suporte a apontar (IsPointingSupported for false), o aplicativo deverá ser direcionado com base no foco da cabeça do usuário, disponível por meio da propriedade Head .
• Se a fonte de interação der suporte a apontar (IsPointingSupported for true), o aplicativo poderá, em vez disso, ser direcionado com base na pose do ponteiro da origem, disponível por meio do método TryGetInteractionSourcePose .

Em seguida, o aplicativo deve interseccionar o raio apontador escolhido com seus próprios hologramas ou com a malha de mapeamento espacial para renderizar cursores e determinar com que o usuário pretende interagir.

Depois que uma interação for iniciada, os movimentos relativos da mão ou do controlador poderão ser usados para controlar o gesto, como com o gesto de Manipulação ou Navegação .

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1703	15063	TryGetInteractionSourcePose
1903	18362	Olhos
1903	18362	IsHeadCapturedBySystem

Propriedades

Eyes	Obtém o olhar do usuário para este carimbo de data/hora.
Head	Obtém o foco da cabeça do usuário para este carimbo de data/hora.
IsHeadCapturedBySystem	Obtém se o foco da cabeça do usuário está sendo capturado pela interface do usuário do sistema no momento (impedindo que pressionamentos controlados por foco sejam entregues à exibição associada a este SpatialPointerPose).
Timestamp	Obtém o carimbo de data/hora quando os raios apontados são determinados.

Métodos

TryGetAtTimestamp(SpatialCoordinateSystem, PerceptionTimestamp)	Obtém o foco da cabeça e as poses do ponteiro do controlador de movimento para o carimbo de data/hora especificado.
TryGetInteractionSourcePose(SpatialInteractionSource)	Obtém a pose do ponteiro para uma fonte de interação espacial específica, como um controlador de movimento, em um determinado carimbo de data/hora.