Panduan Memulai untuk Google Cardboard untuk Unity

Panduan ini menunjukkan cara menggunakan Plugin Google Cardboard XR untuk Unity untuk Unity guna membuat pengalaman Virtual Reality (VR) Anda sendiri.

Catatan: Pastikan untuk meninjau panduan branding Cardboard sebelum mendistribusikan aplikasi ke audiens yang lebih luas.

Anda dapat menggunakan Cardboard SDK untuk mengubah ponsel menjadi platform VR. Smartphone dapat menampilkan adegan 3D dengan rendering stereoskopik, melacak dan bereaksi terhadap gerakan kepala, serta berinteraksi dengan aplikasi dengan mendeteksi saat pengguna menekan tombol penampil.

Untuk memulai, Anda akan menggunakan HelloCardboard, game demo yang mendemonstrasikan fitur inti Cardboard SDK. Dalam game, pengguna mengamati dunia virtual untuk menemukan dan mengumpulkan objek. Panduan ini menunjukkan cara:

• Menyiapkan lingkungan pengembangan
• Mendownload dan mem-build aplikasi demo
• Memindai kode QR penampil Cardboard untuk menyimpan parameternya
• Melacak gerakan kepala pengguna
• Merender gambar stereoskopis dengan menetapkan distorsi yang benar untuk setiap mata
• Mengaktifkan dan menonaktifkan mode VR

Menyiapkan lingkungan pengembangan

Persyaratan software:

• Unity 2021.3.44f1 atau yang lebih baru
  • Pastikan untuk menyertakan Dukungan Build Android dan iOS selama penginstalan.
  • Pastikan untuk menginstal patch versi 44f1 atau yang lebih baru.
• Git harus diinstal dan file yang dapat dieksekusi git harus ada di variabel lingkungan PATH. Lihat dokumen dukungan git package manager Unity untuk mengetahui detail selengkapnya.

Mengimpor SDK dan membuat project baru

Ikuti langkah-langkah berikut untuk mengimpor Unity SDK dan membuat project baru.

1. Buka Unity dan buat project 3D baru.
2. Di Unity, buka Window > Package Manager.
3. Klik +, lalu pilih Add package from git URL.
4. Tempelkan https://github.com/googlevr/cardboard-xr-plugin.git ke dalam kolom entri teks.
   Paket harus ditambahkan ke paket yang diinstal.
5. Buka paket Plugin Google Cardboard XR untuk Unity. Di bagian Samples, pilih Import into Project.
   Aset contoh harus dimuat ke Assets/Samples/Google Cardboard/<version>/Hello Cardboard.

Catatan: <version> adalah nomor versi semantik X.Y.Z dari paket yang dirilis (misalnya, 1.1.0).

Mengonfigurasi tampilan HelloCardboard

1. Buka Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes, pilih Add Open Scenes, lalu pilih HelloCardboard untuk membuka contoh scene.
2. Buka menu Layers, lalu pilih Edit Layers....
3. Tentukan lapisan baru bernama "Interaktif".
4. Klik GameObject Treasure untuk membuka jendela Inspector. Tetapkan lapisannya menjadi "Interaktif". Jika jendela pop-up muncul yang menanyakan apakah Anda ingin menetapkan lapisan ke Interaktif untuk semua objek turunan juga, klik "Ya, ubah turunan".
5. Klik GameObject Player > Camera > CardboardReticlePointer untuk membuka jendela Inspector. Dalam skrip "Carboard reticle pointer", pilih "Interactive" sebagai Reticle Interaction Layer Mask.

Mengonfigurasi setelan project Android

Buka File > Build Settings.

1. Pilih Android, lalu pilih Switch Platform.
2. Pilih Add Open Scenes, lalu pilih HelloCardboard.

Player Settings

Penyelesaian dan Presentasi

Buka Project Settings > Player > Resolution and Presentation.

1. Tetapkan Orientasi Default ke Lanskap Kiri atau Lanskap Kanan.
2. Nonaktifkan Pengaturan Kecepatan Frame yang Dioptimalkan.

Catatan: Meskipun didukung oleh plugin Cardboard XR, orientasi Potret dan Potret Terbalik mungkin tidak menyediakan cukup ruang untuk rendering mata di perangkat.

Setelan lainnya

Buka Project Settings > Player > Other Settings.

1. Pilih OpenGLES2, OpenGLES3, atau Vulkan, atau kombinasi dari API tersebut di Graphics API.
2. Pilih Android 8.0 'Oreo' (API level 26) atau yang lebih tinggi di Minimum API Level.
3. Pilih API level 33 atau yang lebih tinggi di Target API Level.
4. Pilih IL2CPP di Scripting Backend.
5. Pilih arsitektur yang diinginkan dengan memilih ARMv7, ARM64, atau keduanya di Target Architectures.
6. Pilih Require di Akses Internet.
7. Pilih Input System Package (New) di Active Input Handling.
8. Tentukan domain perusahaan Anda di bagian Package Name.
9. Jika Vulkan dipilih sebagai Graphics API:
   • Hapus centang pada kotak Terapkan rotasi tampilan selama rendering di Setelan Vulkan.
   • Jika versi Unity adalah 2021.2 atau yang lebih baru, Pilih ETC2 di Format kompresi tekstur.
