SpatialStageFrameOfReference Classe

Definição

Namespace:

Windows.Perception.Spatial

Representa um estágio espacial, definido pelo usuário para estabelecer o espaço físico no qual ele pretende usar um headset Realidade Misturada.

public ref class SpatialStageFrameOfReference sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialStageFrameOfReference final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialStageFrameOfReference

Public NotInheritable Class SpatialStageFrameOfReference

Herança

Object Platform::Object IInspectable SpatialStageFrameOfReference

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v4.0)

Comentários

Um estágio espacial consiste minimamente em um sistema de coordenadas de nível de piso cuja origem é escolhida pelo usuário, representando o centro lógico da área na qual ele pretende usar seus Realidade Misturada headset. Esse sistema de coordenadas de nível de piso permite que os aplicativos apresentem experiências em escala permanente.

Opcionalmente, o usuário também pode definir um limite de movimento, representando a área aberta na qual pretende andar enquanto usa o fone de ouvido. Esse limite de movimento permite que os aplicativos apresentem experiências de escala de sala.

Se o usuário não tiver definido um estágio espacial, um aplicativo poderá chamar o método RequestNewStageAsync para orientar o usuário por meio da interface do usuário do sistema que permitirá que ele defina um.

No HoloLens, um aplicativo também pode criar experiências em escala permanente ou em escala de sala usando o mapeamento espacial. O mapeamento espacial permite que o desenvolvedor analise o ambiente do usuário e determine os locais das paredes e dos pisos do usuário usando o tipo SpatialSurfaceObserver , mesmo que o usuário não tenha definido um estágio manualmente. Inspecione a propriedade SpatialSurfaceObserver.IsSupported para determinar se o dispositivo atual dá suporte ao mapeamento espacial.

Os sistemas de coordenadas retornados pelo estágio são destros, com +y para cima, +x à direita e -z para frente.

Propriedades

CoordinateSystem	Obtém um sistema de coordenadas de nível de piso localizado na origem do estágio definida pelo usuário.
Current	Obtém o estágio espacial atual, se um tiver sido definido pelo usuário.
LookDirectionRange	Obtém a extensão em que o usuário pode olhar ao redor com seu fone de ouvido.
MovementRange	Obtém até que ponto o usuário pode se mover enquanto usa o fone de ouvido.

Métodos

GetCoordinateSystemAtCurrentLocation(SpatialLocator)	Obtém um sistema de coordenadas de nível de piso na posição e orientação atuais do usuário.
RequestNewStageAsync()	Mostra a interface do usuário do sistema para orientar o usuário na definição de um novo estágio para substituir o estágio atual.
TryGetMovementBounds(SpatialCoordinateSystem)	Obtém os vértices de limite da área aberta definida pelo usuário para onde ele pretende se mover ao usar o fone de ouvido.

Eventos

CurrentChanged

Ocorre quando o usuário altera ou redefine o estágio espacial atual.

Confira também

• Exemplo de estágio espacial holográfico