Поделиться через


SpatialPointerPose Класс

Определение

Представляет доступные пространственные положения указателя, такие как взгляд головы пользователя, взгляд глаза и положение указателя каждого контроллера движения, для использования в нацеливание жестов рук, нажатий контроллера движения и речевых взаимодействий.

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
Наследование
Object Platform::Object IInspectable SpatialPointerPose
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (появилось в v2.0)

Комментарии

SpatialPointerPose предоставляет набор указывающих лучей, доступных во время, представленное свойством Timestamp.

При нацеливание на пространственное взаимодействие, например жест руки, нажатие контроллера движения или речевое взаимодействие, приложения должны выбирать указывающий луч, доступный из SpatialPointerPose взаимодействия, в зависимости от характера SpatialInteractionSource взаимодействия:

  • Если источник взаимодействия не поддерживает указатель (IsPointingSupported имеет значение false), приложение должно ориентироваться на основе взгляда головы пользователя, доступного через свойство Head .
  • Если источник взаимодействия поддерживает указатель (IsPointingSupported имеет значение true), приложение может вместо этого выбрать целевой объект на основе положения указателя источника, доступного с помощью метода TryGetInteractionSourcePose .

Затем приложение должно пересекать выбранный указывающий луч с собственными голограммами или сеткой пространственного сопоставления для отрисовки курсоров и определения того, с чем пользователь намерен взаимодействовать.

После начала взаимодействия для управления жестом можно использовать относительные движения руки или контроллера, как в случае с жестом "Манипуляция " или "Навигация ".

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
1703 15063 TryGetInteractionSourcePose
1903 18362 Глаза
1903 18362 IsHeadCapturedBySystem

Свойства

Eyes

Возвращает взгляд пользователя для этой метки времени.

Head

Возвращает взгляд головы пользователя для этой метки времени.

IsHeadCapturedBySystem

Возвращает значение, указывающее, фиксируется ли взгляд пользователя с помощью пользовательского интерфейса системы в данный момент (предотвращает доставку нажатий, управляемых взглядом, в представление, связанное с этим SpatialPointerPose).

Timestamp

Возвращает метку времени при определении указывающих лучей.

Методы

TryGetAtTimestamp(SpatialCoordinateSystem, PerceptionTimestamp)

Возвращает позицию указателя на головной взгляд и контроллер движения для указанной метки времени.

TryGetInteractionSourcePose(SpatialInteractionSource)

Возвращает положение указателя для определенного источника пространственного взаимодействия, например контроллера движения, в заданной метке времени.

Применяется к