Unity용 Google Cardboard 빠른 시작

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

참고: 더 많은 사용자에게 앱을 배포하기 전에 Cardboard 브랜딩 가이드라인을 검토하세요.

Cardboard SDK를 사용하여 휴대전화를 VR 플랫폼으로 전환할 수 있습니다. 모바일 기기는 스테레오스코피 렌더링으로 3D 장면을 표시하고, 머리 움직임을 추적하고 이에 반응하며, 사용자가 뷰어 버튼을 누르는 시점을 감지하여 앱과 상호작용할 수 있습니다.

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

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

개발 환경 설정

소프트웨어 요구사항:

• Unity 6000.0.23f1 이상
  • 설치 중에 Android 및 iOS 빌드 지원을 포함해야 합니다.
  • 패치 버전 23f1 이상을 설치해야 합니다.
• Git이 설치되어 있어야 하며 git 실행 파일이 PATH 환경 변수에 있어야 합니다. 자세한 내용은 Unity의 패키지 관리자 Git 지원 문서를 참고하세요.

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

다음 단계에 따라 Unity SDK를 가져오고 새 프로젝트를 만듭니다.

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

참고: <version>은 출시된 패키지의 X.Y.Z 시맨틱 버전 번호입니다(예: 1.1.0).

HelloCardboard 장면 구성

1. Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes로 이동하여 Add Open Scenes를 선택하고 HelloCardboard를 선택하여 샘플 장면을 엽니다.
2. 레이어 메뉴를 열고 레이어 수정...을 선택합니다.
3. 'Interactive'라는 새 레이어를 정의합니다.
4. Treasure GameObject를 클릭하여 Inspector 창을 엽니다. 레이어를 'Interactive'로 설정합니다. 모든 하위 객체에 레이어를 'Interactive'로 설정할지 묻는 팝업 창이 표시되면 'Yes, change children'(예, 하위 요소 변경)을 클릭합니다.
5. Player > Camera > CardboardReticlePointer GameObject를 클릭하여 인스펙터 창을 엽니다. 'Cardboard reticle pointer' 스크립트에서 Reticle Interaction Layer Mask로 'Interactive'를 선택합니다.

Android 빌드 설정 구성

File > Build Settings로 이동합니다.

1. Android를 선택하고 Switch Platform(플랫폼 전환)을 선택합니다.
2. 열린 장면 추가를 선택하고 HelloCardboard를 선택합니다.

플레이어 설정

편집 > 프로젝트 설정...으로 이동합니다.

해상도 및 프레젠테이션 설정 구성

플레이어 > 해상도 및 프레젠테이션으로 이동합니다.

1. 기본 방향을 가로 왼쪽 또는 가로 오른쪽으로 설정합니다.
2. Optimized Frame Pacing을 사용 중지합니다.

참고: Cardboard XR 플러그인에서 지원되지만 세로 및 세로 거꾸로 방향은 기기에서 눈 렌더링을 위한 공간이 충분하지 않을 수 있습니다.

기타 설정 구성

Player(플레이어) > Other Settings(기타 설정)으로 이동합니다.

1. 그래픽 API에서 OpenGLES2, OpenGLES3, Vulkan 또는 이들의 조합을 선택합니다.
2. 최소 API 수준에서 Android 8.0 'Oreo' (API level 26) 이상을 선택합니다.
3. 타겟 API 수준에서 API level 35 이상을 선택합니다.
4. Scripting Backend(스크립팅 백엔드)에서 IL2CPP를 선택합니다.
5. 타겟 아키텍처에서 ARMv7, ARM64 또는 둘 다를 선택하여 원하는 아키텍처를 선택합니다.
6. 인터넷 액세스에서 Require를 선택합니다.
7. Active Input Handling에서 Input System Package (New)을 선택합니다.
8. 패키지 이름에 회사 도메인을 지정합니다.
9. Vulkan이 그래픽 API로 선택된 경우 다음을 충족해야 합니다.
   • Vulkan 설정에서 렌더링 중 디스플레이 회전 적용 체크박스를 선택 해제합니다.
   • 텍스처 압축 형식에서 ETC2를 선택합니다.
10. 애플리케이션 진입점에서 Activity을 선택하고 GameActivity을 선택 해제합니다.

