Movendo o modo de plataforma no Unity

O Modo de Plataforma Móvel permite que HoloLens 2 trabalhem corretamente em plataformas móveis, como navios, plataformas de petróleo e outros veículos.

Saiba mais sobre o modo de plataforma móvel

Visão geral conceitual

Para que os sistemas de realidade misturada funcionem corretamente, o headset deve ser rastreado em relação ao ambiente. Esse acompanhamento relativo permite que os elementos gráficos sejam renderizados de modo que pareçam para o usuário do fone de ouvido serem bloqueados solidamente no ambiente. O acompanhamento geralmente é obtido combinando poses calculadas usando câmeras de aparência externa e medidas da IMU (Unidade de Medida Inercial). Esse método funciona bem quando o ambiente está no quadro inercial de referência. Pequenos efeitos, como o movimento planetário, geralmente são negligenciados.

Quando o ambiente não estiver no quadro inercial de referência, o sistema de acompanhamento de cabeça normal falhará. O recurso Modo de Plataforma Móvel resolve esse problema contabilizando o movimento do ambiente em relação ao quadro inercial. Assim, quando estiver no Modo de Plataforma Móvel, HoloLens 2 pode renderizar hologramas que aparecem fixos no ambiente, mesmo que o ambiente seja uma nave móvel!

Como devo ativar o Modo de Plataforma Móvel?

Para habilitar um intervalo de casos de uso, vários métodos foram fornecidos para ativar o Modo de Plataforma Móvel. É importante que você considere cuidadosamente qual método escolher. Uma pergunta importante é: quem sabe se o HoloLens 2 está, no momento, dentro de uma plataforma móvel? Confira a seguinte tabela para obter exemplos:

Práticas recomendadas para o modo de plataforma móvel

Onde posso obter o SDK?

O SDK da Plataforma Móvel dá suporte a projeções de linguagem para C# e C++, permitindo que os desenvolvedores desenvolvam aplicativos para plataformas Win32 ou UWP. Baixe e instale o SDK com a Ferramenta de Recursos do Realidade Misturada.

Como fazer usar esse SDK

Depois de instalar o SDK, você pode configurar seu script para usar MovingPlatformManger da seguinte maneira:

// Top of file
using Microsoft.MixedReality.MovingPlatform;
// Code body
m_movingPlatformManager = new MovingPlatformManager();

Lendo o modo atual

O valor atual do modo pode ser lido da seguinte maneira:

MovingPlatformMode currentMode = m_movingPlatformManager.Mode;

MovingPlatformMode é uma enumeração definida da seguinte maneira:

public enum MovingPlatformMode
{
    Standard,                // The legacy mode that devices use out-of-the-box.
    MovingPlatformOptimized  // Allows tracking on moving platforms.
}

Dispositivos que não têm o Modo de Plataforma Móvel disponível, como dispositivos VR e HoloLens 1, sempre retornarão 'Standard'.

Definindo o modo

Você pode definir o valor do Modo de Plataforma Móvel da seguinte maneira:

bool success = m_movingPlatformManager.TrySetMode(MovingPlatformMode.MovingPlatformOptimized);

TrySetMode retornará true se o modo de dispositivo agora corresponder ao modo solicitado. Se o modo já estiver no estado desejado, nada será feito e o dispositivo não perderá o rastreamento.

Retorno de chamada na alteração do modo

Às vezes, pode ser útil saber se outro aplicativo, ou o usuário, alterou o valor do Modo de Plataforma Móvel. Você pode fazer isso da seguinte maneira.

// Code Body
m_movingPlatformManager.ModeChanged += CallbackOnMPMChanged;
...
void CallbackOnMPMChanged(object sender, MovingPlatformEventArgs args)
{
    movingPlatformModeChanged = true;
    movingPlatformModeValue = args.ModeEntered;
}
...
void Update()
{
    // It's not reccomended to do work in the callback.
    if (movingPlatformModeChanged)
    {
        movingPlatformModeChanged = false;
        // Do some work
    }
}

Verificando se o modo é configurável

Às vezes, é útil saber se o modo é configurável antes de tentar alterá-lo. Por exemplo, se você quiser saber se há algum valor em perguntar ao usuário sua preferência. Você pode descobrir se o modo de plataforma móvel é configurável com a função IsSetModeSupported:

bool supported = m_movingPlatformManager.IsSetModeSupported();

Essa função retornará true se o dispositivo puder alterar os modos e false se isso não for possível. Essa função conta para políticas de MDM (Gerenciamento de Dispositivos móvel). Por exemplo, se o MDM forçar o MovingPlatformMode a "On", essa função retornará false.

Um script de demonstração

Esse script mostra todos os elementos importantes do SDK em um só lugar. O exemplo não segue as práticas recomendadas mostradas acima.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using Microsoft.MixedReality.MovingPlatform;
using System;

public class MovingPlatformDemo : MonoBehaviour
{
    public GameObject cube; // A simple cube to display colors.
    private MovingPlatformManager m_movingPlatformManager;
    private Renderer cubeRenderer;
    private bool movingPlatformModeChanged;
    private MovingPlatformMode movingPlatformModeValue;

    // Start is called before the first frame update
    void Start()
    {
        m_movingPlatformManager = new MovingPlatformManager();
        cubeRenderer = cube.GetComponent<Renderer>();

        // Get initial value of mode, 
        // Just this mechanism would be adequate if a one time check is acceptable. 
        MovingPlatformMode initialMovingPlatformMode = m_movingPlatformManager.Mode;

        // Find if It's possible to change the mode. 
        bool isSettable = m_movingPlatformManager.IsSetModeSupported();

        // Here you would add some use case specific logic using initialMovingPlatformMode and isSettable
        // to decide if you should ask the user if they want to change the mode. 

        // To set the mode.
        bool success = m_movingPlatformManager.TrySetMode(MovingPlatformMode.MovingPlatformOptimized);

        // Visual indicator of current state: Green = Moving Platform Optimized, Red = Regular.
        SetColourFromState(m_movingPlatformManager.Mode, cubeRenderer);

        // We set a callback to be notified if there's a change in mode. This is typically optional.
        m_movingPlatformManager.ModeChanged += CallbackOnMPMChanged;
        movingPlatformModeChanged = false;
    }

    // Update is called once per frame
    void Update()
    {
        // This must be done in the UI thread.
        if (movingPlatformModeChanged)
        {
            movingPlatformModeChanged = false;
            SetColourFromState(movingPlatformModeValue, cubeRenderer);
        }
    }

    // Sets renderer to:
    // Green = Moving Platform Mode Enabled
    // Red = Moving Platform Mode Disabled
    void SetColourFromState(MovingPlatformMode mode, Renderer thisRend)
    {
        if (mode == MovingPlatformMode.MovingPlatformOptimized)
        {
            thisRend.material.color = new Color(0f, 1f, 0f, 1f);
        }
        else
        {
            thisRend.material.color = new Color(1f, 0f, 0f, 1f);
        }
    }

    void CallbackOnMPMChanged(object sender, MovingPlatformEventArgs args)
    {
        movingPlatformModeChanged = true;
        movingPlatformModeValue = args.ModeEntered;
    }
}

Confira também

• Modo de plataforma móvel