Compartir a través de


SpatialAnchor Clase

Definición

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

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.

Se aplica a