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 mais recente
  • Cocoapods 1.4.0 ou mais recente, se estiver usando o Cocoapods
  • Um dispositivo Apple compatível com o ARKit com o iOS 12.0 ou mais recente (é necessário ter o destino de implantação do iOS 12.0 ou mais recente)

Como usar rostos aumentados

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

Conferir o app de exemplo Augmented Faces

  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. O código de exemplo do app está em /Examples/AugmentedFacesExample.

Executar pod install

O app AugmentedFacesSample vem 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 do Xcode está. Isso gera um arquivo *.xcworkspace que você vai usar mais tarde 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 por USB.

Testar o app de exemplo

  1. Crie e execute o app de exemplo usando o 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. Confira se a câmera está voltada para o usuário.

Próximas etapas