Panduan Memulai untuk Google Cardboard untuk Unity

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 lingkungan PATH. 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.

  1. Buka Unity dan buat project 3D baru.
  2. Di Unity, buka Window > Package Manager.
  3. Klik +, lalu pilih Tambahkan paket dari URL git.
  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 Google Cardboard XR Plugin for Unity. Di bagian Samples, pilih Import into Project.
    Aset contoh harus dimuat ke dalam Assets/Samples/Google Cardboard/<version>/Hello Cardboard.

Mengonfigurasi adegan HelloCardboard

  1. Buka Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes, pilih Add Open Scenes, lalu pilih HelloCardboard untuk membuka adegan contoh.
  2. Buka menu Lapisan, lalu pilih Edit Lapisan....
  3. Tentukan lapisan baru bernama "Interaktif".
  4. 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".
  5. 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.

  1. Pilih Android, lalu pilih Switch Platform.
  2. Pilih Tambahkan Adegan Terbuka, lalu pilih HelloCardboard.

Player Settings

Buka Edit > Project Settings....

Mengonfigurasi setelan Resolusi dan Presentasi

Buka Player > Resolution and Presentation.

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

Mengonfigurasi Setelan lainnya

Buka Player > Other Settings.

  1. Pilih OpenGLES2, OpenGLES3, atau Vulkan, atau kombinasi apa pun di Graphics API.
  2. Pilih Android 8.0 'Oreo' (API level 26) atau yang lebih tinggi di Minimum API Level.
  3. Pilih API level 35 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 Penanganan Input Aktif.
  8. Tentukan domain perusahaan Anda di bagian Package Name.
  9. Jika Vulkan dipilih sebagai Graphics API:
    • Hapus centang Terapkan rotasi tampilan selama rendering di Setelan Vulkan.
    • Pilih ETC2 di Texture compression format.
  10. Pilih Activity dan hapus GameActivity di Titik Entri Aplikasi.

Mengonfigurasi setelan Publikasi

Buka Player > Publishing Settings.

  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
    

Mengonfigurasi setelan Pengelolaan Plug-in XR

Buka 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 Tambahkan Adegan Terbuka, lalu pilih HelloCardboard.

Player Settings

Buka Edit > Project Settings....

Mengonfigurasi setelan Resolusi dan Presentasi

Buka Player > Resolution and Presentation.

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

Mengonfigurasi Setelan lainnya

Buka Player > Other Settings.

  1. Di Deskripsi Penggunaan Kamera, 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.
  4. Periksa Top Edge, Left Edge, dan Right Edge di Tunda gestur sistem di tepi.

Mengonfigurasi setelan Pengelolaan Plug-in XR

Buka 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.

Tengahkan 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 melihat ke depan yang baru).
  2. Tahan pemicu perangkat Cardboard Anda agar tetap aktif selama minimal tiga detik.
  3. Lepaskan pemicu.
  4. 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 Tombol X, dan dapat diaktifkan kembali hanya dengan mengetuk di mana saja pada layar. Periksa VrModeController.cs untuk mengetahui detail tentang cara melakukannya.

Langkah berikutnya