Guia de início rápido do Cloud Anchors no iOS

A API ARCore Cloud Anchor, ou o serviço ARCore Cloud Anchor, oferece recursos de âncora na nuvem para seus apps iOS, o que faz para os usuários de dispositivos iOS e Android compartilharem experiências de RA.

Neste guia, mostramos como:

  • Configurar o ambiente de desenvolvimento para trabalhar com o Cloud Anchors
  • Testar a hospedagem e a resolução de âncoras em um app de exemplo

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 o Cloud Anchors

As etapas a seguir usam o app de exemplo Cloud Anchors para mostrar os fatores tarefas para configurar e criar um app compatível com o ARCore Cloud Anchors.

Acessar o app de exemplo do Cloud Anchors

  1. Clone ou faça o download do SDK do ARCore para iOS do GitHub para acessar o código de exemplo do app.

  2. Abra uma janela de terminal ou localizador e navegue até a pasta em que você clonou ou fez o download do SDK.

  3. Você pode encontrar o código de exemplo do app em
    /arcore-ios-sdk-master/Examples/CloudAnchorExample.

    O código de exemplo do app de âncoras do Cloud permanentes está em
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample.

Configuração da sessão

O app de exemplo executa as seguintes tarefas importantes como parte da configuração da sessão:

Configurar o compartilhamento de IDs do Cloud Anchor

O app de exemplo do Cloud Anchors usa o Firebase para compartilhar IDs do Cloud Anchor entre dispositivos. É possível usar uma solução diferente nos seus próprios apps.

Para configurar o banco de dados do Firebase no app de exemplo:

  1. Siga as instruções do Firebase para adicionar o Firebase ao seu app.
  2. Faça o download do arquivo GoogleService-Info.plist gerado como parte da adição do Firebase ao app.
  3. Ative o armazenamento do Firebase para a amostra:
    • Acesse o console do Firebase e selecione o projeto que você configurou para o app de exemplo.
    • Selecione o painel Database.
    • Na opção Realtime Database, clique em Get Started.
    • O menu Security rules for Realtime Database será aberto.
      • Para executar a amostra, selecione Start in test mode.
      • Se você estiver usando o Firebase para um app que planeja publicar, use regras de segurança mais restritivas.
  4. No Xcode, adicione o arquivo GoogleService-Info.plist ao seu app, ao lado de Info.plist.

Configurar a API ARCore

Para usar o Cloud Anchors, primeiro você precisa configurar o API ARCore para seu aplicativo.

Executar atualização do pod

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

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

Consulte Adicionar o SDK do ARCore ao seu app para conferir detalhes sobre como configurar o Podfile nos seus apps.

  1. Abra o arquivo .xcworkspace do projeto no Xcode.

    Para evitar erros de build, verifique se você está usando o .xcworkspace e não o arquivo .xcodeproj.

Mudar o ID do pacote do app

No Xcode, altere o ID do pacote do app para que você possa assiná-lo com sua equipe.

Criar e executar o app

  1. Conecte seu dispositivo e inicie o app no Xcode.

  2. (Opcional) Se você estiver criando e executando o app de exemplo, consulte a seção a seguir para saber como usar o app para hospedar e resolver as âncoras do Cloud.

Testar o app de exemplo

  1. Crie e execute o app de exemplo do arquivo .xcworkspace para iniciá-lo no seu dispositivo.

  2. Se solicitado, conceda permissões de câmera ao app. Em seguida, o ARKit começa a detectar aviões em frente à câmera.

  3. Toque em HOST para entrar no modo de hospedagem. Um código de sala para compartilhar âncoras hospedadas é gerado e aparece na tela.

  4. Toque em um plano para começar a hospedar uma âncora de nuvem.

    • O app coloca um objeto Android Andy no plano e anexa uma âncora a ele.
    • Uma solicitação de host é enviada para o endpoint da nuvem da API ARCore. A solicitação do host inclui dados que representam a posição da âncora em relação aos recursos visuais próximos a ela.
    • Depois que a âncora é hospedada, ela recebe um ID que é usado para resolver âncoras de nuvem nesse espaço.

  5. Toque em RESOLVE e digite o código do quarto para acessar antes âncoras do Cloud hospedadas nesta sala, usando o mesmo dispositivo ou outro.

    • Uma solicitação de resolução é enviada para o endpoint da nuvem da API ARCore.
    • A solicitação de resolução inclui um ID de âncora na nuvem. Se o ID corresponder a uma âncora hospedada e a localização for bem-sucedida, o servidor vai retornar a transformação da âncora nas suas coordenadas locais.
    • O app de exemplo usa a transformação para adicionar a âncora à cena e renderizar objetos virtuais anexados a ela.

Adicionar o SDK do ARCore aos seus apps

Nos seus próprios apps, é necessário atualizar Podfile para incluir os SDK do ARCore e controle de versões do iOS com suporte. Para fazer isso:

  1. Adicione os seguintes platform e pod ao Podfile do projeto:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.46.0'
  1. Abra uma janela do Terminal e execute pod update na pasta em que o projeto Xcode está.
    Isso gera um arquivo .xcworkspace que você usa para criar e executar o app.

Âncoras do Cloud permanentes

Conforme descrito em Hospedar uma âncora da nuvem com persistência, é possível definir um tempo de vida útil de até 365 dias para a âncora da nuvem. O exemplo de código para usar âncoras de nuvem persistentes está disponível no diretório /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample do SDK do ARCore para iOS do GitHub.

Próximas etapas