Guía de inicio rápido de Rostros aumentados para iOS

En esta guía, se muestra cómo hacer lo siguiente:

• Configura tu entorno de desarrollo para trabajar con caras aumentadas
• Aplica texturas 2D y adjunta objetos 3D a los rostros detectados

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 versiones posteriores (se requiere un objetivo de implementación de iOS 12.0 o versiones posteriores)

Nota: A partir de ARCore 1.12, se admiten todos los dispositivos compatibles con ARKit.

Usa rostros aumentados

En los siguientes pasos, se usa la app de ejemplo de caras aumentadas para mostrarte las tareas fundamentales para configurar y compilar una app con las funciones de caras aumentadas.

Obtén la app de ejemplo de caras aumentadas

1. Clona o descarga el SDK de ARCore para iOS más reciente 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 en la que clonaste o descargaste el SDK.
3. Puedes encontrar el código de la app de ejemplo en /Examples/AugmentedFacesExample.

Ejecuta pod install

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

1. Abre una ventana de Terminal y ejecuta pod install desde la carpeta en la que se encuentra el proyecto de Xcode. Esto generará un archivo *.xcworkspace que usarás más adelante para compilar y ejecutar la app.

Compila y ejecuta la app

1. Abre el archivo .xcworkspace (no .xcodeproj) del proyecto en Xcode.
2. Abre la configuración general del destino y cambia el identificador de paquete.
3. Presiona Cmd + R o haz clic en Ejecutar. Usa un dispositivo físico, no el simulador, para trabajar con Rostros aumentados. El dispositivo debe estar conectado a la máquina de desarrollo por USB.

Nota: Dado que el simulador no tiene cámara, las apps que usen caras aumentadas deben ejecutarse en un dispositivo físico.

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. Luego, ARCore comienza a detectar rostros visibles en la cámara. Actualmente, solo se detecta un rostro a la vez.
3. Asegúrate de que la cámara esté orientada hacia el usuario.

Próximos pasos

• Consulta la Guía para desarrolladores de Rostros Augmentados para iOS para explorar el código de muestra de la app y obtener más información sobre cómo trabajar con Rostros Augmentados en tus propias apps.
• Revisa la Referencia de la API de ARCore para iOS.
• Mira el siguiente video sobre cómo comenzar a usar caras aumentadas en iOS: