Bagikan melalui

SpatialStageFrameOfReference Kelas

  • Referensi

Definisi

Ruang nama:
Windows.Perception.Spatial
Edit

Mewakili tahap spasial, yang didefinisikan oleh pengguna untuk membangun ruang fisik tempat mereka berniat menggunakan headset Mixed Reality.

public ref class SpatialStageFrameOfReference sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialStageFrameOfReference final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialStageFrameOfReference
Public NotInheritable Class SpatialStageFrameOfReference
Warisan
Object Platform::Object IInspectable SpatialStageFrameOfReference
Atribut
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 Creators Update (diperkenalkan dalam 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v4.0)

Keterangan

Tahap spasial terdiri minimal dari sistem koordinat tingkat lantai yang asalnya dipilih oleh pengguna, mewakili pusat logis area tempat mereka berniat menggunakan headset Mixed Reality mereka. Sistem koordinat tingkat lantai ini memungkinkan aplikasi menyajikan pengalaman skala siaga.

Secara opsional, pengguna juga dapat menentukan batas pergerakan, mewakili area terbuka tempat mereka berniat berjalan saat menggunakan headset. Batas pergerakan ini memungkinkan aplikasi untuk menyajikan pengalaman skala ruangan.

Jika pengguna belum menentukan tahap spasial, aplikasi dapat memanggil metode RequestNewStageAsync untuk memandu pengguna melalui UI sistem yang akan memungkinkan mereka menentukannya.

Di HoloLens, aplikasi juga dapat membangun pengalaman skala siaga atau skala ruangan menggunakan pemetaan spasial. Pemetaan spasial memungkinkan pengembang menganalisis lingkungan sekitar pengguna dan menentukan lokasi dinding dan lantai pengguna menggunakan jenis SpatialSurfaceObserver , bahkan jika pengguna belum menentukan tahap secara manual. Periksa properti SpatialSurfaceObserver.IsSupported untuk menentukan apakah perangkat saat ini mendukung pemetaan spasial.

Sistem koordinat yang dikembalikan oleh tahap ditangani dengan tangan kanan, dengan +y up, +x ke kanan, dan -z maju.

Properti

CoordinateSystem

Mendapatkan sistem koordinat tingkat lantai yang terletak di tahap asal yang ditentukan oleh pengguna.
Current

Mendapatkan tahap spasial saat ini, jika tahap spasial telah ditentukan oleh pengguna.
LookDirectionRange

Mendapatkan sejauh mana pengguna dapat melihat-lihat dengan headset mereka.
MovementRange

Mendapatkan sejauh mana pengguna dapat bergerak saat mengenakan headset mereka.

Metode

GetCoordinateSystemAtCurrentLocation(SpatialLocator)

Mendapatkan sistem koordinat tingkat lantai pada posisi dan orientasi pengguna saat ini.
RequestNewStageAsync()

Menampilkan UI sistem untuk memandu pengguna dalam menentukan tahap baru untuk menggantikan tahap saat ini.
TryGetMovementBounds(SpatialCoordinateSystem)

Mendapatkan simpul batas area terbuka yang ditentukan oleh pengguna tempat mereka berniat untuk bergerak saat menggunakan headset mereka.

Acara

CurrentChanged

Terjadi ketika pengguna mengubah atau mendefinisikan ulang tahap spasial saat ini.

Berlaku untuk

Lihat juga