SpatialAnchor Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Perception.Spatial
Modifica

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.

Si applica a