Bagikan melalui


SpatialPointerPose Kelas

Definisi

Mewakili pose penunjuk spasial yang tersedia, seperti tatapan kepala pengguna, tatapan mata dan pose pointer setiap pengontrol gerakan, untuk digunakan dalam menargetkan gerakan tangan, menekan pengontrol gerakan, dan interaksi ucapan.

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
Warisan
Object Platform::Object IInspectable SpatialPointerPose
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v2.0)

Keterangan

SpatialPointerPose menyediakan serangkaian sinar penunjuk yang tersedia pada saat yang diwakili oleh properti Tanda Waktu.

Saat menargetkan interaksi spasial, seperti gerakan tangan, pers pengontrol gerakan atau interaksi ucapan, aplikasi harus memilih sinar penunjuk yang tersedia dari SpatialPointerPose interaksi, berdasarkan sifat SpatialInteractionSource interaksi:

  • Jika sumber interaksi tidak mendukung penunjukkan (IsPointingSupported salah), aplikasi harus menargetkan berdasarkan tatapan kepala pengguna, tersedia melalui properti Head .
  • Jika sumber interaksi mendukung penunjuk (IsPointingSupported benar), aplikasi dapat menargetkan berdasarkan pose pointer sumber, tersedia melalui metode TryGetInteractionSourcePose .

Aplikasi kemudian harus berpotongan dengan sinar penunjuk yang dipilih dengan hologramnya sendiri atau dengan jala pemetaan spasial untuk merender kursor dan menentukan apa yang ingin berinteraksi dengan pengguna.

Setelah interaksi dimulai, gerakan relatif tangan atau pengontrol dapat digunakan untuk mengontrol gerakan, seperti halnya gerakan Manipulasi atau Navigasi .

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1703 15063 TryGetInteractionSourcePose
1903 18362 Mata
1903 18362 IsHeadCapturedBySystem

Properti

Eyes

Mendapatkan tatapan mata pengguna untuk tanda waktu ini.

Head

Mendapatkan tatap kepala pengguna untuk tanda waktu ini.

IsHeadCapturedBySystem

Mendapatkan apakah tatapan kepala pengguna sedang ditangkap oleh UI sistem saat ini (mencegah penekanan berbasis tatapan dikirimkan ke tampilan yang terkait dengan SpatialPointerPose ini).

Timestamp

Mendapatkan tanda waktu ketika sinar penunjuk ditentukan.

Metode

TryGetAtTimestamp(SpatialCoordinateSystem, PerceptionTimestamp)

Mendapatkan tatap kepala dan penunjuk pengontrol gerakan berpose untuk tanda waktu yang ditentukan.

TryGetInteractionSourcePose(SpatialInteractionSource)

Mendapatkan pose pointer untuk sumber interaksi spasial tertentu, seperti pengontrol gerakan, pada tanda waktu tertentu.

Berlaku untuk