SpatialRecognitionStartedEventArgs.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 do ponteiro de cada controlador de movimento, para uso no direcionamento desse gesto.
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 SpatialPointerPoseParâmetros
- coordinateSystem
- SpatialCoordinateSystem
O sistema de coordenadas no qual o ponteiro é exibido.
Retornos
O ponteiro é posado.
Comentários
Essa pose é do carimbo de data/hora do SpatialInteraction inicial roteado para esse reconhecedor para iniciar o gesto ativo.
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.