Partilhar via


SpatialLocator Classe

Definição

Fornece acesso à localização de um dispositivo que é rastreado em relação ao ambiente do usuário, como um HoloLens ou outro headset Realidade Misturada.

public ref class SpatialLocator 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 SpatialLocator 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 SpatialLocator
Public NotInheritable Class SpatialLocator
Herança
Object Platform::Object IInspectable SpatialLocator
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

A classe SpatialLocator representa um dispositivo cuja posição e orientação podem ser controladas pelo Windows em relação ao ambiente do usuário. Uma instância SpatialLocator é a origem para quadros de referência de localização anexados e estacionários. Em um headset Realidade Misturada, como o HoloLens, esses quadros de referência podem ser usados para renderização holográfica e para raciocínio sobre superfícies no mundo inteiro ao redor do dispositivo.

Propriedades

Locatability

Obtém o estado atual do sistema de localização espacial do dispositivo.

Métodos

CreateAttachedFrameOfReferenceAtCurrentHeading()

Cria um quadro de referência que é anexado posicionalmente a esse SpatialLocator com a orientação atual como seu título fixo.

CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3)

Cria um quadro de referência que é anexado posicionalmente a esse SpatialLocator com a orientação atual como seu título fixo e com seu deslocamento de origem pela posição relativa especificada.

CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion)

Cria um quadro de referência que é posicionado anexado a esse SpatialLocator com a orientação atual como seu título fixo e com seu deslocamento de origem e girado pela posição e orientação relativa especificadas.

CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion, Double)

Cria um quadro de referência que é posicionado anexado a esse SpatialLocator com o título fornecido em radianos em relação à orientação atual e com seu deslocamento de origem pela posição e orientação relativa especificadas.

CreateStationaryFrameOfReferenceAtCurrentLocation()

Cria um quadro de referência que permanece estacionário em relação ao ambiente do usuário, com sua origem inicial no local atual do SpatialLocator.

CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3)

Cria um quadro de referência que permanece estacionário em relação ao ambiente do usuário, com sua origem inicial no deslocamento especificado do local atual do SpatialLocator.

CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion)

Cria um quadro de referência que permanece estacionário em relação ao ambiente do usuário, com sua origem inicial no deslocamento especificado do local atual do SpatialLocator e girado na rotação especificada.

CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion, Double)

Cria um quadro de referência que permanece estacionário em relação ao ambiente do usuário, com sua origem inicial no deslocamento especificado do local atual do SpatialLocator ao longo do título relativo especificado em radianos e girado na rotação especificada.

GetDefault()

Obtém a instância SpatialLocator que rastreia o local do dispositivo atual, como um HoloLens, em relação ao ambiente do usuário.

TryLocateAtTimestamp(PerceptionTimestamp, SpatialCoordinateSystem)

Retorna um SpatialLocation que representa o local do dispositivo no carimbo de data/hora especificado. As coordenadas dentro são expressas em relação ao sistema de coordenadas fornecido. Se o dispositivo não puder ser localizado nesse sistema de coordenadas no carimbo de data/hora especificado, o valor retornado será nulo. Isso pode acontecer quando o dispositivo perdeu o rastreamento, por exemplo.

Eventos

LocatabilityChanged

Ocorre quando o estado do sistema de localização espacial é alterado.

PositionalTrackingDeactivating

Ocorre quando o sistema de localização espacial do dispositivo está desativando devido à inatividade.

Aplica-se a

Confira também