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.

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

Bir cep telefonunu VR platformuna dönüştürmek için Cardboard SDK'sını kullanabilirsiniz. Akıllı telefonlar, 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.

Not: <version>, yayınlanan paketin X.Y.Z semantik 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, Açık Sahne Ekle'yi 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. "Etkileşimli" adlı yeni bir katman tanımlayın.
4. İnceleyici 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. "Karton nişangah işaretçisi" komut dosyasında, Nişangah Etkileşimi Katmanı Maskesi olarak "Etkileşimli"yi seçin.

Android proje 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ı

Çözüm ve Sunum

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

1. Varsayılan Yön'ü Sol Yatay veya Sağ Yatay olarak ayarlayın.
2. Optimize çerçeve aralığı'nı devre dışı bırakın.

Not: Cardboard XR eklentisi tarafından desteklenen Dikey ve Yukarı Aşağı Dikey yönleri, cihazlarda göz oluşturma için yeterli alan sağlamayabilir.

Diğer Ayarlar

Proje Ayarları > 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 bölümü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 bölümünde 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 doku sıkıştırma biçiminde ETC2 seçeneğini belirleyin.
10. Unity sürümü 2023.1 veya daha yeniyse Uygulama Giriş Noktası'nda Activity'yi seçip GameActivity'yi temizleyin.

Not: Oluşturma API'si uyumluluğunu değiştirerek daha düşük bir minimum API seviyesi kullanabilirsiniz. Daha fazla bilgi için SDK'nın build.gradle sayfasına bakın.

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

Not: OpenGL ES 2.0, Unity 2023.1 ve sonraki sürümlerde artık desteklenmiyor. 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 uyumluluğu sayfasına bakın.

Yayınlama Ayarları

Proje Ayarları > 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
   

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 deposunun sdk/build.gradle dosyasında bağımlılıklar bölümünün geçmişine göz atın.

XR Eklentisi Yönetim Ayarları

Proje Ayarları > 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ı

Çözüm ve Sunum

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

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

Not: Cardboard XR eklentisi tarafından desteklenen Dikey ve Yukarı Aşağı Dikey yönleri, cihazlarda göz oluşturma için yeterli alan sağlamayabilir.

Diğer Ayarlar

Proje Ayarları > 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.

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

XR Eklentisi Yönetim Ayarları

Proje Ayarları > 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.

Yeniden odaklama

Cardboard SDK, Recenter() düğmesini kullanarak kafa takip cihazını yeniden odaklamanıza 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ış 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

• Cardboard markalaşma yönergelerini inceleyin.