Guia de início rápido de rostos aumentados para iOS

Neste guia, mostramos como:

  • Configurar o ambiente de desenvolvimento para trabalhar com rostos aumentados
  • Aplicar texturas 2D e anexar objetos 3D a rostos detectados

Pré-requisitos

  • Xcode versão 13.0 ou posterior
  • Cocoapods 1.4.0 ou mais recente, se estiver usando o Cocoapods
  • Um dispositivo Apple compatível com ARKit com iOS 12.0 ou mais recente (destino de implantação do iOS 12.0 ou posterior obrigatório)

Como usar rostos aumentados

As etapas a seguir usam o app de exemplo de rostos aumentados para mostrar as tarefas essenciais para configurar e criar um app com os recursos de rostos aumentados.

Instalar o app de exemplo de rostos aumentados

  1. Clone ou faça o download do SDK do ARCore para iOS mais recente no GitHub para acessar o exemplo de código do app.
  2. Abra uma janela do Terminal ou do Finder e navegue até a pasta em que você clonou ou fez o download do SDK.
  3. Você pode encontrar o código do app de exemplo em /Examples/AugmentedFacesExample.

Executar pod install

O app AugmentedFacesSample é fornecido com um Podfile pré-configurado com o SDK do ARCore e as versões do iOS necessárias. Para instalar essas dependências:

  1. Abra uma janela do Terminal e execute pod install na pasta em que o projeto Xcode está. Isso gera um arquivo *.xcworkspace que você usará posteriormente para criar e executar o app.

Criar e executar o app

  1. Abra o arquivo .xcworkspace (não o .xcodeproj) do projeto no Xcode.
  2. Abra as configurações gerais do destino e mude o identificador do pacote.
  3. Pressione Cmd+R ou clique em "Executar". Use um dispositivo físico, não o simulador, para trabalhar com o recurso Rostos aumentados. O dispositivo precisa estar conectado à máquina de desenvolvimento via USB.

Testar o app de exemplo

  1. Crie e execute o app de exemplo do arquivo .xcworkspace para iniciá-lo no dispositivo.
  2. Se solicitado, conceda permissões de câmera ao app. O ARCore vai começar a detectar rostos visíveis na câmera. No momento, apenas um rosto é detectado por vez.
  3. Verifique se a câmera está voltada para o usuário.

Próximas etapas