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

Cómo habilitar la RA en tu app de NDK de Android

Habilita la RA para usar funciones de realidad aumentada en tu app nueva o existente.

Configura tu app para que sea obligatoria o opcional para RA

Para ahorrar espacio en dispositivos individuales, todas las funciones de RA se almacenan en una app llamada Servicios de Google Play para RA que Play Store actualiza por separado. Las apps para Android que usan funciones de RA se comunican con los Servicios de Google Play para RA mediante el SDK de ARCore. Una app que admite funciones de RA se puede configurar de dos maneras: obligatoria para RA y opcional para RA. Esta designación determina cómo interactúa la app con la app de Servicios de Google Play para RA.

Una app obligatoria para RA no puede funcionar sin ARCore. Requiere un dispositivo compatible con ARCore que tenga instalados los Servicios de Google Play para RA.

Google Play Store solo pondrá a disposición las apps obligatorias para RA en dispositivos compatibles con ARCore.
Cuando los usuarios instalen una app obligatoria para RA, Google Play Store instalará automáticamente los Servicios de Google Play para RA en su dispositivo. Sin embargo, tu app debe realizar verificaciones de tiempo de ejecución adicionales en caso de que los Servicios de Google Play para RA estén desactualizados o se hayan desinstalado de forma manual.

Una app opcional para RA usa ARCore para mejorar la funcionalidad existente. Tiene funciones de RA opcionales que solo se activan en dispositivos compatibles con ARCore que tienen instalados los Servicios de Google Play para RA.

Las apps opcionales para RA se pueden instalar y ejecutar en dispositivos que no admiten ARCore.
Cuando los usuarios instalen una app opcional para RA, Google Play Store no instalará automáticamente los Servicios de Google Play para RA en el dispositivo.

	Obligatoria para RA	Opcional para RA
Uso de la función de RA	Tu app necesita ARCore para la funcionalidad básica.	ARCore aumenta la funcionalidad de tu app. Tu app puede ejecutarse sin compatibilidad con ARCore.
Visibilidad en Play Store	Tu app solo aparece en Play Store en dispositivos compatibles con ARCore.	Tu app sigue los procedimientos de publicación normales.
Método de instalación de los Servicios de Google Play para RA	Play Store instala los Servicios de Google Play para RA junto con tu app.	Tu app usa `ArCoreApk.requestInstall()` para descargar e instalar ARCore.
Requisitos de `minSdkVersion` de Android	Android 7.0 (nivel de API 24)	Android 4.4 (nivel de API 19), aunque ejecutar cualquier funcionalidad de RA requiere al menos Android 7.0 (nivel de API 24)
Se debe usar `ArCoreApk_checkAvailability()` o `ArCoreApk_checkAvailabilityAsync()` para verificar la compatibilidad con ARCore y el estado de instalación
Se debe usar `ArCoreApk.requestInstall()` para instalar los Servicios de Google Play para RA

Para que tu app sea obligatoria o opcional para RA, actualiza tu AndroidManifest.xml para incluir las siguientes entradas:

Obligatoria para RA

<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>

Opcional para RA

<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>

Luego, modifica el build.gradle de tu app para especificar un minSdkVersion de al menos 24:

 android {
     defaultConfig {
         …
         minSdkVersion 24
     }
 }

Cómo agregar dependencias de compilación

Asegúrate de que el archivo build.gradle de tu proyecto incluya el repositorio de Maven de Google.
```
allprojects {
    repositories {
        google()
        …
    }
}
```
Agrega una tarea personalizada al archivo build.gradle de tu módulo para extraer las bibliotecas nativas incluidas del archivo AAR de ARCore. De esta manera, se puede hacer referencia a ellas directamente en un proyecto de C o C++.
En el directorio app/build, define una variable para el directorio en el que se extraerán las bibliotecas nativas.

Crea una configuración de Gradle para contener los datos y las tareas de extracción.

/*
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 }

Crea una tarea para copiar las bibliotecas nativas del archivo AAR y agrégala a las dependencias de compilación.

// 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)
    }
}

Configura las marcas de compilación nativas para pasar las ubicaciones a las herramientas de compilación externas.

// 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"
    }
}

Agrega las dependencias de las bibliotecas Java y nativas.

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'
     ...
}

Haz referencia a las bibliotecas nativas en CMakeLists.txt.

# 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}
)

Realiza verificaciones de tiempo de ejecución

Durante el tiempo de ejecución, realiza lo siguiente para asegurarte de que las funciones de RA de tu app se ejecuten sin problemas.

Verifica si se admite ARCore

Las apps obligatorias y opcionales para RA deben usar ArCoreApk_checkAvailability() o ArCoreApk_checkAvailabilityAsync() para determinar si el dispositivo actual admite ARCore. En los dispositivos que no admiten ARCore, las apps deben inhabilitar la funcionalidad relacionada con la RA y ocultar los elementos de la IU asociados.

Una app de NDK de Android puede usar la clase ArCoreApkde Java para verificar la compatibilidad y administrar la instalación en la API de sesión de ARCore de C nativa. Según la estructura de tu app, esto puede ser más fácil que usar las funciones ArCoreApk_ debido a la gran cantidad de manejo de errores y la interacción de la interfaz de usuario involucrada.

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.
  }
}

Aunque los Servicios de Google Play para RA se instalan junto con tu app obligatoria para RA, los usuarios con dispositivos no compatibles podrían instalarlos desde una fuente externa. Usar ArCoreApk_checkAvailability() o ArCoreApk_checkAvailabilityAsync() para verificar la compatibilidad con ARCore garantiza una experiencia coherente.

ArCoreApk_checkAvailability() puede necesitar consultar recursos de red para determinar si el dispositivo admite ARCore. Durante este tiempo, mostrará AR_AVAILABILITY_UNKNOWN_CHECKING. Para reducir la latencia percibida y la aparición repentina, las apps deben llamar a ArCoreApk_checkAvailability() una vez al principio de su ciclo de vida para iniciar la consulta, ignorando el valor que se muestra. De esta manera, un resultado almacenado en caché estará disponible de inmediato cuando se pueda mostrar un elemento de la IU que ingresa a la RA.

Verifica si están instalados los Servicios de Google Play para RA

Las apps obligatorias y opcionales para RA deben usar ArCoreApk.requestInstall() antes de crear una sesión de ARCore para verificar si está instalada (todavía) una versión compatible de los Servicios de Google Play para RA y para asegurarse de que se hayan descargado todos los datos de perfil del dispositivo ARCore necesarios.

// 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.
}

Cumple con los requisitos de privacidad del usuario

Para publicar tu app en Play Store, asegúrate de que cumpla con los requisitos de privacidad del usuario de ARCore .

Próximos pasos

Obtén información para configurar una sesión de ARCore.

Cómo habilitar la RA en tu app de NDK de Android Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.