SpatialAnchor Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 SpatialAnchorPublic NotInheritable Class SpatialAnchor- Herança
- 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. |