SpatialPointerPose Класс

Ссылка

Определение

Пространство имен:: Windows.UI.Input.Spatial

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

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

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

Атрибуты: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

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