Panduan Memulai untuk Google Cardboard untuk Unity

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

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

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

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

• Menyiapkan lingkungan pengembangan
• Mendownload dan membangun aplikasi demo
• Pindai kode QR pada penampil Cardboard untuk menyimpan parameternya
• Melacak gerakan kepala pengguna
• Merender gambar stereoskopis dengan menyetel distorsi yang benar untuk setiap mata
• Mengaktifkan dan menonaktifkan mode VR

Menyiapkan lingkungan pengembangan

Persyaratan perangkat lunak:

• Unity 2021.3.32f1 atau yang lebih baru
  • Pastikan untuk menyertakan Dukungan Build Android dan iOS selama penginstalan.
• Git harus diinstal dan file git yang dapat dieksekusi harus berada di variabel lingkungan PATH. Lihat dokumen dukungan git pengelola paket Unity untuk mengetahui detail selengkapnya.

Mengimpor SDK dan membuat project baru

Ikuti langkah-langkah ini 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. Tempel 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.
   Contoh aset 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 Lapisan dan pilih Edit Lapisan....
3. Tentukan lapisan baru bernama "Interactive".
4. Klik GameObject Treasure untuk membuka jendela Inspector. Tetapkan lapisannya menjadi "Interactive". Jika jendela pop-up muncul dan menanyakan apakah Anda juga ingin menetapkan lapisan ke Interactive untuk semua objek turunan, klik "Yes, change turunan".
5. Klik GameObject Player > Camera > CardboardReticlePointer untuk membuka jendela Inspector. Di 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

Resolusi dan Presentasi

Buka Project Settings > Player > Resolution and Presentation.

1. Tetapkan Orientasi Default ke Landscape Left atau Landscape Right.
2. Nonaktifkan 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 kombinasinya 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 API Level Target.
4. Pilih IL2CPP di Scripting Backend.
5. Pilih arsitektur yang diinginkan dengan memilih ARMv7, ARM64, atau keduanya di Target Architectures.
6. Pilih Require di Internet Access.
7. Tentukan domain perusahaan Anda di bagian Package Name.
8. Jika Vulkan dipilih sebagai Graphics API:
   • Hapus centang pada kotak centang Apply displayRotation during rendering di Setelan Vulkan.
   • Jika versi Unity adalah 2021.2 atau yang lebih baru, pilih ETC2 dalam Texture compression format.
9. Jika versi Unity adalah 2023.1 atau yang lebih baru, pilih Activity dan hapus GameActivity di Titik Entri Aplikasi.

Catatan: Anda dapat menggunakan level API 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 grafis, centang kotak Development Build di Build Settings dan analisis log runtime yang 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. Untuk informasi selengkapnya, lihat halaman Persyaratan dan kompatibilitas Android dalam panduan Unity.

Setelan Publikasi

Buka Project Settings > 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.6.1'
     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 dengan rilis terbaru, lihat histori bagian dependensi di sdk/build.gradle repositori Cardboard SDK.

Pengaturan Pengelolaan Plugin XR

Buka Project Settings > XR Plug-in Management.

1. Pilih Cardboard XR Plugin di bagian Plug-in Providers.

Mem-build project Anda

Buka File > Build Settings.

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

Mengonfigurasi setelan project iOS

Buka File > Build Settings.

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

Player Settings

Resolusi dan Presentasi

Buka Project Settings > Player > Resolution and Presentation.

1. Tetapkan Orientasi Default ke Landscape Left atau Landscape Right.

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 bagian Camera Usage Description, tulis Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters)..
2. Pada Target versi iOS minimum, 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.

Pengaturan Pengelolaan Plugin XR

Buka Project Settings > XR Plug-in Management.

1. Pilih Cardboard XR Plugin di bagian Plug-in Providers.

Mem-build project Anda

Buka File > Build Settings.

1. Pilih Build atau Build and Run.

Memusatkan kembali

Cardboard SDK memungkinkan Anda menyusun ulang pelacak kepala menggunakan Recenter().

Ikuti langkah-langkah berikut untuk mencobanya menggunakan aplikasi contoh:

1. Pindahkan perangkat ke posisi yang ingin Anda lebih kekan lagi (gunakan sebagai pose kepala ke depan yang baru).
2. Tahan pemicu perangkat Cardboard Anda yang aktif minimal selama tiga detik.
3. Lepaskan pemicu.
4. Pose awal sekarang berada dalam arah yang ditunjuk kamera.

Mengaktifkan dan menonaktifkan mode VR

Unity XR Plugin Management API memungkinkan Anda mengaktifkan atau menonaktifkan mode VR untuk Plugin Google Cardboard XR 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 adegan ini, mode VR dapat dinonaktifkan dengan mengetuk keluar , dan dapat diaktifkan lagi cukup dengan mengetuk di mana saja pada layar. Lihat VrModeController.cs untuk mengetahui detail tentang cara melakukannya.

Langkah berikutnya

• Tinjau pedoman branding Cardboard.