Compartilhar via


SpatialAnchor Classe

Definição

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

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.

Aplica-se a