10. Jika versi Unity adalah 2023.1 atau yang lebih baru, pilih Activity dan hapus GameActivity di Application Entry Point.

Catatan: Anda dapat menggunakan API level minimum yang lebih rendah dengan mengubah kompatibilitas API rendering. Untuk informasi selengkapnya, lihat build.gradle SDK.

Catatan: Jika Anda mengalami masalah saat memilih Vulkan sebagai API grafik, centang kotak Development Build di Build Settings dan analisis log runtime untuk mencari error kompatibilitas driver.

Catatan: OpenGL ES 2.0 tidak lagi didukung di Unity 2023.1+. Untuk versi yang lebih baru, gunakan OpenGL ES 3.0 atau Vulkan. Untuk mengetahui informasi selengkapnya, lihat halaman Persyaratan dan kompatibilitas Android dalam manual Unity.

Setelan Publikasi

Buka Setelan Project > Pemain > Setelan Publikasi.

1. Di bagian Build, pilih Custom Main Gradle Template dan Custom Gradle Properties Template.

2. Tambahkan baris berikut ke bagian dependensi 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. Tambahkan baris berikut ke Assets/Plugins/Android/gradleTemplate.properties:

     android.enableJetifier=true
     android.useAndroidX=true
   

Catatan: Dependensi yang diperlukan dapat berubah antar-versi. Jika Anda ingin menggunakan versi yang berbeda dari rilis terbaru, lihat histori bagian dependensi di sdk/build.gradle repositori Cardboard SDK.

Setelan Pengelolaan Plugin XR

Buka Project Settings > XR Plug-in Management.

1. Pilih Cardboard XR Plugin di bagian Penyedia Plugin.

Mem-build project Anda

Buka File > Build Settings.

1. Pilih Build, atau pilih perangkat dan pilih Build and Run.

Mengonfigurasi setelan project iOS

Buka File > Build Settings.

1. Pilih iOS, lalu pilih Switch Platform.
2. Pilih Add Open Scenes, lalu pilih HelloCardboard.

Player Settings

Penyelesaian dan Presentasi

Buka Project Settings > Player > Resolution and Presentation.

1. Tetapkan Orientasi Default ke Lanskap Kiri atau Lanskap Kanan.

Catatan: Meskipun didukung oleh plugin Cardboard XR, orientasi Potret dan Potret Terbalik mungkin tidak menyediakan cukup ruang untuk rendering mata di perangkat.

Setelan lainnya

Buka Project Settings > Player > Other Settings.

1. Di Camera Usage Description, tulis Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters)..
2. Di Target minimum iOS Version, tulis 12.0.
3. Tentukan domain perusahaan Anda di bagian Package Name.

Catatan: Jika menggunakan iPhone X, pilih opsi Sembunyikan tombol layar utama di iPhone X.

Setelan Pengelolaan Plugin XR

Buka Project Settings > XR Plug-in Management.

1. Pilih Cardboard XR Plugin di bagian Penyedia Plugin.

Mem-build project Anda

Buka File > Build Settings.

1. Pilih Build atau Build and Run.

Memfokuskan lagi

Cardboard SDK memungkinkan Anda memusatkan kembali pelacak kepala menggunakan Recenter().

Ikuti langkah-langkah berikut untuk mencobanya menggunakan aplikasi contoh:

1. Pindahkan perangkat ke posisi yang ingin Anda pusatkan kembali (gunakan sebagai pose kepala yang baru melihat ke depan).
2. Tahan pemicu perangkat Cardboard Anda selama minimal tiga detik.
3. Lepaskan pemicu.
4. Pose awal kini berada di arah yang ditunjuk kamera.

Mengaktifkan dan menonaktifkan mode VR

Unity XR Plugin Management API memungkinkan Anda mengaktifkan atau menonaktifkan mode VR untuk Plugin XR Google Cardboard untuk Unity. Dokumentasi pengguna akhir dan contoh penggunaan tersedia di Dokumentasi pengguna akhir Unity.

Scene VrMode dalam contoh HelloCardboard menunjukkan penggunaan dasar API yang disebutkan di atas. Dalam tampilan ini, mode VR dapat dinonaktifkan dengan mengetuk exit , dan dapat diaktifkan kembali hanya dengan mengetuk di mana saja pada layar. Periksa VrModeController.cs untuk mengetahui detail tentang cara melakukannya.

Langkah berikutnya

• Tinjau pedoman branding Cardboard.