Android için Sceneform Hızlı Başlangıç Kılavuzu

Geliştirme ortamınızı ayarlama

Örnek projeyi açın

Örnek projeleri alın. Aşağıdaki yöntemlerden birini uygulayabilirsiniz:

  • Sahne Örneklerini indirme ve çıkarma

    -veya-

  • Depoyu aşağıdaki komutla klonlayın:

    git clone https://github.com/google-ar/sceneform-android-sdk.git

Android Studio'da, sceneform-android-sdk dizinindeki uygulama alt dizininde bulunan Merhaba Sceneform örnek projesini açın.

Cihazınızı veya emülatörünüzü hazırlama

AR uygulamalarını desteklenen bir cihazda veya Android Emülatör'de çalıştırabilirsiniz:

Emülatörde Sceneform uygulamaları çalıştırmak için ek şartlar mevcuttur:

  • Android Emulator'ın 27.2.9 veya sonraki bir sürümüne ihtiyacınız vardır.

  • OpenGL ES 3.0 veya sonraki sürümler Android Emülatör'de desteklenip etkinleştirilmelidir.

    • Emülatörünüzün en son sürümü kullanacak şekilde yapılandırıldığından emin olun. Genişletilmiş kontroller panelinde (Araç Çubuğu'nda Daha fazla) Ayarlar > Gelişmiş > OpenGL ES API düzeyi > Oluşturma maksimumu (en fazla OpenGL ES 3.1) öğesini seçin ve ardından emülatörü yeniden başlatın.

    • Emülatörü çalıştırın, emüle edilmiş sürümle kısa süreliğine etkileşime geçin, ardından OpenGL ES 3.0 veya üstünün kullanılıp kullanılmadığını kontrol edin:

      adb logcat | grep eglMakeCurrent

      ver 3 0 veya daha yüksek bir sürüm görüyorsanız Sceneform uygulamaları çalıştırabilirsiniz. Daha düşük bir sürüm görürseniz masaüstü GPU'nuz OpenGL ES 3.0'ı desteklemiyor ve Sceneform uygulamaları çalıştırmak için desteklenen bir cihaz kullanmanız gerekir.

Örneği çalıştırma

Android cihazınızın geliştirme makinesine bağlı olduğundan emin olun ve Android Studio'da Çalıştır'ı tıklayın. Ardından, dağıtım hedefi olarak cihazınızı seçin ve Tamam'ı tıklayın.

Android Studio, projenizde hata ayıklaması yapılabilir bir APK oluşturur, APK'yı yükler ve ardından uygulamayı cihazınızda çalıştırır. Daha fazla bilgi için Uygulamanızı Derleme ve Çalıştırma başlıklı makaleyi inceleyin.

Eksik veya güncel değilse AR için Google Play Hizmetleri'ni yüklemeniz ya da güncellemeniz istenebilir. Uygulamayı Google Play Store'dan yüklemek için DEVAM'ı seçin.

Merhaba Sceneform uygulaması, Android figürleri düz yüzeylere yerleştirmenize ve bu mankentleri kullanmanıza olanak tanır.

Mevcut bir projeye Sceneform ekleme

Mevcut bir projede Sceneform'u kullanmak için:

  1. Uygulamanızda ARCore'u etkinleştirme adımlarını uygulayın

  2. Uygulama build.gradle dosyanıza Sceneform kitaplığını ekleyin:

    android {
    // Sceneform libraries use language constructs from Java 8.
    // Add these compile options if targeting minSdkVersion < 26.
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

dependencies {
    …

    // Provides ArFragment, and other UX resources.
    implementation 'com.google.ar.sceneform.ux:sceneform-ux:1.15.0'

    // Alternatively, use ArSceneView without the UX dependency.
    implementation 'com.google.ar.sceneform:core:1.15.0'
}

Sonraki adımlar