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 Google Cardboard XR Plugin for Unity'yi nasıl kullanacağınız gösterilmektedir.

Not: Uygulamanızı daha geniş bir kitleye dağıtmadan önce Cardboard markalama yönergelerini incelediğinizden emin olun.

Cardboard SDK'sını kullanarak cep telefonunu VR platformuna dönüştürebilirsiniz. Mobil cihazlar, stereoskopik oluşturma ile 3D sahneler gösterebilir, baş hareketlerini takip edip bunlara tepki verebilir ve kullanıcının görüntüleyici düğmesine bastığını algılayarak uygulamalarla etkileşimde bulunabilir.

Başlamak için HelloCardboard'u kullanacaksınız. Bu demo oyunda Cardboard SDK'nın temel özellikleri gösterilir. Oyunda kullanıcılar, nesneleri bulup toplamak için sanal bir dünyada etraflarına bakarlar. Bu rehberde, aşağıdakileri nasıl yapacağınız açıklanmaktadır:

• Geliştirme ortamınızı kurma
• Demo uygulamasını indirip oluşturma
• Parametrelerini kaydetmek için Cardboard görüntüleyicinin QR kodunu tarayın
• Kullanıcının baş 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 sonraki sürümler
  • Yükleme sırasında Android ve iOS Build Support'u eklediğinizden emin olun.
  • 44f1 veya sonraki bir yama sürümünü yüklediğinizden emin olun.
• Git yüklenmiş olmalı ve git yürütülebilir dosyası PATH ortam değişkeninde bulunmalı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çın ve yeni bir 3D proje oluşturun.
2. Unity'de Window (Pencere) > Package Manager'a (Paket Yöneticisi) gidin.
3. + işaretini tıklayın ve Paketi Git URL'sinden 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. Google Cardboard XR Plugin for Unity paketine gidin. Örnekler bölümünde Projeye aktar'ı seçin.
   Örnek öğeler Assets/Samples/Google Cardboard/<version>/Hello Cardboard'e yüklenmelidir.

Not: <version>, yayınlanan paketin X.Y.Z anlamsal sürüm numarasıdır (örneğin, 1.1.0).

HelloCardboard sahnesini yapılandırma

1. Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes simgesine gidin, Add Open Scenes'i (Açık Sahneler Ekle) seçin ve örnek sahneyi açmak için HelloCardboard'u seçin.
2. Katmanlar menüsünü açıp Katmanları Düzenle...'yi seçin.
3. "Interactive" adlı yeni bir katman tanımlayın.
4. Inspector penceresini açmak için Treasure GameObject'i tıklayın. Katmanını "Etkileşimli" olarak ayarlayın. Tüm alt nesneler için de katmanı 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. Inspector penceresini açmak için Player > Camera > CardboardReticlePointer GameObject'i tıklayın. "Cardboard reticle pointer" (Cardboard retikül işaretçisi) komut dosyasında Reticle Interaction Layer Mask (Retikül Etkileşim Katmanı Maskesi) olarak "Interactive" (Etkileşimli) seçeneğini belirleyin.

Android derleme ayarlarını yapılandırma

File (Dosya) > Build Settings'e (Derleme Ayarları) gidin.

1. Android'i seçin ve Platformu Değiştir'i tıklayın.
2. Add Open Scenes'i (Açık Sahneler Ekle) seçin ve HelloCardboard'u (MerhabaCardboard) tercih edin.

Oynatıcı Ayarları

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

Çözünürlük ve sunu 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ızı'nı devre dışı bırakın.

Not: Cardboard XR eklentisi tarafından desteklenmesine rağmen Dikey ve Ters Dikey yönleri, cihazlarda göz oluşturma için yeterli alan sağlamayabilir.

Diğer ayarları yapılandırma

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

