SpatialAnchor Classe

Definição

Namespace:

Windows.Perception.Spatial

Representa um sistema de coordenadas fortemente ancorado em um ponto no entorno do usuário.

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

Herança

Object Platform::Object IInspectable SpatialAnchor

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v2.0)

Comentários

Você pode criar um SpatialAnchor em qualquer posição e orientação dentro do SpatialCoordinateSystem de sua escolha. O dispositivo deve ser capaz de localizar esse sistema de coordenadas no momento e o sistema não deve ter atingido seu limite de âncoras espaciais.

Depois de definido, o sistema de coordenadas de um SpatialAnchor se ajusta continuamente para manter a posição precisa e a orientação de seu local inicial. Em seguida, você pode usar esse SpatialAnchor para renderizar hologramas que aparecerão corrigidos no ambiente do usuário nesse local exato.

Os efeitos dos ajustes que mantêm a âncora no lugar são ampliados à medida que a distância da âncora aumenta. Você deve evitar a renderização de conteúdo em relação a uma âncora que esteja a mais de 3 metros da origem dessa âncora.

Você pode persistir um SpatialAnchor usando a classe SpatialAnchorStore e, em seguida, obtê-lo novamente em uma sessão de aplicativo futura.

A propriedade CoordinateSystem obtém um sistema de coordenadas que permite colocar conteúdo em relação à âncora, com easing aplicada quando o dispositivo ajusta o local preciso da âncora.

Use a propriedade RawCoordinateSystem e o evento RawCoordinateSystemAdjusted correspondente para gerenciar esses ajustes por conta própria.

O sistema de coordenadas é destro, com +y para cima, +x para a direita e -z para frente.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	RemovedByUser

Propriedades

CoordinateSystem	Obtém o sistema de coordenadas da âncora, com ajustes de easing aplicados.
RawCoordinateSystem	Obtém o sistema de coordenadas da âncora, sem aplicação de easing.
RemovedByUser	Obtém um valor que indica se a âncora persistente foi removida pelo usuário.

Métodos

TryCreateRelativeTo(SpatialCoordinateSystem)	Cria uma âncora na origem do sistema de coordenadas especificado.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)	Cria uma âncora em uma posição específica dentro do sistema de coordenadas especificado.
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)	Cria uma âncora em uma posição e orientação específicas dentro do sistema de coordenadas especificado. Isso poderá retornar nulo se o sistema atingir seu limite de âncoras espaciais. Ele também poderá retornar nulo se o sistema de coordenadas especificado não puder ser localizado nesse quadro.

Eventos

RawCoordinateSystemAdjusted

Ocorre quando o dispositivo ajusta o local preciso da âncora, que atualiza o RawCoordinateSystem.