SpatialLocator Kelas

Definisi

Ruang nama:

Windows.Perception.Spatial

Menyediakan akses ke lokasi perangkat yang dilacak relatif terhadap lingkungan pengguna, seperti HoloLens atau headset Mixed Reality lainnya.

public ref class SpatialLocator 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 SpatialLocator 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 SpatialLocator

Public NotInheritable Class SpatialLocator

Warisan

Object Platform::Object IInspectable SpatialLocator

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Kelas SpatialLocator mewakili perangkat yang posisi dan orientasinya dapat dilacak oleh Windows relatif terhadap lingkungan pengguna. Instans SpatialLocator adalah sumber untuk bingkai referensi yang terpasang pencari lokasi dan stasioner. Pada headset Mixed Reality seperti HoloLens, bingkai referensi ini dapat digunakan untuk penyajian holografik dan untuk penalaran tentang permukaan di dunia di sekitar perangkat.

Properti

Locatability

Mendapatkan status sistem lokasi spasial perangkat saat ini.

Metode

CreateAttachedFrameOfReferenceAtCurrentHeading()	Membuat bingkai referensi yang dilampirkan secara posisi ke SpatialLocator ini dengan orientasi saat ini sebagai judul tetapnya.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3)	Membuat bingkai referensi yang secara posisional dilampirkan ke SpatialLocator ini dengan orientasi saat ini sebagai judul tetap dan dengan offset asalnya oleh posisi relatif yang ditentukan.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion)	Membuat bingkai referensi yang secara posisional dilampirkan ke SpatialLocator ini dengan orientasi saat ini sebagai judul tetap dan dengan offset asalnya dan diputar oleh posisi dan orientasi relatif yang ditentukan.
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion, Double)	Membuat bingkai referensi yang secara posisional melekat pada SpatialLocator ini dengan judul yang disediakan dalam radian relatif terhadap orientasi saat ini dan dengan offset asalnya oleh posisi relatif dan orientasi yang ditentukan.
CreateStationaryFrameOfReferenceAtCurrentLocation()	Membuat bingkai referensi yang tetap stasioner relatif terhadap lingkungan pengguna, dengan asal awalnya di lokasi SpatialLocator saat ini.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3)	Membuat bingkai referensi yang tetap stasioner relatif terhadap lingkungan pengguna, dengan asal awalnya pada offset yang ditentukan dari lokasi SpatialLocator saat ini.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion)	Membuat bingkai referensi yang tetap stasioner relatif terhadap lingkungan pengguna, dengan asal awalnya pada offset yang ditentukan dari lokasi SpatialLocator saat ini, lalu diputar pada rotasi yang ditentukan.
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion, Double)	Membuat bingkai referensi yang tetap stasioner relatif terhadap lingkungan pengguna, dengan asal awalnya pada offset yang ditentukan dari lokasi SpatialLocator saat ini di sepanjang judul relatif yang ditentukan dalam radian, lalu diputar pada rotasi yang ditentukan.
GetDefault()	Mendapatkan instans SpatialLocator yang melacak lokasi perangkat saat ini, seperti HoloLens, relatif terhadap lingkungan pengguna.
TryLocateAtTimestamp(PerceptionTimestamp, SpatialCoordinateSystem)	Mengembalikan SpatialLocation yang mewakili lokasi perangkat pada tanda waktu yang ditentukan. Koordinat di dalam dinyatakan relatif terhadap sistem koordinat yang disediakan. Jika perangkat tidak dapat ditemukan dalam sistem koordinat tersebut pada tanda waktu yang ditentukan, nilai yang dikembalikan akan null. Ini dapat terjadi ketika perangkat telah kehilangan pelacakan, misalnya.

Acara

LocatabilityChanged	Terjadi ketika status sistem lokasi spasial berubah.
PositionalTrackingDeactivating	Terjadi ketika sistem lokasi spasial perangkat dinonaktifkan karena tidak aktif.

Lihat juga

• Sampel hologram tag-along