SpatialInteractionDetectedEventArgs.TryGetPointerPose Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém as poses de ponteiro disponíveis, como o foco da cabeça do usuário e a pose de ponteiro de cada controlador de movimento, para uso no roteamento dessa interação para um SpatialGestureRecognizer.
public:
virtual SpatialPointerPose ^ TryGetPointerPose(SpatialCoordinateSystem ^ coordinateSystem) = TryGetPointerPose;
SpatialPointerPose TryGetPointerPose(SpatialCoordinateSystem const& coordinateSystem);
public SpatialPointerPose TryGetPointerPose(SpatialCoordinateSystem coordinateSystem);
function tryGetPointerPose(coordinateSystem)
Public Function TryGetPointerPose (coordinateSystem As SpatialCoordinateSystem) As SpatialPointerPose
Parâmetros
- coordinateSystem
- SpatialCoordinateSystem
O sistema de coordenadas no qual o ponteiro é exibido.
Retornos
O ponteiro é posado.
Comentários
Ao direcionar uma interação espacial, como um gesto de mão, pressionamento do controlador de movimento ou interação de voz, os aplicativos devem escolher um raio apontando disponível no SpatialPointerPose da interação, com base na natureza do SpatialInteractionSource da interação:
- Se a origem de interação não der suporte a apontar (IsPointingSupported for false), o aplicativo deverá ser direcionado com base no foco do usuário, disponível por meio da propriedade Head .
- Se a origem da interação oferecer 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 cruzar o raio apontador escolhido com seus próprios hologramas ou com a malha de mapeamento espacial para renderizar cursores e determinar com o que o usuário pretende interagir.
Depois que uma interação é iniciada, movimentos relativos da mão ou do controlador podem ser usados para controlar o gesto, como com o gesto de Manipulação ou Navegação .
Esse método retornará nulo se o sistema de coordenadas especificado não puder ser localizado no momento.