SpatialAnchor Clase

Definición

Espacio de nombres:

Windows.Perception.Spatial

Representa un sistema de coordenadas que está fuertemente anclado a un punto del entorno del usuario.

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

Herencia

Object Platform::Object IInspectable SpatialAnchor

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v2.0)

Comentarios

Puede crear un SpatialAnchor en cualquier posición y orientación dentro de SpatialCoordinateSystem de su elección. El dispositivo debe poder localizar ese sistema de coordenadas en este momento y el sistema no debe haber alcanzado su límite de anclajes espaciales.

Una vez definido, el sistema de coordenadas de spatialAnchor se ajusta continuamente para conservar la posición y la orientación precisas de su ubicación inicial. Después, puede usar este SpatialAnchor para representar hologramas que aparecerán fijos en el entorno del usuario en esa ubicación exacta.

Los efectos de los ajustes que mantienen el anclaje en su lugar se magnifican a medida que aumenta la distancia desde el anclaje. Debe evitar la representación de contenido en relación con un delimitador que sea superior a 3 metros del origen de ese delimitador.

Puede conservar un SpatialAnchor mediante la clase SpatialAnchorStore y, a continuación, recuperarlo en una sesión de aplicación futura.

La propiedad CoordinateSystem obtiene un sistema de coordenadas que permite colocar el contenido en relación con el delimitador, con aceleración aplicada cuando el dispositivo ajusta la ubicación precisa del delimitador.

Use la propiedad RawCoordinateSystem y el evento RawCoordinateSystemAdjusted correspondiente para administrar estos ajustes usted mismo.

El sistema de coordenadas está a la derecha, con +y arriba, +x a la derecha y -z hacia delante.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	RemovedByUser

Propiedades

CoordinateSystem	Obtiene el sistema de coordenadas del delimitador, con ajustes de aceleración aplicados.
RawCoordinateSystem	Obtiene el sistema de coordenadas del delimitador, sin que se aplique aceleración.
RemovedByUser	Obtiene un valor que indica si el usuario quitó el delimitador persistente.

Métodos

TryCreateRelativeTo(SpatialCoordinateSystem)	Crea un delimitador en el origen del sistema de coordenadas especificado.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)	Crea un delimitador en una posición específica dentro del sistema de coordenadas especificado.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)	Crea un delimitador en una posición y orientación específicas dentro del sistema de coordenadas especificado. Esto puede devolver null si el sistema ha alcanzado su límite en los anclajes espaciales. También puede devolver null si el sistema de coordenadas especificado no se encuentra en este marco.

Eventos

RawCoordinateSystemAdjusted

Se produce cuando el dispositivo ajusta la ubicación precisa del delimitador, que actualiza RawCoordinateSystem.