Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Android NDK uygulamanızda artırılmış gerçekliği etkinleştirme

Yeni veya mevcut uygulamanızda artırılmış gerçeklik özelliklerini kullanmak için AR'yi etkinleştirin.

Uygulamanızı AR Required (AR Gerekli) veya AR Optional (AR İsteğe Bağlı) olarak yapılandırma

Tüm AR özellikleri, bağımsız cihazlarda yer kazanmak için Play Store tarafından ayrı olarak güncellenen AR için Google Play Hizmetleri adlı bir uygulamada saklanır. AR özelliklerini kullanan Android uygulamaları, ARCore SDK'sını kullanarak AR için Google Play Hizmetleri ile iletişim kurar. AR özelliklerini destekleyen bir uygulama iki şekilde yapılandırılabilir: AR Required (AR Zorunlu) ve AR Optional (AR İsteğe Bağlı). Bu tanımlama, artırılmış gerçeklik uygulaması : AR uygulamasının AR için Google Play Hizmetleri uygulamasıyla nasıl etkileşim kuracağını belirler.

AR Required (AR Gerekli) uygulamalar, ARCore olmadan çalışamaz. Bu özellik için ARCore'u destekleyen ve AR için Google Play Hizmetleri'nin yüklü olduğu bir cihaz gerekir.

Google Play Store, ARCore'u destekleyen cihazlarda yalnızca AR Required uygulamalarını kullanıma sunar.
Kullanıcılar AR Required uygulaması yüklediğinde Google Play Store, AR için Google Play Hizmetleri'ni cihazlarına otomatik olarak yükler. Ancak AR için Google Play Hizmetleri güncel değilse veya manuel olarak kaldırılmışsa uygulamanızın ek çalışma zamanı kontrolleri yapması gerekir.

AR İsteğe Bağlı uygulamalar, mevcut işlevleri geliştirmek için ARCore'u kullanır. AR için Google Play Hizmetleri'nin yüklü olduğu ve ARCore'un desteklendiği cihazlarda etkinleştirilen isteğe bağlı AR özellikleri vardır.

AR isteğe bağlı uygulamalar, ARCore'u desteklemeyen cihazlara yüklenebilir ve bu cihazlarda çalıştırılabilir.
Kullanıcılar AR İsteğe Bağlı bir uygulama yüklediğinde Google Play Store, AR için Google Play Hizmetleri'ni cihaza otomatik olarak yüklemez.

	AR Gerekli	AR İsteğe Bağlı
AR özelliğinin kullanımı	Uygulamanızın temel işlevleri için ARCore'a ihtiyacı var.	ARCore, uygulamanızın işlevselliğini artırır. Uygulamanız ARCore desteği olmadan çalışabilir.
Play Store'da görünürlük	Uygulamanız yalnızca ARCore'u destekleyen cihazlarda Play Store'da listelenir.	Uygulamanız normal listeleme prosedürlerine uygundur.
AR için Google Play Hizmetleri yükleme yöntemi	Play Store, AR için Google Play Hizmetleri'ni uygulamanızla birlikte yükler.	Uygulamanız, ARCore'u indirmek ve yüklemek için `ArCoreApk.requestInstall()` iznini kullanıyor.
Android `minSdkVersion` gereksinimleri	Android 7.0 (API düzeyi 24)	Android 4.4 (API düzeyi 19) ancak herhangi bir AR işlevinin çalışması için en az Android 7.0 (API düzeyi 24) gerekir.
ARCore desteğini ve yükleme durumunu kontrol etmek için `ArCoreApk_checkAvailability()` veya `ArCoreApk_checkAvailabilityAsync()` kullanılmalıdır.
AR için Google Play Hizmetleri'ni yüklemek üzere `ArCoreApk.requestInstall()` kullanılmalıdır.

Uygulamanızı AR Required veya AR Optional yapmak için AndroidManifest.xml dosyanızı aşağıdaki girişleri içerecek şekilde güncelleyin:

AR Gerekli

<uses-permission android:name="android.permission.CAMERA" />

