SpatialStageFrameOfReference 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 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 SpatialStageFrameOfReferencePublic NotInheritable Class SpatialStageFrameOfReference- Herança
- Atributos
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. |