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
- Наследование
- Атрибуты
Требования к 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) |
Возвращает положение указателя для определенного источника пространственного взаимодействия, например контроллера движения, в заданной метке времени. |