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

Fiziksel bir cihaz olmadan artırılmış gerçeklik senaryolarını test etmek için Android Emulator'ı kullanın. Android Emulator, ARCore uygulamalarını sanal bir ortamda, kontrolünüzdeki emüle edilmiş bir cihazla çalıştırmanızı sağlar.

Geliştirme ortamınızı ayarlama

Yazılım gereksinimleri:

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

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

  2. Android Studio'da Preferences > Appearance and Behavior > System Settings > Android SDK adresine gidin.

  3. SDK Platforms sekmesini seçin ve Show Package Details seçeneğini işaretleyin.

    Uygun Android sürümü altında şunları seçin:
    Google APIs Intel x86 Atom System Image API Level 27 veya sonraki bir sürümü.

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

  5. Seçilen paketleri ve araçları yüklemek için OK bağlantısını tıklayın.

  6. Değişiklikleri onaylamak için OK (Tamam) düğmesini tekrar tıklayın.

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

  8. Finish simgesini tıklayın.

AR desteğiyle sanal cihaz oluşturma

Daha fazla bilgi için Sanal Cihaz Oluşturma ile ilgili Android Studio 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'i tıklayın.

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

  4. API Düzeyi 27 veya sonraki sürümleri çalıştıran bir x86 ya da x86_64 sistem görüntüsü seçin ve Next öğesini seçin.

    • API Düzeyi 24 veya sonraki sürümlerde fiziksel ARCore cihazları desteklense de Android Emulator desteği için API Düzeyi 27 veya üzeri gerekir.

    • Yalnızca x86 tabanlı Android Emulator mimarileri desteklenir. arm64-v8a, armeabi-v7 gibi diğer mimariler şu anda desteklenmemektedir.

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

    • Show Advanced Settings simgesini tıklayın.

    • Camera Back öğesinin VirtualScene olarak ayarlandığından emin olun.

  6. Ortalama görüntüleme sürenizi oluşturmak için Finish seçeneğini tıklayın.

Uygulamanızı çalıştırma

Bir ARCore uygulamasını emülatörde, AR destekli bir sanal cihazda test edin. Bunu yapmak için Android Emülatör'de 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ü büyük olasılıkla güncel değil. Güncellemek için şu talimatları uygulayın:

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

  2. İndirilen APK'yı kullanmak istediğiniz her bir ortalama görüntüleme cihazına yükleyin:

    İstediğiniz ortalama görüntüleme süresini başlatın, ardından indirilen APK'yı sistem klasörünüzden sürükleyin (ör. Downloads) yükleyin veya sanal cihaz çalışırken adb komutunu kullanarak uygulamayı yükleyin: 

    adb install -r Google_Play_Services_for_AR_1.44.0_x86_for_emulator.apk

Kullanmak istediğiniz diğer ortalama görüntüleme süreleri için bu adımları tekrarlayın.

Sanal sahneyi kontrol edin

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 ettirin

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

İşlem Ne yapmalı?
Sola veya sağa taşı Üst Karakter tuşunu basılı tutarken A veya D'ye basın
Aşağı veya yukarı taşıma Üst Karakter tuşunu basılı tutarken Q veya E'ye basın
İleri veya geri gitme Üst Karakter tuşunu basılı tutarken W veya S'ye basın
Cihaz yönünü değiştir Üst Karakter tuşunu basılı tutarken fareyi hareket ettirin

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

Cihazları daha hassas bir şekilde konumlandırmak için Genişletilmiş kontroller'de Virtual Sensors sekmesini kullanın.

Sahneye artırılmış resim ekleme

Artırılmış Görüntüleri test etmek için emülatörün simüle edilen ortamına resim yükleyin.

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

Bu görüntüleri sahnede görmek için emülatörünüzü çalıştırın, ardından kamerayı başlangıç konumunun arkasındaki kapıdan yemek odası alanına doğru hareket ettirin.

Sorun giderme ipuçları

  • ARCore uygulamanız açılır ve "Bu cihaz AR'yi desteklemiyor" mesajını görürseniz sistem görüntünüzdeki düzeltmeyi kontrol edin. API Level 27 Revision 4 veya sonraki bir sürümü kullandığınızdan emin olun.

  • ARCore uygulamanız başlatıldığında kamerayı açamazsa Camera Back öğesinin, yukarıdaki yapılandırma adımlarında açıklandığı gibi VirtualScene olarak ayarlandığından emin olun.

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