SpatialStageFrameOfReference Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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 SpatialStageFrameOfReferencePublic NotInheritable Class SpatialStageFrameOfReference- Warisan
- Atribut
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. |