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

Bu kılavuzda, kendi Sanal Gerçeklik (VR) deneyimlerinizi oluşturmak amacıyla Unity için Unity için Google Cardboard XR Eklentisi'nin nasıl kullanılacağı gösterilmektedir.

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

Cep telefonunu sanal gerçeklik platformuna dönüştürmek için Cardboard SDK'sını kullanabilirsiniz. Akıllı telefonlar, stereoskopik görüntü oluşturma, kafa hareketlerini takip etme ve bunlara tepki verme ve kullanıcının gözlük düğmesine ne zaman bastığını algılayarak uygulamalarla etkileşime geçme gibi özelliklere sahip 3D sahneler görüntüleyebilir.

Başlamak için, Cardboard SDK'sının temel özelliklerini gösteren bir demo oyun olan HelloCardboard'u kullanırsınız. Oyunda, kullanıcılar nesneleri bulup toplamak için sanal bir dünyada gezinirler. Bu bölümde şunları nasıl yapacağınız gösterilmektedir:

• Geliştirme ortamınızı ayarlama
• Demo uygulamayı indirme ve oluşturma
• Parametrelerini kaydetmek için bir Cardboard gözlüğün QR kodunu tarayın
• Kullanıcının kafa hareketlerini izleme
• Her bir göz için doğru distorsiyonu ayarlayarak stereoskopik resimler oluşturun
• VR modunu açma ve kapatma

Geliştirme ortamınızı ayarlama

Yazılım gereksinimleri:

• Unity 2021.3.32f1 veya sonraki sürümler
  • Yükleme sırasında Android ve iOS Derleme Desteği'ni eklediğinizden emin olun.
• Git yüklenmeli ve git yürütülebilir dosyası PATH ortam değişkeninde olmalıdır. Daha fazla ayrıntı için Unity'nin paket yöneticisi gitsupport belgelerine bakın.

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

Unity SDK'yı 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 projesi 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. Metin girişi alanına https://github.com/googlevr/cardboard-xr-plugin.git kodunu yapıştırın.
   Paket, yüklü paketlere eklenmelidir.
5. Unity için Google Cardboard XR Eklentisi paketine gidin. Örnekler bölümünde Projeye Aktar'ı seçin.
   Örnek öğeler Assets/Samples/Google Cardboard/<version>/Hello Cardboard konumuna 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. Örnek sahneyi açmak için Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes konumuna gidin, Add Open Scenes (Açık Sahne Ekle) öğesini ve HelloCardboard'u seçin.
2. Katmanlar menüsünü açın ve Katmanları Düzenle... seçeneğini belirleyin.
3. "Etkileşimli" adlı yeni bir katman tanımlayın.
4. Denetleyici penceresini açmak için Treasure GameObject'i tıklayın. Katmanını "Etkileşimli" olacak şekilde ayarlayın. Katmanı tüm alt nesneler için de Etkileşimli olarak ayarlamak isteyip istemediğinizi soran bir pop-up pencere açılırsa "Evet, alt öğeleri değiştir"i tıklayın.
5. Denetleyici penceresini açmak için Oynatıcı > Kamera > CardboardReticlePointer GameObject öğesini tıklayın. "Carboard retikle işaretçisi" komut dosyasında Reticle Etkileşim Katmanı Maskesi olarak "Etkileşimli"yi seçin.

Android proje ayarlarını yapılandırma

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

1. Android'i, ardından Platformu Değiştir'i seçin.
2. Add Open Scenes'i (Açık Sahne Ekle) ve HelloCardboard'u seçin.

Oynatıcı Ayarları

Çözünürlük ve Sunum

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

1. Varsayılan Yön'ü Yatay Sol veya Yatay Sağ olarak ayarlayın.
2. Optimize Edilmiş Çerçeve İlerleme Hızı'nı devre dışı bırakın.

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

Diğer Ayarlar

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

