Unity için Geospatial Creator'ı kullanmaya başlama

1. Başlamadan önce

ARCore ve Google Haritalar Platformu tarafından desteklenen Geospatial Creator, Unity düzenleyicisinde artırılmış gerçeklik (AR) deneyimleri oluşturmanıza olanak tanır. Bu araç, deneyimin gerçek dünyada nasıl görüneceğini önizlemek için Google'ın Fotogerçekçi 3D Döşemeler API'sini kullanır. Bu sayede, söz konusu konumu fiziksel olarak ziyaret etmenize gerek kalmaz.

Bu codelab'de Geospatial Creator'ı kullanmaya başlayacaksınız. Hızlı başlangıç Unity projesini kurup düzenleyiciyi kullanmayı öğrenirsiniz. Ardından, sahneye bir öğe aktarıp bunu dünyanın dijital ikizine yerleştirirsiniz. Öğeye animasyon ekleyerek onu canlandırabilirsiniz. Son olarak, içeriği cihazınızda AR olarak görüntülersiniz.

Ön koşullar

• AR hakkında temel bilgi

Neler öğreneceksiniz?

• ARCore Geospatial Creator projesini Unity'de ayarlama
• Scene görünümünde gezinme
• Scene görünümüne 3D öğe yerleştirme
• Öğeye basit bir davranış ekleme
• AR deneyimini cihazınızda çalıştırma

İhtiyacınız olanlar

• Unity Hub'ın yüklü olması gerekir.
• Uygulama geliştirme için yapılandırılmış desteklenen bir Android veya iOS cihaz
• Android hedef cihazlar için Android Studio'nun yüklenip Android uygulamaları oluşturacak şekilde yapılandırılması ve Android geliştirme cihazına AR için Google Play Hizmetleri'nin yüklenmesi gerekir.
• iOS hedef cihazlar için Xcode.

2. Geliştirme ortamınızı kurma

Google Cloud'dan fotogerçekçi 3D döşeme verilerini almak için yetkilendirme ayarlamanız gerekir.

Google Cloud projesi oluşturun

1. Google Cloud Console'da proje oluşturun.
2. Proje adı metin kutusuna ARCore Geospatial API project gibi uygun bir ad girin ve ardından herhangi bir konumu seçin.
3. Oluştur'u tıklayın.
4. Proje seçici sayfasındaki Google Cloud Console'da Proje Oluştur'u tıklayın.

3D Tiles API'yi etkinleştirme

3D Tiles API'yi etkinleştirmek için aşağıdaki düğmeyi tıklayın ve Etkinleştir'i seçin:

3D Tiles API'yi etkinleştirme

ARCore API'yi etkinleştirme

ARCore API'yi etkinleştirmek için aşağıdaki düğmeyi tıklayın ve ardından Etkinleştir'i seçin:

ARCore API'yi etkinleştirme

Projeniz için API anahtarı oluşturma

1. Google Cloud Console'da API'ler ve hizmetler bölümünde Kimlik bilgileri'ni seçin.
2. Sayfanın üst kısmında Kimlik bilgileri oluştur'u tıklayın ve API anahtarı'nı seçin.
3. Sonraki adımlarda ihtiyacınız olacağından anahtarı not edin.

Yazılımı kurma

Geospatial Editor'ı kullanmaya başlamak için aşağıdaki adımları uygulayın:

1. Unity Hub'da Unity 2021.3.17f1 veya daha yeni bir sürümüyle 3D proje oluşturun.
2. Window > Package Manager'ı (Pencere > Paket Yöneticisi) tıklayın ve gerekli paketleri eklemek için şu adımları uygulayın:
   1. + > Git URL'sinden paket ekle > https://github.com/google-ar/arcore-unity-extensions.git'yı tıklayın.
   2. Örnekler'i tıklayın ve coğrafi örnekleri içe aktarın.
   3. Unity için Cesium'un en son sürümünü indirin ve ardından + > Add package from tarball > com.cesium.unity-1.0.0.tgz seçeneğini tıklayın.
3. Henüz yüklenmediyse Shader Graph'ı yüklemek için şu adımları uygulayın:
   1. In Project > Unity Registry'yi (Projede > Unity Kayıt Defteri) tıklayın.
   2. Shader Graph'i yükleyin.

ARCore nesneleriyle örnek sahneyi ayarlama

