SpatialAnchor Classe

Definizione

Spazio dei nomi:

Windows.Perception.Spatial

Rappresenta un sistema di coordinate fortemente ancorato a un punto nell'ambiente dell'utente.

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

Ereditarietà

Object Platform::Object IInspectable SpatialAnchor

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v2.0)

Commenti

È possibile creare un oggetto SpatialAnchor in qualsiasi posizione e orientamento all'interno di SpatialCoordinateSystem della scelta. Il dispositivo deve essere in grado di individuare il sistema di coordinate al momento e il sistema non deve aver raggiunto il limite di ancoraggi spaziali.

Una volta definito, il sistema di coordinate di un oggetto SpatialAnchor regola continuamente per mantenere la posizione e l'orientamento precisi della sua posizione iniziale. È quindi possibile usare questo oggetto SpatialAnchor per eseguire il rendering di ologrammi che verranno visualizzati fissi nell'ambiente dell'utente in tale posizione esatta.

Gli effetti delle regolazioni che mantengono l'ancoraggio sul posto vengono ingrandimentati come distanza dall'ancoraggio aumenta. È consigliabile evitare di eseguire il rendering del contenuto rispetto a un ancoraggio superiore a 3 metri dall'origine dell'ancoraggio.

È possibile rendere persistente un oggetto SpatialAnchor usando la classe SpatialAnchorStore e quindi tornare in una sessione di app futura.

La proprietà CoordinateSystem ottiene un sistema di coordinate che consente di posizionare il contenuto relativo all'ancoraggio, con l'attenuazione applicata quando il dispositivo regola la posizione precisa dell'ancoraggio.

Utilizzare la proprietà RawCoordinateSystem e l'evento RawCoordinateSystemAdjusted corrispondente per gestire manualmente queste modifiche.

Il sistema di coordinate è destro, con +y su, +x a destra e -z avanti.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	RemovedByUser

Proprietà

CoordinateSystem	Ottiene il sistema di coordinate dell'ancoraggio, con regolazioni di riduzione applicate.
RawCoordinateSystem	Ottiene il sistema di coordinate dell'ancoraggio, senza semplificare l'applicazione.
RemovedByUser	Ottiene un valore che indica se l'ancoraggio persistente è stato rimosso dall'utente.

Metodi

TryCreateRelativeTo(SpatialCoordinateSystem)	Crea un ancoraggio all'origine del sistema di coordinate specificato.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)	Crea un ancoraggio in una posizione specifica all'interno del sistema di coordinate specificato.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)	Crea un ancoraggio in una posizione e un orientamento specifici all'interno del sistema di coordinate specificato. Questo può restituire null se il sistema ha raggiunto il limite sugli ancoraggi spaziali. Può anche restituire null se il sistema di coordinate specificato non può trovarsi in questo frame.

Eventi

RawCoordinateSystemAdjusted

Si verifica quando il dispositivo regola la posizione precisa dell'ancoraggio, che aggiorna RawCoordinateSystem.