Unity için Google Cardboard hızlı başlangıç kılavuzu

Bu kılavuzda, kendi sanal gerçeklik (VR) deneyimlerinizi oluşturmak için Unity'de Unity için Google Cardboard XR Eklentisi'ni nasıl kullanacağınız gösterilmektedir.

Bir cep telefonunu VR platformuna dönüştürmek için Cardboard SDK'sını kullanabilirsiniz. Mobil cihazlar, stereoskopik oluşturma ile 3D sahneler gösterebilir, kafa hareketlerini izleyip bunlara tepki verebilir ve kullanıcının görüntüleyici düğmesine bastığını algılayarak uygulamalarla etkileşim kurabilir.

Başlamak için Cardboard SDK'sının temel özelliklerini gösteren bir demo oyun olan HelloCardboard'u kullanacaksınız. Oyunda kullanıcılar, sanal bir dünyada nesneleri bulup toplamak için etrafa bakar. Bu rehberde aşağıdakiler açıklanmaktadır:

  • Geliştirme ortamınızı kurma
  • Demo uygulamasını indirip derleme
  • Parametrelerini kaydetmek için Cardboard görüntüleyicinin QR kodunu tarayın
  • Kullanıcının kafa hareketlerini izleme
  • Her göz için doğru bozulmayı ayarlayarak stereoskopik görüntüler oluşturma
  • VR modunu açma ve kapatma

Geliştirme ortamınızı kurma

Yazılım gereksinimleri:

  • Unity 2021.3.44f1 veya üzeri
    • Yükleme sırasında Android ve iOS derleme desteğini eklediğinizden emin olun.
    • 44f1 veya sonraki bir yamayı yüklediğinizden emin olun.
  • Git yüklü olmalı ve git yürütülebilir dosyası PATH ortam değişkeninde olmalıdır. Daha fazla bilgi için Unity'nin paket yöneticisi git desteği belgelerine bakın.

SDK'yı içe aktarma ve yeni proje oluşturma

Unity SDK'sını içe aktarmak ve yeni bir proje oluşturmak için aşağıdaki adımları uygulayın.

  1. Unity'yi açıp yeni bir 3D proje oluşturun.
  2. Unity'de Pencere > Paket Yöneticisi'ne gidin.
  3. + simgesini tıklayın ve Git URL'sinden paket ekle'yi seçin.
  4. https://github.com/googlevr/cardboard-xr-plugin.git simgesini metin giriş alanına yapıştırın.
    Paket, yüklü paketlere eklenmelidir.
  5. Unity için Google Cardboard XR Eklentisi paketine gidin. Sana Özel bölümünde Projeye aktar'ı seçin.
    Örnek öğeler Assets/Samples/Google Cardboard/<version>/Hello Cardboard'e yüklenmelidir.

HelloCardboard sahnesini yapılandırma

  1. Sana Özel'e gidin, Açık Sahne Ekle'yi seçin ve örnek sahneyi açmak için HelloCardboard'u seçin.Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes
  2. Katmanlar menüsünü açıp Katmanları Düzenle...'yi seçin.
  3. "Etkileşimli" adlı yeni bir katman tanımlayın.
  4. İnceleme penceresini açmak için Hazine oyun nesnesini tıklayın. Katmanını "Etkileşimli" olarak ayarlayın. Katmanı tüm alt nesneler için de Etkileşimli olarak ayarlamak isteyip istemediğinizi soran bir pop-up pencere gösterilirse "Evet, alt öğeleri değiştir"i tıklayın.
  5. İnceleyici penceresini açmak için Oyuncu > Kamera > CardboardReticlePointer oyun nesnesini tıklayın. "Cardboard nişangah işaretçisi" komut dosyasında, Nişangah Etkileşimi Katmanı Maskesi olarak "Etkileşimli"yi seçin.

Android derleme ayarlarını yapılandırma

Dosya > Derleme Ayarları'na gidin.

  1. Android'i ve Platformu Değiştir'i seçin.
  2. Açık Sahne Ekle'yi seçin ve HelloCardboard'u seçin.

Oynatıcı Ayarları

Düzenle > Proje Ayarları...'na gidin.

Çözünürlük ve sunum ayarlarını yapılandırma

Oynatıcı > Çözünürlük ve Sunum'a gidin.

  1. Varsayılan Yön'ü Yatay Sol veya Yatay Sağ olarak ayarlayın.
  2. Optimize edilmiş kare hızlandırma'yı devre dışı bırakın.

Diğer ayarları yapılandırma

