Compartilhar via


SpatialPointerPose Classe

Definição

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

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.

Aplica-se a