Table of Contents

Mega Go 추적 프로세스 제어

이 문서에서는 다양한 애플리케이션 시나리오의 요구 사항을 충족하기 위해 Mega Go 추적 프로세스의 다양한 기능과 매개 변수를 제어하는 방법을 소개합니다.

시작하기 전에

tracker의 작동 흐름

tracker의 작동 흐름은 다음과 같습니다.

flowchart LR
  subgraph startup_graph[시작]
    direction TB
    sstart((세션 시작))
    create[네이티브 생성]
    load(타겟 로드)
    verify[시험 사용 검증]
    init_g[[초기화]]
  end
  
  subgraph init_graph[초기화]
    direction TB
    init_{6DoF 초기화 성공<br>또는 비 6DoF}
    init[[로컬 추적 초기화 프로세스]]
    detecting[[감지]]
    tracking_g[[추적]]
  end

  subgraph tracking_graph[추적]
    direction TB
    tracking[[지속적인 추적]]
  end

  subgraph stopping_graph[중지]
    direction TB
    unload(타겟 언로드)
    dispose[네이티브 삭제]
    sstop([세션 중지])
  end

  sstart --> create --> load --> verify --> init_g
  init --> init_ --> |Yes| detecting --> tracking_g
  unload --> dispose --> sstop
  init_ --> |No| init

  startup_graph --> init_graph
  init_graph --> tracking_graph
  tracking_graph --> stopping_graph

흐름은 크게 다음과 같은 단계로 나뉩니다.

  • 시작:
    • 세션이 시작된 후 네이티브 계층의 tracker가 생성됩니다.
    • 타겟 자체의 Start() 후 해당 tracker에 로드됩니다.
    • 시험 사용 데이터의 경우, 시험 사용 자격을 온라인으로 검증해야 하며, 검증이 성공한 후에만 후속 단계로 진행됩니다.
  • 초기화:
    • 6DoF 프레임 소스를 사용할 때는 로컬 추적 초기화 프로세스로 들어갑니다.
      • 로컬 추적 초기화는 일부 시간이 걸릴 수 있으며, 이는 시나리오 복잡성과 기기 성능에 따라 다르며, 일반적으로 프레임 소스에서 사용하는 기본 알고리즘과 관련이 있습니다.
    • 비 6DoF 프레임 소스를 사용할 때는 로컬 추적 초기화 단계가 건너뛰어지고 감지가 직접 시작됩니다.
    • 감지 프로세스는 시나리오의 위치 추적 용이성과 데이터 수집 및 지도 생성 품질에 따라 일부 시간이 걸릴 수 있습니다.
    • 기본 구성에서는 이 단계의 내용이 표시되지 않으며, ActiveController 구성 요소 옵션을 통해 이 동작을 제어할 수 있습니다.
  • 추적:
    • tracker는 현재 블록을 지속적으로 추적합니다.
    • 기본 구성에서는 이 단계에서 추적 상태(TargetController.IsTracked == true)에 있는 타겟 노드 아래의 내용만 표시되며, ActiveController 구성 요소 옵션을 통해 이 동작을 제어할 수 있습니다.
  • 중지:
    • 세션이 중지된 후 타겟이 언로드되고 네이티브 계층의 tracker가 삭제됩니다.

기기 지원 등급 조정

MegaGoTrackerFrameFilter의 MegaGoTrackerFrameFilter.MinInputFrameLevel 속성은 Mega가 지원하는 최소 기기 등급을 지정하는 데 사용됩니다.

alt text

Mega Go는 거의 모든 유형의 프레임 데이터 소스에서 실행할 수 있지만, 다른 프레임 데이터 소스는 추적 효과에 다른 영향을 미칩니다.

기본적으로 Mega는 기기가 지원하는 최고 등급의 프레임 데이터 소스를 선택하여 추적합니다. 기본 구성에서 Mega Go를 지원하는 세션은 6DoF 및 5DoF 프레임 데이터 소스를 지원하도록 구성되어 있습니다.

Mega가 실행 중일 때 특정 등급의 프레임 데이터 소스를 지원하려면 두 가지 조건을 충족해야 합니다.

예를 들어, 기본 세션에서 3DoF 추적을 지원하려면 다음이 필요합니다.

또 다른 예로, 기본 세션에서 5DoF 추적 지원을 제거하려면 다음이 필요합니다.

조건을 충족하는 프레임 데이터 소스가 없으면 세션 조립이 실패합니다.

현재 시스템 상태 이해

기본 세션 구성에서는 UI 메시지가 화면에 표시되며, 여기에는 Mega Go 상태 정보가 포함되어 있습니다.

Tracker 상태는 Mega Go: 옆에 표시되며, 예를 들어 Tracking, VerifyingTrial 등이 있습니다. 감지 및 추적 프로세스에서 아래쪽에 위치 업데이트가 표시됩니다.

alt text

현재 로드된 블록의 추적 상태는 Mega Go: 아래에 Block (<trackingStatus>): <name> (<id>)로 표시됩니다. 여기서 <name>은 블록의 이름이고, <id>는 블록의 ID입니다. trackingStatus는 Tracking 또는 NotTracking일 수 있으며, 각각 현재 블록이 추적 중인지 여부를 나타냅니다.

alt text

MegaGoTrackerFrameFilter.Status 속성을 사용하여 현재 상태를 가져올 수 있으며, 이를 통해 추적기의 실행 상태를 알 수 있습니다. 오류 상태가 발생하면 MegaGoTrackerFrameFilter.Error를 통해 오류 상태를 가져와 적절한 조치를 취할 수 있습니다.

다음 코드는 이러한 속성을 사용하는 방법과 애플리케이션이 주의해야 할 일반적인 예외 상태를 처리하는 방법을 보여줍니다.

void HandleTrackerStatus()
{
    if (tracker.Status == MegaGoTrackerStatus.Error)
    {
        if (tracker.Error == MegaGoTrackerError.ServiceVerificationFailed)
        {
            // 서비스 검증 실패. 데이터가 만료되었거나 무효한지 확인하는 것이 좋습니다(테스트 버전을 정식 버전으로 변환한 후 테스트 버전 데이터는 무효화됩니다).
        }
        else if (tracker.Error == MegaGoTrackerError.LocalVerificationFailed)
        {
            // 로컬 검증 실패. 타겟 파일이 완전한지 확인하는 것이 좋습니다.
        }
        else
        {
            // 기타 오류.
        }
    }
    else if (tracker.Status == MegaGoTrackerStatus.VerifyingTrial)
    {
        // 시험 타겟 검증 중. 장시간 검증이 완료되지 않으면 네트워크 연결을 확인하는 것이 좋습니다.
    }
    else if (tracker.Status == MegaGoTrackerStatus.VIOInitializing)
    {
        // VIO 입력 초기화 중. 장시간 초기화가 완료되지 않으면 사용자에게 사용 방법을 최적화하도록 제안하는 것이 좋습니다.
        // 예: "카메라를 약간 앞쪽으로 향하게 하고 기기를 휴대한 상태로 몸을 좌우로 크게 5번 움직여 보세요."
    }
}

MegaGoTrackerFrameFilter.LocalizationRespond 이벤트를 사용하여 위치 업데이트를 가져올 수 있습니다.

일시 중지 및 계속

MegaGoTrackerFrameFilter.enabled을 false로 설정하여 추적을 일시 중지할 수 있습니다.

기본적으로 추적이 일시 중지되면 모든 블록 노드 아래의 내용이 숨겨집니다.

관련 주제