1. Grafik API'leri'nde OpenGLES2, OpenGLES3 veya Vulkan ya da bunların herhangi bir kombinasyonunu seçin.
2. Minimum API Düzeyi'nde Android 8.0 'Oreo' (API level 26) veya üstünü seçin.
3. Hedef API Düzeyi'nde API level 35 veya üstünü seçin.
4. Scripting Backend'de IL2CPP simgesini seçin.
5. Hedef Mimariler bölümünde ARMv7, ARM64 veya her ikisini de seçerek istediğiniz mimarileri belirleyin.
6. İnternet Erişimi'nde Require simgesini seçin.
7. Active Input Handling (Aktif 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, Grafik API'si 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 sonraki bir sürümse Texture compression format bölümünde ETC2 simgesini seçin.
10. Unity sürümü 2023.1 veya sonraki bir sürümse Activity seçeneğini belirleyin ve Application Entry Point'te GameActivity işaretini kaldırın.

Not: Oluşturma API'si uyumluluğunu değiştirerek daha düşük bir minimum API düzeyi kullanmak mümkündür. Daha fazla bilgi için SDK'nın build.gradle bölümüne bakın.

Not: Grafik API'si olarak Vulkan'ı seçerken sorun yaşıyorsanız Build Settings bölümünde Development Build kutusunu işaretleyin ve sürücü uyumluluğu hatalarını arayarak çalışma zamanı günlüklerini analiz edin.

Not: OpenGL ES 2.0 artık Unity 2023.1 ve sonraki sürümlerde desteklenmemektedir. Daha yeni sürümlerde bunun yerine OpenGL ES 3.0 veya Vulkan'ı kullanın. Daha fazla bilgi için Unity kılavuzundaki Android gereksinimleri ve uyumluluk sayfasını inceleyin.

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

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

1. Oluştur bölümünde Custom Main Gradle Template ve Custom Gradle Properties Template simgelerini seçin.

2. Assets/Plugins/Android/mainTemplate.gradle dosyasının bağımlılıklar 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
   

Not: Gerekli bağımlılıklar sürümler arasında değişebilir. En son sürümden farklı bir sürüm kullanmak istiyorsanız Cardboard SDK deposundaki sdk/build.gradle dosyasında bağımlılıklar bölümünün geçmişine göz atın.

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

XR Plug-in Management'a (XR Eklenti Yönetimi) gidin.

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

Projenizi oluşturma

File (Dosya) > Build Settings'e (Derleme Ayarları) gidin.

1. Oluştur'u seçin veya bir cihaz seçip Oluştur ve Çalıştır'ı seçin.

iOS proje ayarlarını yapılandırma

File (Dosya) > Build Settings'e (Derleme Ayarları) gidin.

1. iOS'i seçin ve Platformu Değiştir'i tıklayın.
2. Add Open Scenes'i (Açık Sahneler Ekle) seçin ve HelloCardboard'u (MerhabaCardboard) tercih edin.

Oynatıcı Ayarları

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

Çözünürlük ve sunu 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.

Not: Cardboard XR eklentisi tarafından desteklenmesine rağmen Dikey ve Ters Dikey yönleri, cihazlarda göz oluşturma için yeterli alan sağlamayabilir.

Diğer ayarları yapılandırma

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

1. Kamera Kullanımı Açıklaması bölümüne 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ü bölümüne 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'yi işaretleyin.

Not: iPhone X kullanıyorsanız iPhone X'te ana sayfa düğmesini gizle seçeneğini belirleyin.

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

XR Plug-in Management'a (XR Eklenti Yönetimi) gidin.

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

Projenizi oluşturma

File (Dosya) > Build Settings'e (Derleme Ayarları) gidin.

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

Ortala

Cardboard SDK, Recenter() kullanarak baş takip cihazını yeniden ortalamanıza olanak tanır.

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

1. Cihazı yeniden ortalamak istediğiniz konuma getirin (yeni bir ileriye bakma başı pozu olarak kullanın).
2. Cardboard cihazınızın tetiğini en az üç saniye boyunca etkin tutun.
3. Tetiği bırakın.
4. İlk poz artık kameranın yönünde.

VR modunu açma ve kapatma

Unity XR Plugin Management API, Google Cardboard XR Plugin for Unity'de VR modunu etkinleştirmenize veya devre dışı bırakmanıza olanak tanır. Son kullanıcı dokümanları ve kullanım örnekleri Unity'nin Son kullanıcı dokümanlarında mevcuttur.

HelloCardboard örneğindeki VrMode sahnesi, yukarıda bahsedilen API'nin temel kullanımını gösterir. Bu sahnede, çıkış'a dokunarak VR modu devre dışı bırakılabilir ve ekranda herhangi bir yere dokunarak tekrar etkinleştirilebilir. Bunun nasıl yapıldığıyla ilgili ayrıntılar için VrModeController.cs dosyasını inceleyin.

Sonraki adımlar

• Cardboard markalama kurallarını inceleyin.