Panduan ini menunjukkan cara menggunakan Google Cardboard XR Plugin for Unity untuk Unity guna membuat pengalaman Virtual Reality (VR) Anda sendiri.
Anda dapat menggunakan Cardboard SDK untuk mengubah ponsel menjadi platform VR. Perangkat seluler 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, sebuah game demo yang menunjukkan fitur inti Cardboard SDK. Dalam game, pengguna melihat-lihat dunia virtual untuk menemukan dan mengumpulkan objek. Bagian ini menunjukkan cara:
- Menyiapkan lingkungan pengembangan
- Mendownload dan mem-build aplikasi demo
- Pindai kode QR penampil Cardboard untuk menyimpan parameternya
- Melacak gerakan kepala pengguna
- Merender gambar stereoskopik dengan menyetel distorsi yang benar untuk setiap mata
- Mengaktifkan dan menonaktifkan mode VR
Menyiapkan lingkungan pengembangan
Persyaratan software:
- Unity 6000.0.23f1 atau yang lebih baru
- Pastikan untuk menyertakan Dukungan Build Android dan iOS selama penginstalan.
- Pastikan untuk menginstal patch versi 23f1 atau yang lebih baru.
- Git harus diinstal dan file yang dapat dieksekusi
git
harus ada di variabel lingkunganPATH
. Lihat dokumentasi Dukungan git pengelola paket Unity untuk mengetahui detail selengkapnya.
Impor SDK dan buat project baru
Ikuti langkah-langkah berikut untuk mengimpor Unity SDK dan membuat project baru.
- Buka Unity dan buat project 3D baru.
- Di Unity, buka Window > Package Manager.
- Klik +, lalu pilih Tambahkan paket dari URL git.
- Tempelkan
https://github.com/googlevr/cardboard-xr-plugin.git
ke dalam kolom entri teks.
Paket harus ditambahkan ke paket yang diinstal. - Buka paket Google Cardboard XR Plugin for Unity. Di bagian
Samples, pilih Import into Project.
Aset contoh harus dimuat ke dalamAssets/Samples/Google Cardboard/<version>/Hello Cardboard
.
Mengonfigurasi adegan HelloCardboard
- Buka
Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes
, pilih Add Open Scenes, lalu pilih HelloCardboard untuk membuka adegan contoh. - Buka menu Lapisan, lalu pilih Edit Lapisan....
- Tentukan lapisan baru bernama "Interaktif".
- Klik GameObject Treasure untuk membuka jendela Inspector. Tetapkan lapisan menjadi "Interaktif". Jika jendela pop-up muncul dan menanyakan apakah Anda ingin menetapkan lapisan ke Interaktif untuk semua objek turunan juga, klik "Ya, ubah turunan".
- Klik GameObject Player > Camera > CardboardReticlePointer untuk membuka jendela Inspector. Dalam skrip "Penunjuk retikulus Cardboard", pilih "Interaktif" sebagai Reticle Interaction Layer Mask.
Mengonfigurasi setelan build Android
Buka File > Build Settings.
- Pilih Android, lalu pilih Switch Platform.
- Pilih Tambahkan Adegan Terbuka, lalu pilih HelloCardboard.
Player Settings
Buka Edit > Project Settings....
Mengonfigurasi setelan Resolusi dan Presentasi
Buka Player > Resolution and Presentation.
- Tetapkan Orientasi Default ke Lanskap Kiri atau Lanskap Kanan.
- Nonaktifkan Pengaturan Kecepatan Frame yang Dioptimalkan.
Mengonfigurasi Setelan lainnya
Buka Player > Other Settings.
- Pilih
OpenGLES2
,OpenGLES3
, atauVulkan
, atau kombinasi apa pun di Graphics API. - Pilih
Android 8.0 'Oreo' (API level 26)
atau yang lebih tinggi di Minimum API Level. - Pilih
API level 35
atau yang lebih tinggi di Target API Level. - Pilih
IL2CPP
di Scripting Backend. - Pilih arsitektur yang diinginkan dengan memilih
ARMv7
,ARM64
, atau keduanya di Target Architectures. - Pilih
Require
di Akses Internet. - Pilih
Input System Package (New)
di Penanganan Input Aktif. - Tentukan domain perusahaan Anda di bagian Package Name.
- Jika
Vulkan
dipilih sebagai Graphics API:- Hapus centang Terapkan rotasi tampilan selama rendering di Setelan Vulkan.
- Pilih
ETC2
di Texture compression format.
- Pilih
Activity
dan hapusGameActivity
di Titik Entri Aplikasi.
Mengonfigurasi setelan Publikasi
Buka Player > Publishing Settings.
- Di bagian Build, pilih
Custom Main Gradle Template
danCustom Gradle Properties Template
. 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'
Tambahkan baris berikut ke
Assets/Plugins/Android/gradleTemplate.properties
:android.enableJetifier=true android.useAndroidX=true
Mengonfigurasi setelan Pengelolaan Plug-in XR
Buka XR Plug-in Management.
- Pilih
Cardboard XR Plugin
di bagian Penyedia Plugin.
Mem-build project Anda
Buka File > Build Settings.
- Pilih Build, atau pilih perangkat dan pilih Build and Run.
Mengonfigurasi setelan project iOS
Buka File > Build Settings.
- Pilih iOS, lalu pilih Switch Platform.
- Pilih Tambahkan Adegan Terbuka, lalu pilih HelloCardboard.
Player Settings
Buka Edit > Project Settings....
Mengonfigurasi setelan Resolusi dan Presentasi
Buka Player > Resolution and Presentation.
- Tetapkan Orientasi Default ke Lanskap Kiri atau Lanskap Kanan.
Mengonfigurasi Setelan lainnya
Buka Player > Other Settings.
- Di Deskripsi Penggunaan Kamera, tulis
Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters).
. - Di Target minimum iOS Version, tulis
12.0
. - Tentukan domain perusahaan Anda di bagian Package Name.
- Periksa
Top Edge
,Left Edge
, danRight Edge
di Tunda gestur sistem di tepi.
Mengonfigurasi setelan Pengelolaan Plug-in XR
Buka XR Plug-in Management.
- Pilih
Cardboard XR Plugin
di bagian Penyedia Plugin.
Mem-build project Anda
Buka File > Build Settings.
- Pilih Build atau Build and Run.
Tengahkan lagi
Cardboard SDK memungkinkan Anda
memusatkan kembali pelacak kepala menggunakan
Recenter()
.
Ikuti langkah-langkah berikut untuk mencobanya menggunakan aplikasi contoh:
- Pindahkan perangkat ke posisi yang ingin Anda pusatkan kembali (gunakan sebagai pose kepala melihat ke depan yang baru).
- Tahan pemicu perangkat Cardboard Anda agar tetap aktif selama minimal tiga detik.
- Lepaskan pemicu.
- Pose awal kini berada di arah yang dituju kamera.
Mengaktifkan dan menonaktifkan mode VR
API Pengelolaan Plugin XR Unity 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.
Adegan VrMode dalam contoh HelloCardboard menunjukkan penggunaan dasar
API yang disebutkan di atas. Dalam adegan ini, mode VR dapat dinonaktifkan dengan mengetuk keluar
, 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.