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

Geliştirme ortamınızı ayarlama

  • Android SDK Platformu 7.0 (API düzeyi 24) veya sonraki sürümlerle Android Studio sürüm 3.1 veya sonraki bir sürümü yükleyin.

  • SDK Yöneticisi yardımıyla Android Yerel Geliştirme Kiti (NDK) ve CMake'ı yükleyerek Android Studio'yu yerel geliştirme için hazırlayın. Daha fazla bilgi için NDK'yı Kullanmaya Başlama bölümüne bakın.

  • Android için ARCore SDK'sını edinmeniz gerekir. Aşağıdaki yöntemlerden birini uygulayabilirsiniz:

    • Android için ARCore SDK'sını indirip çıkarın.

      -veya-

    • Aşağıdaki komutla kod deposunu klonlayın:

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

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.

Örnek projeyi açın

Android Studio'da, <ARCore SDK Folder>/samples/hello_ar_c uygulamasında hello_ar_c örnek projesini açın.

Örnek proje, Gradle ve Android SDK gibi belirli yazılım sürümlerinde bağımlılıklar oluşturmuştur. Gerekli bağımlılıklar yüklü değilse Android Studio bunları indirmek ve makinenize yüklemek için sizden izin ister.

Örneği çalıştır

Android cihazınızın geliştirme makinesine bağlı olduğundan emin olun ve Android Studio'da Run düğmesini 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.

Uygulama, siz cihazınızı hareket ettirdikçe otomatik olarak düz yüzeyleri algılar ve bir elmas ızgara çizer. Yüzeye üç boyutlu bir ARCore piyonu yerleştirmek için ızgaraya dokunun.

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. ARCore, AR nesnesinin yerleştirildiği bölgede doğru duruşu tespit ettiğinde nesne otomatik olarak doğru pozisyonu gösterecek şekilde güncellenir.

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.

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