<!-- Limits app visibility in the Google Play Store to ARCore supported devices
     (https://developers.google.com/ar/devices). -->
<uses-feature android:name="android.hardware.camera.ar" />

<application …>
    …

    <!-- "AR Required" app, requires "Google Play Services for AR" (ARCore)
         to be installed, as the app does not include any non-AR features. -->
    <meta-data android:name="com.google.ar.core" android:value="required" />
</application>

AR İsteğe Bağlı

<uses-permission android:name="android.permission.CAMERA" />

<!-- If your app was previously AR Required, don't forget to remove the
     `<uses-feature android:name="android.hardware.camera.ar" />` entry, as
     this would limit app visibility in the Google Play Store to only
     ARCore supported devices. -->

<application …>
    …

    <!-- "AR Optional" app, contains non-AR features that can be used when
         "Google Play Services for AR" (ARCore) is not available. -->
    <meta-data android:name="com.google.ar.core" android:value="optional" />
</application>

Ardından, uygulamanızın build.gradle dosyasını değiştirerek en az 24 sürümündeki minSdkVersion özelliğini belirtin:

 android {
     defaultConfig {
         …
         minSdkVersion 24
     }
 }

Derleme bağımlılıkları ekleme

Projenizin build.gradle dosyasında Google'ın Maven deposunun bulunduğundan emin olun.
```
allprojects {
    repositories {
        google()
        …
    }
}
```
ARCore AAR dosyasından yerleşik kitaplıkları çıkarmak için modülünüzün build.gradle dosyasına özel bir görev ekleyin. Bu sayede, C veya C++ projesinde doğrudan referans verilebilirler.
app/build dizininde, yerel kitaplıkların çıkarılacağı dizin için bir değişken tanımlayın.

Verileri ve ayıklama görevlerini tutmak için bir Gradle yapılandırması oluşturun.

/*
The ARCore AAR library contains native shared libraries that are
extracted before building to a temporary directory.
*/
def arcore_libpath = "${buildDir}/arcore-native"

// Create a configuration to mark which aars to extract .so files from
configurations { natives }

AAR dosyasından yerel kitaplıkları kopyalamak için bir görev oluşturun ve bunu derleme bağımlılıklarına ekleyin.

// Extracts the shared libraries from AARs in the native configuration
// so that NDK builds can access these libraries.
task extractNativeLibraries() {
   // Extract every time.
   outputs.upToDateWhen { false }

   doFirst {
        configurations.natives.files.each { f ->
            copy {
                from zipTree(f)
                into arcore_libpath
                include "jni/**/*"
            }
        }
    }
}

tasks.whenTaskAdded {
    task-> if (task.name.contains("external") && !task.name.contains("Clean")) {
        task.dependsOn(extractNativeLibraries)
    }
}

Yerleri harici derleme araçlarına iletmek için yerel derleme işaretlerini yapılandırın.

// From the sample app.
externalNativeBuild {
    cmake {
        cppFlags "-std=c++11", "-Wall"
        arguments "-DANDROID_STL=c++_static",
                "-DARCORE_LIBPATH=${arcore_libpath}/jni",
                "-DARCORE_INCLUDE=${project.rootDir}/../../libraries/include"
    }
}

Hem Java hem de yerel kitaplıkların bağımlılıklarını ekleyin.

dependencies {
     ...
     // Add Java and native dependencies to the ARCore library.
     implementation 'com.google.ar:core:1.33.0'
     natives 'com.google.ar:core:1.33.0'
     ...
}

CMakeLists.txt içindeki yerel kitaplıklara referans verin.

# Import the ARCore library.
add_library(arcore SHARED IMPORTED)
set_target_properties(arcore PROPERTIES IMPORTED_LOCATION
              ${ARCORE_LIBPATH}/${ANDROID_ABI}/libarcore_sdk_c.so
              INTERFACE_INCLUDE_DIRECTORIES ${ARCORE_INCLUDE}
)

Çalışma zamanı denetimleri gerçekleştirme

Çalışma zamanında, uygulamanızdaki AR özelliklerinin sorunsuz şekilde çalışmasını sağlamak için aşağıdakileri yapın.

ARCore'un desteklenip desteklenmediğini kontrol etme

Hem AR Required hem de AR Optional uygulamaları, mevcut cihazın ARCore'u destekleyip desteklemediğini belirlemek için ArCoreApk_checkAvailability() veya ArCoreApk_checkAvailabilityAsync() kullanmalıdır. ARCore'u desteklemeyen cihazlarda uygulamalar, AR ile ilgili işlevleri devre dışı bırakmalı ve ilişkili kullanıcı arayüzü öğelerini gizlemelidir.

Android NDK uygulamaları, yerel C ARCore Session API'de uyumluluğu kontrol etmek ve yüklemeyi yönetmek için Java ArCoreApk sınıfını kullanabilir. Uygulamanızın yapısına bağlı olarak, çok fazla hata işleme ve kullanıcı arayüzü etkileşimi söz konusu olduğundan bu yöntem, ArCoreApk_ işlevlerini kullanmaktan daha kolay olabilir.

void maybeEnableArButton(JNIEnv env, jobject context) {
  // Likely called from Activity.onCreate() of an activity with AR buttons.
  ArAvailability availability
  ArCoreApk_checkAvailability(env, context, &availability);
  if (availability == AR_AVAILABILITY_UNKNOWN_CHECKING) {
    // Set a timer to call maybeEnableArButton() again after about 200ms.
  }
  if (availability == AR_AVAILABILITY_SUPPORTED_NOT_INSTALLED ||
      availability == AR_AVAILABILITY_SUPPORTED_APK_TOO_OLD ||
      availability == AR_AVAILABILITY_SUPPORTED_INSTALLED) {
    // Show or enable the AR button.
  } else {
    // Hide or disable the AR button.
  }
}

AR için Google Play Hizmetleri, AR Required uygulamanızla birlikte yüklense de desteklenmeyen cihazlara sahip kullanıcılar bu hizmeti harici bir kaynaktan yükleyebilir. ARCore desteğini kontrol etmek için ArCoreApk_checkAvailability() veya ArCoreApk_checkAvailabilityAsync() kullanmak tutarlı bir deneyim sağlar.

ArCoreApk_checkAvailability(), cihazın ARCore'u destekleyip desteklemediğini belirlemek için ağ kaynaklarını sorgulaması gerekebilir. Bu süre boyunca AR_AVAILABILITY_UNKNOWN_CHECKING döndürülür. Algılanan gecikmeyi ve pop-in'i azaltmak için uygulamalar, sorguyu başlatmak üzere yaşam döngüsünün başlarında ArCoreApk_checkAvailability() işlevini bir kez çağırmalı ve döndürülen değeri yoksaymalıdır. Bu sayede, AR giriş kullanıcı arayüzü öğesi gösterildiğinde önbelleğe alınmış sonuç hemen kullanılabilir.

AR için Google Play Hizmetleri'nin yüklü olup olmadığını kontrol etme

Hem AR Required hem de AR Optional uygulamaları, ARCore oturumu oluşturmadan önce ArCoreApk.requestInstall() kullanarak AR için Google Play Hizmetleri'nin uyumlu bir sürümünün (hâlâ) yüklü olup olmadığını kontrol etmeli ve gerekli tüm ARCore cihaz profili verilerinin indirildiğinden emin olmalıdır.

// Tracks if an installation request has already been triggered.
bool install_requested_;

void nativeOnCreate() {
  // Do other setup here.

  install_requested_ = false;
}

void nativeOnResume(JNIEnv env, jobject activity) {
  if (ar_session_ == null) {
    bool user_requested_install = !install_requested_;

    ArInstallStatus install_status;
    // Ensure that Google Play Services for AR and ARCore device profile data are
    // installed and up to date.
    ArStatus error = ArCoreApk_requestInstall(
        env, activity, user_requested_install, &install_status);
    if (error != AR_SUCCESS) {
      // Inform user of error.
      return;
    }

    switch (install_status) {
      case AR_INSTALL_STATUS_INSTALLED:
        break;
      case AR_INSTALL_STATUS_INSTALL_REQUESTED:
        // When this method returns AR_INSTALL_STATUS_INSTALL_REQUESTED:
        // 1. This activity will be paused.
        // 2. The user is prompted to install or update Google Play
        //    Services for AR (market://details?id=com.google.ar.core).
        // 3. ARCore downloads the latest device profile data.
        // 4. This activity is resumed. The next invocation of
        //    ArCoreApk_requestInstall() will either return
        //    AR_INSTALL_STATUS_INSTALLED or throw an exception if the
        //    installation or update did not succeed.
        install_requested_ = true;
        return;
    }

    // Request camera permissions.

    error = ArSession_create(env, context, &ar_session_);
    if (error != AR_SUCCESS) {
      // Inform user of error.
      return;
    }

    // Configure the ARCore session.
  }

  // Normal onResume behavior.
}

Kullanıcı Gizliliği Şartlarına Uyma

Uygulamanızı Play Store'da yayınlamak için ARCore'un Kullanıcı Gizliliği Şartları'na uygun olduğundan emin olun.

Sırada ne var?

ARCore oturumunu nasıl yapılandıracağınızı öğrenin.

Android NDK uygulamanızda artırılmış gerçekliği etkinleştirme Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.