SpatialLocator 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.
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 SpatialLocatorPublic NotInheritable Class SpatialLocator- 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
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. |