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)

Observação: a partir do ARCore 1.12, todos os dispositivos compatíveis com o ARKit são compatíveis.

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.

Observação: como o simulador não tem uma câmera, os apps que usam rostos aumentados precisam ser executados em um dispositivo físico.

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

• Consulte o Guia do desenvolvedor de rostos aumentados para iOS para explorar o código do aplicativo de exemplo e saber mais sobre como trabalhar com rostos aumentados em seus próprios aplicativos.
• Revise a Referência da API ARCore para iOS.
• Assista o vídeo abaixo para saber como começar a usar o recurso Rostos aumentados no iOS: