En esta página, se muestra cómo configurar tu entorno de desarrollo para usar MediaPipe Tasks en tus aplicaciones para iOS.
Dispositivos y plataformas compatibles
Para crear aplicaciones para iOS con MediaPipe Tasks, tu entorno de desarrollo requiere lo siguiente:
macOS Mojave 10.14.3 o versiones posteriores
Xcode 10.3 o una versión posterior
Dispositivo iOS con al menos iOS 12.0. Por otro lado, un simulador de iOS administrar aplicaciones que no requieren la cámara del dispositivo.
Configuración del entorno de desarrollador
Antes de ejecutar una tarea de MediaPipe en una aplicación para iOS, debes tener un proyecto de Xcode existente o crea uno nuevo en tu máquina local.
Las tareas de MediaPipe solo se pueden instalar con CocoaPods. Debes instalar CocoaPods 1.12.1 o una versión superior para comenzar. Para para instalar CocoaPods en macOS, consulta la instalación de CocoaPods de la guía de YouTube.
Ejemplo de configuración del código
El MediaPipe Ejemplos contiene ejemplos de aplicaciones para iOS destinadas a tareas de MediaPipe.
Puedes crear un proyecto a partir del código de ejemplo, compilarlo y ejecutar la tarea. Los siguientes pasos compilan la clase Text Clasificador tarea.
Para importar y compilar el proyecto de código de ejemplo, haz lo siguiente:
Abre la terminal, clona el repositorio de ejemplos de MediaPipe y navega a el directorio que contiene
TextClassifier.xcodeproj
yPodfile
.git clone https://github.com/google-ai-edge/mediapipe-samples cd mediapipe/examples/text_classification/ios
Instala MediaPipe Tasks con CocoaPods:
pod install
Con este comando, se crea un archivo
TextClassifier.xcworkspace
en el ejemplo del proyecto.Haz doble clic en el archivo
TextClassifier.xcworkspace
para abrir el proyecto en Xcode. Si el archivoTextClassifier.xcodeproj
ya está abierto, ciérralo. antes de abrir el archivoTextClassifier.xcworkspace
.Selecciona el esquema
TextClassifier
y elige un dispositivo iOS físico. desde la barra de herramientas de la ventana de tu proyecto. Cuando se usa un dispositivo iOS físico asegúrate de que esté conectado a tu Mac.Haz clic en el botón
Run
en la barra de herramientas de tu proyecto.
Si necesitas más instrucciones para ejecutar una app en Xcode, consulta Cómo compilar y ejecutar una app. un de la app.
Dependencias de las tareas de MediaPipe
MediaPipe Tasks proporciona dos bibliotecas compiladas previamente para visión y texto. El
El archivo de modelo .tflite
debe estar ubicado en el paquete de la aplicación para iOS que
usa el modelo. Dependiendo de MediaPipe Tas, agrega la visión o el texto
a la lista de Pods dentro del Podfile
de CocoaPods. Para obtener instrucciones sobre
Si creas un Podfile
con los Pods necesarios para tu app, consulta Cómo usar
CocoaPods.
Tareas de IA generativa
Las bibliotecas de IA generativa de MediaPipe Tasks contienen tareas que controlan imágenes o
la generación de texto. Para instalar la biblioteca de IA generativa de MediaPipe Tasks, agrega el
Pods de MediaPipeTasksGenAI
y MediaPipeTasksGenAIC
para el destino de tu app en
el Podfile
.
API de inferencia de LLM
La tarea de inferencia de MediaPipe LLM se encuentra en MediaPipeTasksGenAI
y MediaPipeTasksGenAIC
de Pods.
target 'MyLlmInferenceApp' do
use_frameworks!
pod 'MediaPipeTasksGenAI'
pod 'MediaPipeTasksGenAIC'
end
Tareas de visión
La biblioteca de visión de MediaPipe Tasks contiene tareas que controlan imágenes o videos
de datos. Para instalar la biblioteca de visión de MediaPipe Tasks, agrega el
MediaPipeTasksVision
para el destino de tu app en Podfile
target 'MyAppWithMediaPipeTasksVision' do
use_frameworks!
pod 'MediaPipeTasksVision'
end
Tareas de texto
La biblioteca de texto de MediaPipe Tasks contiene tareas que manejan datos de idiomas en
formato de texto. Para instalar la biblioteca de texto MediaPipe Tasks, agrega el siguiente comando:
MediaPipeTasksText
Pod para el destino de tu app en Podfile
target 'MyAppWithMediaPipeTasksText' do
use_frameworks!
pod 'MediaPipeTasksText'
end
Cómo configurar objetivos de prueba
Si tu app tiene un objetivo de prueba, asegúrate de que tu Podfile cumpla con cualquiera de los siguientes implementaciones para evitar cualquier comportamiento no deseado cuando se usa un Biblioteca de tareas de MediaPipe.
La implementación más simple es asegurarse de que el destino de prueba no esté anidado. dentro del destino principal de la app que agrega el Pod de tareas MediaPipe.
target 'MyAppWithMediaPipeTasks' do
pod 'MediaPipeTasksVision'
end
target 'MyAppWithMediaPipeTasksTests' do
end
Si el destino de prueba debe estar anidado dentro del destino principal de la app, el Podfile debe cumpla con la siguiente implementación:
target 'MyAppWithMediaPipeTasks' do
pod 'MediaPipeTasksVision'
target 'MyAppWithMediaPipeTasksTests' do
inherit! :none
end
end
Configuración de BaseOptions
Las BaseOptions permiten la configuración general de las APIs de MediaPipe Task.
Nombre de la opción | Descripción | Valores aceptados |
---|---|---|
modelAssetPath |
La ruta de acceso del modelo a un archivo de modelo en el paquete de aplicación para iOS. | Ruta de acceso como una cadena. |
Aceleración de hardware
En iOS, MediaPipe Tasks solo admite modelos en ejecución en procesadores de CPU estándar.
Soluciona problemas
Para obtener ayuda con preguntas técnicas relacionadas con MediaPipe, visita la discusión group o Stack Menú ampliado para obtener asistencia de la comunidad. Para informar errores o solicitar funciones, informa un problema en GitHub.
Para obtener ayuda con la configuración de tu entorno de desarrollo de iOS, visita la página de Desarrolladores de Apple Documentación.