Unity용 Google Cardboard 빠른 시작

Stay organized with collections Save and categorize content based on your preferences.

이 가이드에서는 Unity용 Google Cardboard XR 플러그인을 사용하여 자체 가상 현실 (VR) 환경을 만드는 방법을 설명합니다.

Cardboard SDK를 사용하여 스마트폰을 VR 플랫폼으로 변환할 수 있습니다. 스마트폰은 입체 렌더링으로 3D 장면을 표시하고, 머리 움직임을 추적 및 반응하며, 사용자가 뷰어 버튼을 누르는 시점을 감지하여 앱과 상호작용할 수 있습니다.

시작하려면 Cardboard SDK의 핵심 기능을 보여주는 데모 게임인 HelloCardboard를 사용합니다. 게임에서 사용자는 가상 세계를 둘러보며 객체를 찾고 수집합니다. 다음 방법을 안내합니다.

  • 개발 환경 설정
  • 데모 앱 다운로드 및 빌드
  • Cardboard 뷰어의 QR 코드를 스캔하여 매개변수를 저장하세요.
  • 사용자의 머리 움직임 추적
  • 각 눈의 올바른 왜곡을 설정하여 입체 이미지를 렌더링합니다.
  • VR 모드 사용 및 사용 중지

개발 환경 설정

소프트웨어 요구사항:

SDK 가져오기 및 새 프로젝트 만들기

다음 단계를 따라 Unity SDK를 가져오고 새 프로젝트를 만드세요.

  1. Unity를 열고 새 3D 프로젝트를 만듭니다.
  2. Unity에서 Window(창) & Package Manager(패키지 관리자)로 이동합니다.
  3. +를 클릭하고 git URL에서 패키지 추가를 선택합니다.
  4. 텍스트 입력란에 https://github.com/googlevr/cardboard-xr-plugin.git을 붙여넣습니다.
    패키지를 설치된 패키지에 추가해야 합니다.
  5. Unity용 Google Cardboard XR 플러그인 패키지로 이동합니다. 샘플 섹션에서 프로젝트로 가져오기를 선택합니다.
    샘플 애셋이 Assets/Samples/Google Cardboard/<version>/Hello Cardboard에 로드되어야 합니다.
  6. Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes로 이동하여 Add scenes를 선택하고 HelloCardboard를 선택하여 샘플 장면을 엽니다.

Android 프로젝트 설정 구성

파일 > 빌드 설정으로 이동합니다.

  1. Android를 선택하고 Switch Platform(플랫폼 전환)을 선택합니다.
  2. Open scenes를 선택하고 HelloCardboard를 선택합니다.

플레이어 설정

해결 및 프레젠테이션

Project Settings > Player > Resolution and Presentation으로 이동합니다.

  1. 기본 방향가로 왼쪽 또는 오른쪽 가로 모드로 설정합니다.
  2. 최적화된 프레임 속도를 사용 중지합니다.

기타 설정

프로젝트 설정 > 플레이어 > 기타 설정으로 이동합니다.

  1. OpenGLES2OpenGLES3, Vulkan을 선택하거나 Graphics API에서 조합하여 선택합니다.
  2. Minimum API Level에서 Android 7.0 'Nougat' (API level 24) 이상을 선택합니다.
  3. 대상 API 수준에서 API level 31 이상을 선택합니다.
  4. 스크립트 백엔드에서 IL2CPP를 선택합니다.
  5. 타겟 아키텍처에서 ARMv7, ARM64 또는 둘 다를 선택하여 원하는 아키텍처를 선택합니다.
  6. 인터넷 액세스에서 Require을 선택합니다.
  7. Package Name에서 회사 도메인을 지정합니다.
  8. VulkanGraphics API로 선택된 경우:
    • Vulkan 설정에서 렌더링 중 디스플레이 회전 적용 체크박스를 선택 해제합니다.
    • Unity 버전이 2021.2 이상이면 텍스처 압축 형식에서 ETC2을 선택합니다.

게시 설정

프로젝트 설정 > 플레이어 > 게시 설정으로 이동합니다.

  1. Build 섹션에서 Custom Main Gradle TemplateCustom Gradle Properties Template를 선택합니다.
  2. Assets/Plugins/Android/mainTemplate.gradle의 종속 항목 섹션에 다음 줄을 추가합니다.

      implementation 'androidx.appcompat:appcompat:1.4.2'
      implementation 'com.google.android.gms:play-services-vision:20.1.3'
      implementation 'com.google.android.material:material:1.6.1'
      implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
    
  3. Assets/Plugins/Android/gradleTemplate.properties에 다음 줄을 추가합니다.

      android.enableJetifier=true
      android.useAndroidX=true
    

XR 플러그인 관리 설정

프로젝트 설정 > XR 플러그인 관리로 이동합니다.

  1. 플러그인 제공업체에서 Cardboard XR Plugin을 선택합니다.

프로젝트 빌드

파일 > 빌드 설정으로 이동합니다.

  1. Build를 선택하거나 기기를 선택하고 Build and Run을 선택합니다.

iOS 프로젝트 설정 구성

파일 > 빌드 설정으로 이동합니다.

  1. iOS를 선택하고 Switch Platform(플랫폼 전환)을 선택합니다.
  2. Open scenes를 선택하고 HelloCardboard를 선택합니다.

플레이어 설정

해결 및 프레젠테이션

Project Settings > Player > Resolution and Presentation으로 이동합니다.

  1. 기본 방향가로 왼쪽 또는 오른쪽 가로 모드로 설정합니다.

기타 설정

프로젝트 설정 > 플레이어 > 기타 설정으로 이동합니다.

  1. 카메라 사용 설명Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters).을 작성합니다.
  2. 대상 최소 iOS 버전12.0을 작성합니다.
  3. Package Name에서 회사 도메인을 지정합니다.

XR 플러그인 관리 설정

프로젝트 설정 > XR 플러그인 관리로 이동합니다.

  1. 플러그인 제공업체에서 Cardboard XR Plugin을 선택합니다.

프로젝트 빌드

파일 > 빌드 설정으로 이동합니다.

  1. Build(빌드) 또는 Build and Run(빌드 및 실행)을 선택합니다.

중심 재설정

Cardboard SDK를 사용하면 Recenter()를 사용하여 헤드 추적기를 중심에 둘 수 있습니다.

샘플 애플리케이션을 사용하여 시험해 보려면 다음 단계를 따르세요.

  1. 기기를 중심을 다시 맞추고자 하는 위치로 기기를 이동합니다 (머리를 앞으로 향한 새로운 자세로 사용).
  2. Cardboard 기기의 트리거를 3초 이상 활성 상태로 유지합니다.
  3. 트리거를 해제합니다.
  4. 초기 자세가 이제 카메라가 향하고 있는 방향입니다.

VR 모드 사용 설정 및 사용 중지

Unity XR Plugin Management API를 사용하면 Unity용 Google Cardboard XR 플러그인에 VR 모드를 사용 또는 사용 중지할 수 있습니다. 최종 사용자 문서 및 사용 예는 Unity의 최종 사용자 문서에서 확인할 수 있습니다.

HelloCardboard 샘플의 VrMode 장면은 앞에서 언급한 API의 기본 사용법을 보여줍니다. 이 장면에서 VR 모드는 종료 를 탭하여 사용 중지할 수 있으며 화면의 아무 곳이나 탭하여 다시 사용 설정할 수 있습니다. 실행 방법에 관한 자세한 내용은 VrModeController.cs를 참고하세요.

다음 단계