참고: 렌더링 API 호환성을 변경하여 더 낮은 최소 API 수준을 사용할 수 있습니다. 자세한 내용은 SDK의 build.gradle를 참고하세요.

참고: 그래픽 API로 Vulkan을 선택할 때 문제가 발생하는 경우 Build Settings에서 Development Build 체크박스를 선택하고 드라이버 호환성 오류를 찾아 런타임 로그를 분석하세요.

참고: OpenGL ES 2.0은 Unity 2023.1 이상에서 더 이상 지원되지 않습니다. 최신 버전에서는 OpenGL ES 3.0 또는 Vulkan을 대신 사용하세요. 자세한 내용은 Unity 설명서의 Android 요구사항 및 호환성 페이지를 참고하세요.

게시 설정 구성

Player(플레이어) > Publishing Settings(게시 설정)으로 이동합니다.

1. 빌드 섹션에서 Custom Main Gradle Template 및 Custom Gradle Properties Template를 선택합니다.

2. Assets/Plugins/Android/mainTemplate.gradle의 종속 항목 섹션에 다음 줄을 추가합니다.

     implementation 'androidx.appcompat:appcompat:1.6.1'
     implementation 'com.google.android.gms:play-services-vision:20.1.3'
     implementation 'com.google.android.material:material:1.12.0'
     implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
   

3. Assets/Plugins/Android/gradleTemplate.properties에 다음 줄을 추가합니다.

     android.enableJetifier=true
     android.useAndroidX=true
   

참고: 필요한 종속 항목은 버전 간에 변경될 수 있습니다. 최신 버전이 아닌 다른 버전을 사용하려면 Cardboard SDK 저장소의 sdk/build.gradle에 있는 종속 항목 섹션의 기록을 참고하세요.

XR 플러그인 관리 설정 구성

XR 플러그인 관리로 이동합니다.

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

프로젝트 빌드

File > Build Settings로 이동합니다.

1. 빌드를 선택하거나 기기를 선택하고 빌드 및 실행을 선택합니다.

iOS 프로젝트 설정 구성

File > Build Settings로 이동합니다.

1. iOS를 선택하고 Switch Platform을 선택합니다.
2. 열린 장면 추가를 선택하고 HelloCardboard를 선택합니다.

플레이어 설정

편집 > 프로젝트 설정...으로 이동합니다.

해상도 및 프레젠테이션 설정 구성

Player(플레이어) > Resolution and Presentation(해상도 및 프레젠테이션)으로 이동합니다.

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

참고: Cardboard XR 플러그인에서 지원되지만 세로 및 세로 거꾸로 방향은 기기에서 눈 렌더링을 위한 공간이 충분하지 않을 수 있습니다.

기타 설정 구성

Player(플레이어) > Other Settings(기타 설정)으로 이동합니다.

1. 카메라 사용 설명에 Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters).을 입력합니다.
2. 타겟 최소 iOS 버전에 12.0을 입력합니다.
3. 패키지 이름에 회사 도메인을 지정합니다.
4. 가장자리에서 시스템 동작 지연에서 Top Edge, Left Edge, Right Edge를 확인합니다.

참고: iPhone X를 사용하는 경우 iPhone X에서 홈 버튼 숨기기 옵션을 선택하세요.

XR 플러그인 관리 설정 구성

XR 플러그인 관리로 이동합니다.

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

프로젝트 빌드

File > Build Settings로 이동합니다.

1. Build 또는 Build and Run을 선택합니다.

중심 재설정

Cardboard SDK를 사용하면 Recenter()를 사용하여 헤드 트래커를 다시 중앙에 배치할 수 있습니다.

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

1. 기기를 다시 중앙에 배치하려는 위치로 이동합니다 (새로운 정면 머리 포즈로 사용).
2. Cardboard 기기의 트리거를 3초 이상 활성 상태로 유지합니다.
3. 트리거를 놓습니다.
4. 이제 초기 포즈가 카메라가 향하는 방향에 있습니다.

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

Unity XR 플러그인 관리 API를 사용하면 Unity용 Google Cardboard XR 플러그인의 VR 모드를 사용 설정하거나 중지할 수 있습니다. 최종 사용자 문서와 사용 예는 Unity의 최종 사용자 문서에서 확인할 수 있습니다.

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

다음 단계

• Cardboard 브랜딩 가이드라인을 검토합니다.