Unity에서 플랫폼 모드 이동

플랫폼 모드를 이동하면 HoloLens 2 선박, 석유 플랫폼 및 기타 차량과 같은 이동 플랫폼에서 올바르게 작동할 수 있습니다.

플랫폼 모드 이동에 대해 자세히 알아보기

개념적 개요

혼합 현실 시스템이 올바르게 작동하려면 헤드셋을 환경에 상대적으로 추적해야 합니다. 이 상대 추적을 사용하면 헤드셋 사용자가 환경에서 단단히 잠겨 있는 것처럼 보이도록 그래픽을 렌더링할 수 있습니다. 추적은 일반적으로 외부의 카메라와 IMU(관성 측정 단위)의 측정값을 사용하여 계산되는 포즈를 결합하여 수행됩니다. 이 메서드는 환경이 참조의 관성 프레임에 있을 때 잘 작동합니다. 행성의 움직임과 같은 작은 효과는 일반적으로 무시됩니다.

환경이 관성 참조 프레임에 없는 경우 일반 헤드 추적 시스템이 실패합니다. 이동 플랫폼 모드 기능은 관성 프레임을 기준으로 환경의 동작을 고려하여 이 문제를 해결합니다. 따라서 플랫폼 모드 이동 시 HoloLens 2 환경에 고정된 것처럼 보이는 홀로그램을 렌더링할 수 있습니다.

이동 플랫폼 모드를 활성화하려면 어떻게 해야 하나요?

다양한 사용 사례를 가능하게 하기 위해 이동 플랫폼 모드를 활성화하는 다양한 방법이 제공되었습니다. 어떤 방법을 선택할지 신중하게 고려하는 것이 중요합니다. 핵심 질문은 'HoloLens 2가 현재 이동 플랫폼 내에 있는지 누가 아는가?'입니다. 예제는 다음 표를 참조하세요.

플랫폼 모드 이동에 대한 모범 사례

SDK는 어디에서 얻을 수 있나요?

이동 플랫폼 SDK는 개발자가 Win32 또는 UWP 플랫폼용 애플리케이션을 개발할 수 있도록 C# 및 C++에 대한 언어 프로젝션을 지원합니다. Mixed Reality 기능 도구를 사용하여 SDK를 다운로드하고 설치합니다.

이 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.
}

VR 장치 및 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를 "On"으로 강제 적용하면 이 함수는 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;
    }
}

추가 정보

• 이동 플랫폼 모드