Режим перемещения платформы в Unity

Режим подвижной платформы позволяет HoloLens 2 правильно работать на движущихся платформах, таких как корабли, нефтяные платформы и другие транспортные средства.

Дополнительные сведения о режиме перемещения платформы

Общие сведения об основных понятиях

Чтобы системы смешанной реальности работали правильно, гарнитура должна отслеживаться относительно среды. Это относительное отслеживание позволяет отображать графику таким образом, чтобы она выглядела для пользователя гарнитуры как надежно заблокированная в среде. Отслеживание обычно достигается путем объединения поз, которые вычисляются с помощью камер с внешним видом и измерений из инерционной единицы измерения (IMU). Этот метод хорошо работает, когда среда находится в инерционной системе отсчета. Небольшие эффекты, такие как планетарное движение, обычно игнорируются.

Если среда не в инерциальной системе отсчета, нормальная система отслеживания головы выйдет из строя. Функция движущегося режима платформы решает эту проблему, учитывая движение среды относительно инерционного кадра. Таким образом, в режиме движущейся платформы HoloLens 2 может отображать голограммы, которые кажутся фиксированными для среды, даже если среда является мешающей корабль!

Как активировать режим подвижного пола?

Для поддержки разных вариантов использования вам предоставляются разные методы для активации режима подвижного пола. Важно, чтобы вы тщательно выбрали нужный метод. Ключевым вопросом будет следующий: "Кто знает, используется ли в настоящий момент HoloLens 2 на подвижном полу?". См. пример в следующей таблице:

Рекомендации по перемещению режима платформы

Где получить пакет SDK?

Пакет SDK для движущейся платформы поддерживает языковые проекции для C# и C++, позволяя разработчикам разрабатывать приложения для платформ Win32 или UWP. Скачайте и установите пакет SDK с помощью средства Смешанная реальность Feature Tool.

Разделы справки использовать этот пакет SDK

После установки пакета SDK можно настроить сценарий для использования MovingPlatformManger следующим образом:

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

Чтение текущего режима

Текущее значение режима можно считать следующим образом:

MovingPlatformMode currentMode = m_movingPlatformManager.Mode;

MovingPlatformMode — это перечисление, которое определяется следующим образом:

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

Устройства, для которых не доступен режим движущейся платформы, такие как устройства виртуальной реальности и HoloLens 1, всегда будут возвращать значение "Стандартный".

Настройка режима

Значение Режима платформы перемещения можно задать следующим образом:

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

TrySetMode возвращает значение true, если режим устройства теперь совпадает с запрошенным режимом. Если режим уже находится в нужном состоянии, ничего не будет сделано, и устройство не потеряет отслеживание.

Обратный вызов при изменении режима

Иногда может быть полезно узнать, изменило ли другое приложение или пользователь значение режима перемещаемой платформы. Это можно сделать следующим образом.

// 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
    }
}

Проверка того, является ли режим настраиваемым

Иногда бывает полезно узнать, можно ли настроить режим, прежде чем пытаться изменить его. Например, если вы хотите узнать, есть ли какое-либо значение в запросе у пользователя его предпочтений. Можно узнать, можно ли настроить режим перемещаемой платформы с помощью функции IsSetModeSupported:

bool supported = m_movingPlatformManager.IsSetModeSupported();

Эта функция возвращает значение true, если устройство может изменять режимы, и значение false, если это невозможно. Эта функция учитывает политики мобильного Управление устройствами (MDM). Например, если MDM принудительно приведет MovingPlatformMode к значению "Вкл.", эта функция вернет значение false.

Демонстрационный скрипт

Этот скрипт отображает все важные элементы пакета SDK в одном месте. Пример не соответствует рекомендациям, приведенным выше.

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;
    }
}

См. также раздел

• Режим подвижного пола