SpatialAnchor Kelas

Referensi

Definisi

Ruang nama:: Windows.Perception.Spatial

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.

Edit

Mewakili sistem koordinat yang sangat berlabuh ke titik di sekitar pengguna.

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

Public NotInheritable Class SpatialAnchor

Warisan: Object Platform::Object IInspectable SpatialAnchor

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

Anda dapat membuat SpatialAnchor pada posisi dan orientasi apa pun dalam SpatialCoordinateSystem yang Anda pilih. Perangkat harus dapat menemukan sistem koordinat itu saat ini, dan sistem tidak boleh mencapai batas jangkar spasialnya.

Setelah didefinisikan, sistem koordinat SpatialAnchor terus menyesuaikan untuk mempertahankan posisi dan orientasi yang tepat dari lokasi awalnya. Anda kemudian dapat menggunakan SpatialAnchor ini untuk merender hologram yang akan muncul diperbaiki di lingkungan pengguna di lokasi yang tepat.

Efek penyesuaian yang menjaga jangkar tetap di tempat diperbesar seiring dengan meningkatnya jarak dari jangkar. Anda harus menghindari penyajian konten relatif terhadap jangkar yang lebih dari 3 meter dari asal jangkar tersebut.

Anda dapat mempertahankan SpatialAnchor menggunakan kelas SpatialAnchorStore lalu mendapatkannya kembali di sesi aplikasi mendatang.

Properti CoordinateSystem mendapatkan sistem koordinat yang memungkinkan Anda menempatkan konten relatif terhadap jangkar, dengan kemudahan yang diterapkan saat perangkat menyesuaikan lokasi tepat jangkar.

Gunakan properti RawCoordinateSystem dan peristiwa RawCoordinateSystemAdjusted yang sesuai untuk mengelola penyesuaian ini sendiri.

Sistem koordinat ditangan kanan, dengan +y up, +x ke kanan, dan -z maju.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	RemovedByUser

Properti

CoordinateSystem	Mendapatkan sistem koordinat jangkar, dengan penyesuaian penguraian diterapkan.
RawCoordinateSystem	Mendapatkan sistem koordinat jangkar, tanpa meringankan diterapkan.
RemovedByUser	Mendapatkan nilai yang menunjukkan apakah jangkar yang bertahan dihapus oleh pengguna.

Metode

TryCreateRelativeTo(SpatialCoordinateSystem)

Membuat jangkar di asal sistem koordinat yang ditentukan.

TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)

Membuat jangkar pada posisi tertentu dalam sistem koordinat yang ditentukan.

TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)

Membuat jangkar pada posisi dan orientasi tertentu dalam sistem koordinat yang ditentukan.

Ini dapat mengembalikan null jika sistem telah mencapai batasnya pada jangkar spasial. Ini juga dapat mengembalikan null jika sistem koordinat yang ditentukan tidak dapat ditemukan bingkai ini.

Acara

RawCoordinateSystemAdjusted

Terjadi ketika perangkat menyesuaikan lokasi tepat jangkar, yang memperbarui RawCoordinateSystem.

Berlaku untuk

Bagikan melalui