Oynatıcı > Diğer Ayarlar'a gidin.

  1. Grafik API'leri bölümünde OpenGLES2, OpenGLES3 veya Vulkan'yi ya da bunların herhangi bir kombinasyonunu seçin.
  2. Minimum API Düzeyi'nde Android 8.0 'Oreo' (API level 26) veya daha yüksek bir sürüm seçin.
  3. Hedef API Düzeyi'nde API level 33 veya daha yüksek bir düzey seçin.
  4. Komut Dosyası Arka Ucu'nda IL2CPP simgesini seçin.
  5. Hedef Mimariler bölümünde ARMv7, ARM64 veya ikisini birden seçerek istediğiniz mimarileri belirleyin.
  6. İnternet Erişimi bölümünde Require simgesini seçin.
  7. Etkin Giriş İşleme bölümünde Input System Package (New) simgesini seçin.
  8. Paket Adı bölümünde şirket alanınızı belirtin.
  9. Vulkan, Graphics API olarak seçildiyse:
    • Vulkan Ayarları'nda Oluşturma sırasında ekran döndürmeyi uygula onay kutusunun işaretini kaldırın.
    • Unity sürümü 2021.2 veya daha yeniyse dokunma sıkıştırma biçimi bölümünde ETC2'yi seçin.
  10. Unity sürümü 2023.1 veya daha yeniyse Uygulama Giriş Noktası'nda Activity'yi seçip GameActivity'yi temizleyin.

Yayınlama ayarlarını yapılandırma

Oynatıcı > Yayınlama Ayarları'na gidin.

  1. Derleme bölümünde Custom Main Gradle Template ve Custom Gradle Properties Template simgesini seçin.

  2. Assets/Plugins/Android/mainTemplate.gradle dosyasının dependencies bölümüne aşağıdaki satırları ekleyin:

      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 dosyasına aşağıdaki satırları ekleyin:

      android.enableJetifier=true
  android.useAndroidX=true

XR Eklenti Yönetimi ayarlarını yapılandırma

XR Eklentisi Yönetimi'ne gidin.

  1. Eklenti Sağlayıcıları bölümünde Cardboard XR Plugin simgesini seçin.

Projenizi oluşturma

Dosya > Derleme Ayarları'na gidin.

  1. Derle'yi veya bir cihaz seçip Derle ve Çalıştır'ı seçin.

iOS proje ayarlarını yapılandırma

Dosya > Derleme Ayarları'na gidin.

  1. iOS'i ve Platform Değiştir'i seçin.
  2. Açık Sahne Ekle'yi seçin ve HelloCardboard'u seçin.

Oynatıcı Ayarları

Düzenle > Proje Ayarları...'na gidin.

Çözünürlük ve sunum ayarlarını yapılandırma

Oynatıcı > Çözünürlük ve Sunum'a gidin.

  1. Varsayılan Yön'ü Yatay Sol veya Yatay Sağ olarak ayarlayın.

Diğer ayarları yapılandırma

Oynatıcı > Diğer Ayarlar'a gidin.

  1. Kamera Kullanımı Açıklaması'na Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters). yazın.
  2. Hedef minimum iOS sürümü alanına 12.0 yazın.
  3. Paket Adı bölümünde şirket alanınızı belirtin.
  4. Kenarlarda sistem hareketlerini ertele bölümünde Top Edge, Left Edge ve Right Edge seçeneklerini işaretleyin.

XR Eklenti Yönetimi ayarlarını yapılandırma

XR Eklentisi Yönetimi'ne gidin.

  1. Eklenti Sağlayıcıları bölümünde Cardboard XR Plugin simgesini seçin.

Projenizi oluşturma

Dosya > Derleme Ayarları'na gidin.

  1. Derle veya Derle ve Çalıştır'ı seçin.

Ortala

Cardboard SDK, Recenter() düğmesini kullanarak kafa takibini yeniden merkezlemenize olanak tanır.

Örnek uygulamayı kullanarak denemek için aşağıdaki adımları uygulayın:

  1. Cihazı yeniden odaklamak istediğiniz konuma taşıyın (yeni öne bakan kafa pozu olarak kullanın).
  2. Cardboard cihazınızın tetikleyicisini en az üç saniye boyunca basılı tutun.
  3. Tetikleyiciyi bırakın.
  4. İlk poz, kameranın baktığı yöndedir.

VR modunu açma ve kapatma

Unity XR Eklenti Yönetimi API'si, Unity için Google Cardboard XR Eklentisi'nde VR modunu etkinleştirmenize veya devre dışı bırakmanıza olanak tanır. Son kullanıcı dokümanları ve kullanım örneklerini Unity'nin Son kullanıcı dokümanlarında bulabilirsiniz.

HelloCardboard örneğindeki VrMode sahnesi, yukarıda belirtilen API'nin temel kullanımını gösterir. Bu sahnede, çıkış X düğmesi seçeneğine dokunarak VR modunu kapatabilir ve ekranın herhangi bir yerine dokunarak tekrar açabilirsiniz. Bunun nasıl yapıldığıyla ilgili ayrıntılar için VrModeController.cs dosyasını inceleyin.

Sonraki adımlar