Android Emülatör'de Artırılmış Gerçeklik (AR) Uygulamalarını Çalıştırma

Fiziksel cihaz olmadan AR senaryolarını test etmek için Android Emulator'u kullanın. Android Emulator, ARCore uygulamalarını kontrol ettiğiniz bir emülasyonlu cihazla sanal bir ortamda çalıştırmanıza olanak tanır.

Geliştirme ortamınızı kurma

Yazılım gereksinimleri:

ARCore için Android Studio ve SDK araçlarını edinme

  1. Android Studio 3.1 veya sonraki bir sürümü yükleyin.

  2. Android Studio'da Preferences > Appearance and Behavior > System Settings > Android SDK bölümüne gidin.

  3. SDK Platforms sekmesini seçin ve Show Package Details'ı işaretleyin.

    Uygun Android sürümünün altında şunları seçin:
    Google API'leri Intel x86 Atom Sistem Görüntüsü API Seviyesi 27 veya sonraki sürümler.

  4. SDK Tools sekmesini seçin ve Android Emulator 27.2.9 veya sonraki bir sürümü ekleyin.

  5. Seçili paketleri ve araçları yüklemek için OK simgesini tıklayın.

  6. Değişiklikleri onaylamak için OK simgesini tekrar tıklayın.

  7. Accept Bileşen Yükleyici'nin lisans sözleşmesi.

  8. Finish simgesini tıklayın.

AR desteğine sahip sanal cihaz oluşturma

Daha fazla bilgi için Android Studio'daki Sanal Cihaz Oluşturma talimatlarına bakın.

Yeni bir Android sanal cihazı (AVD) oluşturma

  1. Android Studio'da Tools > Device Manager simgesini tıklayarak Cihaz Yöneticisi'ni açın.

  2. Cihaz Yöneticisi panelinin üst kısmındaki Create Device simgesini tıklayın.

  3. İstediğiniz Telefon donanım profilini seçin veya oluşturun ve Next simgesini seçin.

  4. API düzeyi 27 veya sonraki bir sürüm çalıştıran bir x86 veya x86_64 sistem resmi seçin ve Next'i seçin.

    • Fiziksel ARCore cihazlar API düzeyi 24 veya sonraki sürümlerde desteklenir ancak Android Emulator desteği için API düzeyi 27 veya sonraki sürümler gerekir.

    • Yalnızca x86 tabanlı Android Emülatör mimarileri desteklenir. arm64-v8a, armeabi-v7 gibi diğer mimariler şu anda desteklenmiyor.

  5. Sanal cihazınızın doğru şekilde yapılandırıldığından emin olun:

    • Show Advanced Settings simgesini tıklayın.

    • Camera Back değerinin VirtualScene olarak ayarlandığından emin olun.

  6. AVD'nizi oluşturmak için Finish simgesini tıklayın.

Uygulamanızı çalıştırma

Bir ARCore uygulamasını, emülatörde AR destekli bir sanal cihazda test edin. Bunun için Android Emulator'da uygulama çalıştırma ile ilgili Android Studio talimatlarını uygulayabilirsiniz.

AR için Google Play Hizmetleri'ni güncelleme

Emülatördeki AR için Google Play Hizmetleri sürümü muhtemelen güncel değildir. Güncellemek için aşağıdaki talimatları uygulayın:

  1. GitHub sürümler sayfasından en son Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk dosyasını indirin.

  2. İndirilen APK'yı kullanmak istediğiniz her AVD'ye yükleyin:

    İstediğiniz AVD'yi başlatın, ardından indirilen APK'yı sistem klasörünüzden (ör. Downloads) çalıştırılan emülatöre yükleyin veya sanal cihaz çalışırken adb kullanarak yükleyin:

    adb install -r Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk

Kullanmak istediğiniz diğer AVD'ler için bu adımları tekrarlayın.

Sanal sahneyi kontrol etme

Uygulamanız ARCore'a bağlandığında, kameranın nasıl kontrol edileceğini açıklayan bir yer paylaşımı ve emülatör penceresinin altında bir durum çubuğu görürsünüz.

Sanal kamerayı hareket ettirme

Kamera hareketi kontrollerine erişmek için Shift simgesini basılı tutun. Kamerayı hareket ettirmek için aşağıdaki kontrolleri kullanın:

İşlem Yapılması gerekenler
Sola veya sağa taşıma Üst karakter tuşunu basılı tutarken A veya D tuşlarına basın
Aşağı veya yukarı hareket ettirme Üst karakter tuşunu basılı tutarken Q veya E tuşuna basın
İleri veya geri gitme Üst karakter tuşunu basılı tutarken W veya S tuşlarına basın.
Cihaz yönünü değiştirme Üst Karakter tuşunu basılı tutun ve fareyi hareket ettirin

Emülatörde etkileşimli moda dönmek için Shift tuşunu bırakın.

Daha hassas cihaz konumlandırması için Genişletilmiş denetimler bölümündeki Virtual Sensors sekmesini kullanın.

Sahneye artırılmış resimler ekleme

Artırılmış Görüntüler'i test etmek için resimleri emülatörün simüle edilmiş ortamına yükleyin.

Scene images eklemek veya değiştirmek için Extended controls'teki Camera sekmesini kullanın. Biri duvarda, diğeri masada olmak üzere iki resim konumu vardır.

Sahnedeki bu resim konumlarını görüntülemek için emülatörünüze başlayın, ardından kamerayı başlangıç konumunun arkasındaki kapıdan yemek odasına taşıyın.

Sorun giderme ipuçları

  • ARCore uygulamanız başlatılır ve "Bu cihaz AR'yi desteklemiyor" mesajını görürseniz sistem resminizdeki düzeltmeyi kontrol edin. API düzeyi 27, Düzeltme 4 veya sonraki bir sürümü kullandığınızdan emin olun.

  • ARCore uygulamanız başlatılırken kamerayı açamıyorsa yukarıdaki yapılandırma adımlarında açıklandığı gibi Camera Back değerinin VirtualScene olarak ayarlandığından emin olun.

  • ARCore uygulamanız "AR oturumu oluşturulamadı" hata mesajıyla açılmazsa uygulama günlüğünü kontrol edin. /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3) mesajı içeren bir java.lang.UnsatisfiedLinkError görürseniz AR için Google Play Hizmetleri apk'sinin yanlış sürümünü yüklemiş olabilirsiniz. Yeni bir sanal cihaz oluşturun ve x86 sürümünü yükleyin.