Esta página mostra como configurar seu ambiente de desenvolvimento para usar o MediaPipe Google Tarefas nos seus aplicativos iOS.
Dispositivos e plataformas compatíveis
Para criar aplicativos iOS com o MediaPipe Tasks, seu ambiente de desenvolvimento requer o seguinte:
macOS Mojave 10.14.3 ou mais recente.
Xcode 10.3 ou mais recente.
dispositivo iOS com o iOS 12.0 ou mais recente; Como alternativa, um simulador para iOS pode processar aplicativos que não precisem da câmera do dispositivo.
Configuração do ambiente do desenvolvedor
Antes de executar uma tarefa MediaPipe em um aplicativo iOS, você precisa ter um projeto Xcode ou crie um novo em sua máquina local.
O MediaPipe Tasks só pode ser instalado usando o CocoaPods. Você precisa instalar o CocoaPods 1.12.1 ou uma versão mais recente antes de começar. Para instruções para instalar o CocoaPods no macOS, consulte esta página de instalação guia.
Exemplo de configuração de código
O MediaPipe Exemplos contém exemplos de aplicativos iOS para tarefas do MediaPipe.
É possível criar um projeto a partir do código de exemplo, compilar o projeto e executar a tarefa. As etapas a seguir criam a configuração Classificador tarefa.
Para importar e criar o projeto de código de exemplo:
Abra o terminal, clone o repositório de exemplos do MediaPipe e acesse o diretório que contém o
TextClassifier.xcodeproj
e oPodfile
.git clone https://github.com/google-ai-edge/mediapipe-samples cd mediapipe/examples/text_classification/ios
Instale o MediaPipe Tasks usando o CocoaPods:
pod install
Esse comando cria um arquivo
TextClassifier.xcworkspace
no exemplo do projeto.Clique duas vezes no arquivo
TextClassifier.xcworkspace
para abrir o projeto em Xcode. Se o arquivoTextClassifier.xcodeproj
já estiver aberto, feche-o. antes de abrir o arquivoTextClassifier.xcworkspace
.Selecione o esquema
TextClassifier
e escolha um dispositivo físico com iOS ou na barra de ferramentas da janela do projeto. Ao usar um dispositivo iOS físico verifique se ele está conectado ao Mac.Clique no botão
Run
, na barra de ferramentas do projeto.
Para mais instruções sobre como executar um aplicativo no Xcode, consulte Como criar e executar um app.
Dependências do MediaPipe Tasks
O MediaPipe Tasks fornece duas bibliotecas pré-criadas para visão e texto. A
O arquivo modelo .tflite
precisa estar localizado no pacote do aplicativo iOS que
usa o modelo. Dependendo do MediaPipe Tas, adicione a visão ou o texto
à lista de pods na Podfile
do CocoaPods. Para instruções sobre
criar um Podfile
com os pods necessários para seu aplicativo, consulte Como usar
CocoaPods.
Tarefas da IA generativa
As bibliotecas de IA generativa do MediaPipe Tasks contêm tarefas que processam imagens ou
geração de textos. Para instalar a biblioteca de IA generativa do MediaPipe Tasks, adicione o
MediaPipeTasksGenAI
e MediaPipeTasksGenAIC
pods ao destino do app em
o Podfile
.
API LLM Inference
A tarefa de inferência de LLMs do MediaPipe está contida no MediaPipeTasksGenAI
e MediaPipeTasksGenAIC
de pods.
target 'MyLlmInferenceApp' do
use_frameworks!
pod 'MediaPipeTasksGenAI'
pod 'MediaPipeTasksGenAIC'
end
Tarefas de visão
A biblioteca de visão do MediaPipe Tasks contém tarefas que lidam com imagens ou vídeos
de entrada. Para instalar a biblioteca de visão do MediaPipe Tasks, adicione o
MediaPipeTasksVision
ao destino do app em Podfile
.
target 'MyAppWithMediaPipeTasksVision' do
use_frameworks!
pod 'MediaPipeTasksVision'
end
Tarefas de texto
A biblioteca de texto MediaPipe Tasks contém tarefas que lidam com dados de idioma no
em um formato de texto simples. Para instalar a biblioteca de texto do MediaPipe Tasks, adicione o
MediaPipeTasksText
ao destino do app em Podfile
target 'MyAppWithMediaPipeTasksText' do
use_frameworks!
pod 'MediaPipeTasksText'
end
Configurar destinos de teste
Se o app tiver um destino de teste, verifique se o Podfile está em conformidade com uma das as seguintes implementações para evitar qualquer comportamento indesejável ao usar uma Biblioteca de tarefas do MediaPipe.
A implementação mais simples é garantir que o destino do teste não esteja aninhado. no destino principal do app que adiciona o pod de tarefas do MediaPipe.
target 'MyAppWithMediaPipeTasks' do
pod 'MediaPipeTasksVision'
end
target 'MyAppWithMediaPipeTasksTests' do
end
Se o destino do teste precisar estar aninhado no destino do app principal, o Podfile precisará estão com a seguinte implementação:
target 'MyAppWithMediaPipeTasks' do
pod 'MediaPipeTasksVision'
target 'MyAppWithMediaPipeTasksTests' do
inherit! :none
end
end
Configuração BaseOptions
A BaseOptions permite a configuração geral das APIs MediaPipe Task.
Nome da opção | Descrição | Valores aceitos |
---|---|---|
modelAssetPath |
O caminho do modelo para um arquivo modelo no pacote de aplicativos para iOS. | Caminho como uma string. |
Aceleração de hardware
No iOS, o MediaPipe Tasks só é compatível com a execução de modelos em processadores de CPU padrão.
Solução de problemas
Para obter ajuda com questões técnicas relacionadas ao MediaPipe, visite a discussão group ou Stack Overflow (em inglês) para receber suporte de na comunidade. Para informar bugs ou solicitar recursos, registre um problema no GitHub (em inglês).
Para receber ajuda na configuração do ambiente de desenvolvimento do iOS, visite a página do Apple Developer Documentação.