1. OpenGLES2, OpenGLES3 veya Vulkan ya da Grafik API'lerinde 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 33 veya üstünü seçin.
4. Komut Dosyası Arka Ucu'nda IL2CPP'yi seçin.
5. Hedef Mimariler'de ARMv7, ARM64 veya her ikisini birden seçerek istediğiniz mimarileri belirleyin.
6. İnternet Erişimi'nde Require'yi seçin.
7. Paket Adı bölümünde şirket alanınızı belirtin.
8. Graphics API olarak Vulkan seçildiyse:
   • Vulkan Ayarları'nda Oluşturma sırasında ekran döndürmesini uygula onay kutusunun işaretini kaldırın.
   • Unity sürümü 2021.2 veya sonraki bir sürümdeyse Doku sıkıştırma biçiminde ETC2'yi seçin.
9. Unity sürümü 2023.1 veya sonraki bir sürümse Application Entry Point'te (Uygulama Giriş Noktası) Activity öğesini seçip GameActivity seçimini 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ündeki Development Build kutusunu işaretleyin ve sürücü uyumluluk hataları olup olmadığını görmek için çalışma zamanı günlüklerini analiz edin.

Not: OpenGL ES 2.0 artık desteklenmemektedir.Unity 2023 ve üzeri sürümlerde desteklenmez. Bunun yerine OpenGL ES 2.0 desteklenmemektedir. Daha fazla bilgi için Unity kılavuzundaki Android gereksinimleri ve uyumluluk sayfasına bakın.

Yayınlama Ayarları

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

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

2. Aşağıdaki satırları Assets/Plugins/Android/mainTemplate.gradle öğesinin bağımlılıklar bölümüne 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.6.1'
     implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
   

3. Aşağıdaki satırları Assets/Plugins/Android/gradleTemplate.properties kampanyasına ekleyin:

     android.enableJetifier=true
     android.useAndroidX=true
   

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

XR Eklentisi Yönetim Ayarları

Proje Ayarları > XR Eklenti Yönetimi'ne gidin.

1. Eklenti Sağlayıcılar altında Cardboard XR Plugin'yi seçin.

Projenizi oluşturun

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

1. Build'i (Derle) seçin veya bir cihaz seçip Build and Run'ı (Derle ve Çalıştır) seçin.

iOS proje ayarlarını yapılandırma

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

1. iOS'u ve Platformu Değiştir'i seçin.
2. Add Open Scenes'i (Açık Sahne Ekle) ve HelloCardboard'u seçin.

Oynatıcı Ayarları

Çözünürlük ve Sunum

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

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

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

Diğer Ayarlar

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

1. Kamera Kullanımı Açıklaması alanı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 Eklenti Yönetimi'ne gidin.

1. Eklenti Sağlayıcılar altında Cardboard XR Plugin'yi seçin.

Projenizi oluşturun

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

1. Build (Derle) veya Build and Run (Derleme ve Çalıştır) seçeneğini belirleyin.

Yeniden ortalama

Cardboard SDK'sı, Recenter() kullanarak baş izleyiciyi yeniden ortalamanızı sağlar.

Örnek uygulamayı kullanarak denemek için şu adımları uygulayın:

1. Cihazı yeniden ortalamak istediğiniz konuma götürün (yeni bakan baş duruşu olarak kullanın).
2. Cardboard cihazınızın tetiğini en az üç saniye aktif halde tutun.
3. Tetikleyiciyi bırakın.
4. İlk poz artık kameranın işaret ettiği yöndedir.

VR modunu açma ve kapatma

Unity XR Plugin Management API, Unity için Google Cardboard XR Eklentisi'nde VR modunu açıp kapatmanıza olanak tanır. Son kullanıcı belgeleri ve kullanım örnekleri, Unity'nin Son kullanıcı belgelerinde bulunabilir.

HelloCardboard örneğindeki VrMode sahnesi, gelişmiş API'nin temel kullanımını gösterir. Bu sahnede VR modu, çıkış düğmesine dokunarak kapatılabilir ve ekranda herhangi bir yere dokunularak tekrar açılabilir. Bunun nasıl yapıldığıyla ilgili ayrıntılar için VrModeController.cs sitesini kontrol edin.

Sonraki adımlar

• Cardboard markalama kurallarını inceleyin.