Android için hızlı başlangıç kılavuzu

Android ile ARCore'u kullanmaya başlamak için ARCore SDK'sına dahil olan hello_ar_kotlin veya hello_ar_java örnek uygulamasını çalıştırabilirsiniz. Bu örnek uygulamalar, 2D ve 3D vektör grafiklerini oluşturmak için kullanılan bir programlama arayüzü olan OpenGL'yi kullanır. Uygulamalar, algılanan tüm düzlemleri gösterir ve kullanıcının bir uçağa dokunarak 3D model yerleştirmesine olanak tanır.

Geliştirme ortamınızı ayarlama

Örnek proje açın

  1. Android Studio'da, ARCore SDK GitHub deposunu klonlayın.

    Bunu yapmanın birçok yolu vardır:

    • Tanınmış bir Android Studio yüklemesi için:

      • Git menüsünden Clone öğesini seçin.
      • Version control açılır menüsünden sürüm kontrol sistemi olarak Git'i seçin.

      • URL alanına ARCore GitHub deposuna aşağıdaki URL'yi girin:

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

    • Ayrıca, aşağıdaki gibi bir Terminal açıp git clone komutunu yayınlayabilirsiniz:

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

  2. Örnek projelerden birini aşağıdaki gibi açın (bir projeyi derlemek ve çalıştırmak için açıkça açmanız gerekir).

    • File menüsünden Open öğesini seçin.
    • arcore-android-sdk/samples klasöründe hello_ar_kotlin veya hello_ar_java klasörünü seçin ve Open düğmesini tıklayı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. Uygulamayı çalıştırmadan önce emülatörde AR için Google Play Hizmetleri'ni güncellemeniz gerekir. Daha fazla bilgi için Android Emülatörde AR Uygulamaları Çalıştırma bölümüne bakın.

Örneği çalıştır

Android cihazınızın geliştirme makinesine bağlı olduğundan emin olun ve Android Studio'da Run simgesini tıklayın.

Android Studio, projenizi hata ayıklaması yapılabilecek bir APK'da 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 bölümüne bakın.

Eksik veya eskiyse AR için Google Play Hizmetleri'ni yüklemeniz veya güncellemeniz istenebilir. CONTINUE'yi seçerek Google Play Store'dan yükleyin veya AR için Google Play Hizmetleri'ni güncelleme bölümünde açıklandığı gibi manuel olarak güncelleyin.

hello_ar_java uygulaması, algılanan AR uçak yüzeylerine üç boyutlu ARCore piyonu yerleştirmenize olanak tanır. Kamera önizlemesini ve Uçaklar ve Yer İşaretleri gibi temel AR nesnelerini oluşturmak için kullanılan Android GL SurfaceView ile uygulanır. hello_ar_java'nın örnek oluşturma çerçevesi, com/google/ar/core/examples/java/common/samplerender içinde bulunabilir.

Anında Yerleşim Kullanın

Anında Yerleşim API'si, kullanıcının, ARCore'un yüzey geometrisini algılamasını beklemek zorunda kalmadan ekrana bir AR nesnesi yerleştirmesine olanak tanır. Nesne yerleşimi, kullanıcı ortamda daha fazla ilerledikçe gerçek zamanlı olarak hassaslaştırılır.

Bir nesne yerleştirmek için ekrana dokunun. Ekranda holografik nesne göründükten sonra cihazı hareket ettirmeye devam ettiğinizden emin olun. Böylece ARCore, sanal nesneyi doğru bir şekilde sabitlemek için çevrenizle ilgili yeterli miktarda veri alabilir.

ARCore, yüzey geometrisini algılayıp nesnenin yerleştirildiği bölgede izlenebilir bir görüntü oluşturduğunda, nesnenin duruşu doğruluk amacıyla otomatik olarak güncellenir.

Anında Yerleşim

Şekil 1'de, Anında Yerleşim devre dışı bırakılmıştır ve yüzey geometrisi tanımlanmamıştır. Bilardo masasının sağındaki yerde bulunan nesneler (dört küçük mavi nokta) devrilmiş görünür ve pozları tanımlanmamıştır.

Şekil 2'de, Anında Yerleşim dişli simgesi altındaki menüden etkinleştirilir.

Şekil 3'te, Anında Yerleşim etkinleştirildiğinde sahneye yeni bir nesne yerleştirilmiştir. Fotoğraf, henüz doğru poz için düzeltilmediğini göstermek üzere renkli yerine gri tonlarda görüntülenir.

Şekil 4'te, yeni nesne renkli hale gelir ve yüzey geometrisi (izlenebilir ızgara çizgileri ile tanımlanır) algılandığında, doğru duruşu sağlanır.

Derinliği Kullan

Derinlik etkinleştirildiğinde, ARCore sahnedeki nesnelerin geometrisini ve konumunu dikkate alır ve sahnedeki diğer nesnelere göre sahneye yerleştirilen nesnelerin konumunu hesaplar. Bu tasarım, yerleştirilmiş nesnelerin sahnedeki nesneler tarafından kapatılmasını sağlar ve uygulamanıza gerçekçilik katar.

Anında Yerleşim

Şekil 1'de, Derinlik devre dışı bırakılmıştır. Bilardo masasının altına bir nesne yerleştirilmiş.

Şekil 2'de cihaz bilardo masasında hareket ederken nesne, sahnedeki nesnelerden bağımsız olarak cihazı takip ediyormuş gibi görünür.

Şekil 3'te, Derinlik etkindir.

Şekil 4'te cihaz sahne çevresinde hareket ederken nesne şimdi bilardo masasının tarafından gizlenmiş olarak görünür.

Sonraki adımlar