1. Project (Proje) panelinde Assets > Samples > ARCore Extensions > 1.37.0 > Geospatial Sample > Scenes > Geospatial'ı (Öğeler > Örnekler > ARCore Uzantıları > 1.37.0 > Coğrafi Uzamsal Örnek > Sahneler > Coğrafi Uzamsal) tıklayın.
2. Katmanlar'ı tıklayın ve kullanıcı arayüzü katmanını devre dışı bırakın.
3. Edit > Project Settings > XR Plug-in Management > ARCore Extensions'ı (Düzenle > Proje Ayarları > XR Eklenti Yönetimi > ARCore Uzantıları) tıklayın.
4. Hedef platformunuz için bir API anahtarı yetkilendirme stratejisi yapılandırın.
5. Geospatial ve Geospatial Creator isteğe bağlı özelliklerini etkinleştirin.
6. Hiyerarşi panelinde + > XR > Geospatial Creator Origin'i tıklayın.
7. Hiyerarşi panelinde AR Geospatial Creator Origin'i seçin.
8. Inspector panelindeki Geospatial Creator Origin bölümünde Add Cesium Georeference Component'ı (Cesium Coğrafi Referans Bileşeni Ekle) tıklayın.
9. Google Haritalar Döşeme API Anahtarı metin kutusuna API anahtarını girin ve Enter tuşuna (macOS'te return) basın.

3. Unity sahne görünümünde gezinme

Bu adımda, çevrenizdeki alanın 3D gösterimini görüntülersiniz.

3D görünümün konumunu değiştirme

3D fotogerçekçi döşemeler önizlemesinin konumunu yakınınızdaki bir alanla değiştirmek için aşağıdaki adımları uygulayın:

1. Hiyerarşi panelinde AR Geospatial Creator Origin oyun nesnesini seçin.
2. İnceleyici panelinde, Enlem ve Boylam değerlerini yakınınızdaki bir konumla değiştirmek için aşağıdaki adımları uygulayın:
   1. Yakınınızdaki bir konumu bulmak için Google Haritalar'ı kullanın.
   2. Haritayı sağ tıklayın ve sağlanan koordinatları seçerek bunları panonuza kopyalayın.
      Değerleri değiştirdikten sonra Sahne penceresindeki dünyanın 3D gösterimi değişir:
      

Görüntü alanı kamerasını kontrol etme

Coğrafi olarak sabitlenmiş içeriğinizi yerleştirmek istediğiniz yakınınızdaki bir konumu bulmak için aşağıdaki adımları uygulayın:

1. Kamerayı ileri ve geri hareket ettirmek için yukarı ve aşağı ok tuşlarını kullanın.
2. Görünümü kaydırmak için sol ve sağ ok tuşlarını kullanın.
3. Hareket ederken daha hızlı ilerlemek için Shift düğmesini basılı tutun.
4. Kaybolursanız Hiyerarşi panelinde AR Geospatial Creator Origin nesnesini seçin ve ardından görünümü yeniden ortalamak için F tuşuna basın.

4. 3D öğe içe aktarma ve yerleştirme

Size yakın bir konuma karar verdikten sonra, AR deneyiminizde görünen ve seçtiğiniz konumun yakınına sabitlenmiş bir öğe içe aktarmanız gerekir.

3D öğe içe aktarma

Bu codelab'de size yardımcı olmak için projenizde kullanabileceğiniz örnek bir öğe hazırladık.

Örnek öğeyi içe aktarmak için aşağıdaki adımları uygulayın:

1. Kaplan öğesini indirin.
2. ZIP arşivini çıkarın.
3. Öğeler > Yeni öğe içe aktar'ı tıklayın. Dört öğe projenize aktarılır.
4. Proje panelinde Kaplan modeli öğesini Sahne paneline sürükleyin.

Öğeyi yeniden boyutlandırın ve yeniden konumlandırın

Öğenizi doğru yere yerleştirmek için aşağıdaki adımları uygulayın:

1. Hiyerarşi panelinde Kaplan modeli öğesinin seçili olduğundan emin olun.
2. Scene görünümünde Ölçek aracı'nın etkin olduğundan emin olun ve ardından öğenin boyutunu tercihinize göre ayarlamak için beyaz küpü sürükleyin.
   
3. Scene görünümünde Taşıma aracı'nın etkinleştirildiğinden emin olun, ardından kırmızı, mavi veya yeşil kontrolleri seçip öğeyi yeniden konumlandırmak için farenizi sürükleyin. Renkli kontrollerden her biri belirli bir boyutu kilitler ve nesneleri bu eksen boyunca hareket ettirmenize olanak tanır.
   

Öğeyi coğrafi olarak sabitleme

İçeriğinizi gerçek dünyaya sabitlemek için şu adımları uygulayın:

1. Hiyerarşi panelinde Kaplan modeli öğesinin seçili olduğundan emin olun.
2. Inspector panelinde AR Geospatial Creator Anchor eklemek için Add Component'ı (Bileşen Ekle) tıklayın.

5. Öğenizi hayata geçirin

Unity düzenleyici, Unity ekosisteminin gücüyle keyifli artırılmış gerçeklik deneyimleri programlamanıza olanak tanır.

Başlangıç projesinde sağlanan animasyonlardan birini kullanarak kaplanı döngü halinde canlandırmak için aşağıdaki adımları uygulayın:

1. Hiyerarşi panelinde Kaplan modeli'ni seçin.
2. Animasyon eklemek için Bileşen Ekle'yi tıklayın.
3. Animator bölümünde bir Controller seçin ve sağlanan Tiger idle animation controller öğesini kullanın.

6. Öğeyi AR'de görüntüleme

Son olarak, öğeyi ARCore destekli Android veya iOS cihazınızda AR olarak görüntülersiniz.

Uygulamayı cihazınızda çalıştırma

1. Dosya > Derleme Ayarları'nı tıklayın ve ardından Android veya iOS derleme platformlarını seçin.
2. Platformu değiştir'i tıklayın.
3. Oynatıcı ayarlarını yapılandırmak için ek adımları uygulayın.
4. Geliştirme cihazınızın bağlı olduğundan ve geliştirme için yapılandırıldığından emin olun.
5. Oluştur ve çalıştır'ı tıklayın.

7. Sonuç

Tebrikler! Geospatial Creator'ı Unity'de kullanarak Geospatial AR deneyimi oluşturmayı öğrendiniz.

Daha fazla bilgi

• Google Developers'da Unity için Geospatial Creator