Guía de inicio rápido para Cloud Anchors en iOS

La API de Cloud Anchor de ARCore, o el servicio de Cloud Anchor de ARCore, proporciona funciones de Cloud Anchor para tus apps para iOS, por lo que que los usuarios de dispositivos iOS y Android compartan experiencias de RA.

En esta guía, se muestra cómo realizar las siguientes acciones:

  • Configura tu entorno de desarrollo para trabajar con Cloud Anchors
  • Prueba alojar y resolver anclas en una app de ejemplo

Requisitos previos

  • Xcode versión 13.0 o posterior
  • CocoaPods 1.4.0 o una versión posterior si se usa CocoaPods
  • Un dispositivo Apple compatible con ARKit que ejecute iOS 12.0 o una versión posterior (se requiere un destino de implementación de iOS 12.0 o una versión posterior)

Usa Cloud Anchors

En los siguientes pasos, se usa la app de ejemplo de Cloud Anchors para mostrarte las claves para configurar y compilar una app compatible con Cloud Anchors de ARCore.

Obtén la app de ejemplo de Cloud Anchors

  1. Clona o descarga el SDK de ARCore para iOS desde GitHub para obtener el código de la app de ejemplo.

  2. Abre una ventana de Terminal o Finder y navega a la carpeta donde clonaste. o descargaste el SDK.

  3. Puedes encontrar el código de la app de ejemplo en
    /arcore-ios-sdk-master/Examples/CloudAnchorExample

    El código de la app de ejemplo de anclas de nube persistentes es en
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample

Configuración de la sesión

Como parte de la configuración de la app de ejemplo, se realizan las siguientes tareas importantes sesión:

Configura el uso compartido del ID de Cloud Anchor

La app de ejemplo de Cloud Anchors usa Firebase para compartir los IDs de Cloud Anchor entre dispositivos. Puedes usar una solución diferente en tus propias apps.

Para configurar la base de datos de Firebase en la app de muestra, haz lo siguiente:

  1. Sigue las instrucciones de Firebase para agregar Firebase a tu app.
  2. Descarga el archivo GoogleService-Info.plist que se generó como parte de la adición de Firebase a tu app.
  3. Habilita Firebase Storage para la muestra:
    • Dirígete a Firebase console y selecciona el proyecto para el que configuraste la app de ejemplo.
    • Selecciona el panel Database.
    • En la opción Realtime Database, haz clic en Get Started.
    • Se abrirá el menú Security rules for Realtime Database.
      • Para ejecutar la muestra, selecciona Start in test mode.
      • Ten en cuenta que, si usas Firebase para una app que planeas publicar, deberías usar reglas de seguridad más restrictivas.
  4. En Xcode, agrega el archivo GoogleService-Info.plist a tu app, junto a Info.plist

Configura la API de ARCore

Para usar Cloud Anchors, primero debes configurar el API de ARCore para tu aplicación.

Ejecuta la actualización del Pod

La app CloudAnchorExample se envía con un Podfile preconfigurado con el Las versiones de iOS y del SDK de ARCore que necesitarás. Para instalar estas dependencias, sigue estos pasos:

  1. Abre una ventana de Terminal y ejecuta pod update desde la carpeta en la que Que exista el proyecto de Xcode.
    Esto genera un archivo .xcworkspace que usarás más adelante para compilar y para ejecutar la app.

Consulta Agrega el SDK de ARCore a tu app. para obtener detalles sobre la configuración de Podfile en tus propias apps.

  1. Abre el archivo .xcworkspace del proyecto en Xcode.

    Para evitar errores de compilación, asegúrate de compilar desde .xcworkspace. en lugar del archivo .xcodeproj.

Cómo cambiar el ID del paquete de aplicación

En Xcode, cambia el ID del paquete de la app para que puedas firmar la app con tu equipo.

Compila y ejecuta la app

  1. Conecta tu dispositivo y, luego, inicia la app en Xcode.

  2. Si compilas y ejecutas la app de ejemplo, consulta los siguientes vínculos (opcional) para obtener información sobre cómo usar la app para alojar y resolver Cloud Anchors.

Prueba la app de ejemplo

  1. Compila y ejecuta la app de ejemplo desde el archivo .xcworkspace para iniciarla en tu dispositivo.

  2. Si se te solicita, otorga permisos de cámara a la app. ARKit, luego comienza a detectar planos frente a tu cámara.

  3. Presiona HOST para ingresar al modo de hosting. Un código de sala para compartir las anclas alojadas se generará y aparecerá en tu pantalla.

  4. Presiona un plano para comenzar a alojar allí un ancla en la nube.

    • La app coloca un objeto de Android de Andy en el avión y fija un ancla. que se les asigna.
    • Se envía una solicitud de host al extremo de nube de la API de ARCore. El anfitrión incluye datos que representan la posición del ancla en relación con la elementos visuales cercanos.
    • Una vez que se aloja el ancla, este obtiene un ID que se usa para resolver problemas de anclas en este espacio.

  5. Presiona RESOLVE y, luego, ingresa un código de habitación para acceder anteriormente Cloud Anchors alojados para esta sala con el mismo dispositivo o uno diferente.

    • Se envía una solicitud de resolución al extremo en la nube de la API de ARCore.
    • La solicitud de resolución incluye un ID de Cloud Anchor. Si el ID coincide con una si el ancla alojada y la localización se ejecutan de forma correcta, el servidor muestra transformación del ancla en tus coordenadas locales.
    • La app de ejemplo usa la transformación para agregar el ancla a tu escena y renderizar objetos virtuales adjuntos a él.

Agrega el SDK de ARCore a tus apps

En tus propias apps, deberás actualizar tu Podfile para incluir el SDK de ARCore y versiones de iOS compatibles. Para ello, sigue estos pasos:

  1. Agrega los siguientes platform y pod a tu Podfile del proyecto:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.45.0'
  1. Abre una ventana de terminal y ejecuta pod update desde la carpeta en la que existe tu proyecto de Xcode.
    Esto genera un archivo .xcworkspace que usarás para compilar y para ejecutar la app.

Anclas de nube persistentes

Como se describe en Aloja una Cloud Anchor con persistencia, puedes darle a Cloud Anchor un tiempo de actividad de hasta 365 días. Código de muestra de con anclas de nube persistentes está disponible en /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample en el SDK de ARCore para iOS desde GitHub.

Próximos pasos