Como criar um Target no Vuforia para chamar de seu
Se você leu o artigo anterior já entende para que servem os targets e como eles funcionam (e se não leu, já começou errado! P.S.: ele está aqui). Tão importante quanto isso, você já é capaz de identificar um bom target passando correndo na rua a 30 km de distância.
A questão é que para usar um target você precisa fazer o design dele e imprimi-lo. Contudo, se você não tem habilidades de design, nem uma impressora disponível (sim, eu estou falando de mim) existe uma alternativa viável: é hora de transformar a capa do seu livro favorito ou aquele panfleto de crediário em um target de verdade, usando seu smartphone, um app de edição de imagens, o Vuforia e paciência (afinal, esse artigo está gigante, mas foi feito com carinho 💖).
É importante salientar que essa não é a melhor forma de produzir um target. Criar uma imagem digitalmente, submeter ao Vuforia e imprimi-la com boa qualidade é um processo que permite fazer correções, quando necessário, e lhe dá certo controle sobre o uso do target. Contudo, esse artigo ainda aborda parte importante deste processo: se você está criando seu próprio design, ignore as etapas 1 e 2, e siga com as demais instruções.
1 — Tirando uma foto do seu futuro target
Tendo em vista que você já sabe o que faz um bom target, é hora de escolher algumas capas de livros, revistas, cadernos, panfletos, fotos… Qualquer coisa impressa que tenhas as características necessárias.
Eu escolhi esses:
Tire uma foto para cada um dos targets. Aqui vão algumas dicas para tirar uma boa foto com o smartphone:
- Lembre-se de evitar objetos que tenham superfícies reflexivas/brilhosas;
- Não use o flash: uma foto com flash pode criar reflexo sobre as imagens;
- Escolha um lugar bem iluminado: a luz do sol e uma janela grande podem ser suas aliadas;
- Cuidado para não formar sombra sobre o objeto;
- Esteja próximo o suficiente para captar todos os detalhes da imagem: certifique-se que o objeto está devidamente focado.
2 — Editando a Foto
Depois de tirar uma foto bem bonita, é hora de fazer os devidos tratamentos na imagem: precisamos tirar as bordas e corrigir o alinhamento. Para isso, recomendo usar o aplicativo Snapseed (disponível para Android e iPhone).
Veja um exemplo de um antes e depois usando o Snapseed:
Salve as imagens e coloque no computador. Para ser usado como target, as imagens devem estar salvas em PNG ou JPG (RGB ou escala de cinza) e ter até 2 MB. Atenção ao enviar o arquivo, aplicativos como o WhatsApp compactam a imagem, o que pode fazer com que elas percam qualidade. Dê preferência a compartilhar através do Google Drive, por exemplo.
Os próximos passos seguimos usando um computador.
3 — Criando uma Conta no Vuforia Developer Portal
O portal do desenvolvedor do Vuforia é o local onde você pode gerenciar as licenças de uso e targets.
Acesse o site https://developer.vuforia.com/ e crie uma conta clicando em Register.
Observe que a senha precisa ter, no mínimo, 8 caracteres, 1 número e letras em maiúsculo e minúsculo. No campo
Companyvocê pode colocar o nome da sua escola.
4 — Criando uma Licença de Desenvolvimento
Assim que você estiver logado no Vuforia Developer Portal, verá a aba License Manager. As licenças de desenvolvimento são códigos alfanuméricos que a aplicação passa para o SDK do Vuforia durante a inicialização. A licença permite relacionar um aplicativo Vuforia a um desenvolvedor e aos recursos habilitados. Elas são necessárias para usar targets personalizados, como os que você irá criar em breve.
É possível criar licenças gratuitamente ou pagando um valor mensal. Clique em Get Development Key para criar uma nova licença gratuita.
No campo License Name coloque alguma referência a aplicação que você está criando. É possível alterar isso posteriormente.
É importante lembrar que: você não deve usar uma mesma licença em várias aplicações diferentes.
Ao selecionar uma licença criada, você verá uma tela semelhante a essa:
Clique no código da licença para copia-la. Em breve, vamos precisar usá-lo. Mais detalhes sobre o que é possível fazer com uma licença aqui.
5 — Criando um Database de Targets
Para manter todos os targets de uma aplicação agrupados, no Vuforia usamos os Targets Databases, que são, basicamente, coleções de targets. É necessário criar um novo database para seus targets. Clique na aba Target Manager e, em seguida, no botão Add Database.
Na tela que aparece defina um nome para esse database (recomendo colocar o mesmo nome da aplicação) e escolha o tipo Device.
Eis um resumo das características de cada tipo de database:
- Device: permite o uso de Image Targets, Multi-Targets, e Cylinder Targets que ficam armazenados no dispositivo. O aplicativo que usa esse tipo de database não precisa se conectar a internet.
- Cloud*: permite o uso de targets que ficam armazenados remotamente. A aplicação faz o download dos targets a medida que vão sendo requisitados. É recomendado para aplicações que precisam reconhecer mais de 1000 targets.
- VuMark*: permite o uso de VuMarks, que são marcadores avançados que misturam os recursos de Image targets e QR Codes.
*Apesar de estarem disponíveis para uso com a licença gratuita, há limites quanto a quantidade de marcadores Cloud que podem ser reconhecidos por mês e VuMarks que podem ser criados. Mais detalhes aqui.
Clique em Create para confirmar.
6 — Adicionando imagens ao database
Agora você irá adicionar as imagens ao database para transformá-los em targets. Com o database aberto, clique em Add Target.
Para databases do tipo device, é possível inserir 4 tipos diferentes de targets: Single Image, Cuboid, Cylinder e 3D Object.
Para gerar um Image Target selecione Single Image.
Em File informe o endereço no seu computador da imagem que você irá transformar em target.
Em Width coloque a largura em metros do target real. O livro Sprint, por exemplo, tem 13,5 cm de largura, logo, o valor inserido para esse target é de 0.135.
Por fim, informe o name, um nome único nesse database que represente o target e clique em Add.
7 — Analisando os Targets
Depois que um target é adicionado ao database, é possível ver a pontuação (rating) dele. Essa pontuação pode variar entre 0 e 5 estrelas e indica quão boa será a detecção dele na aplicação. Clique em um target e mais detalhes estarão disponíveis.
É possível alterar o nome em Edit Namee atualizar a imagem do target, fazendo o upload de uma nova em Update Target.
A direita, é informado a quantidade de estrelas.
Em baixo da imagem do target existe a opção Show Features. Cada feature é representada por uma pequena cruz amarela. Quanto mais features, melhor a qualidade do target e mais estrelas ele terá.
É possível remover o target clicando em Remove.
8 — Download do Database para o Unity
Tendo inserido todos os seus targets, está na hora de fazer o download do database para adicioná-lo ao Unity.
Com o database aberto, selecione um ou mais targets e clique em Download Database. Na janela que se abre, selecione Unity Editor e clique em Download. Dependendo da quantidade de targets, pode demorar alguns minutos.
O database será baixado como um arquivo .unitypackage.
9 — Importando o Database no Unity
Com o arquivo .unitypackage em mãos é hora de abrir o Unity. Neste link, você encontra as instruções de como configurar um projeto AR Vuforia no Unity.
O próximo passo é importar o database. Para isso, basta arrastar o arquivo .unitypackage para dentro do projeto, ou Assets > Import Package > Custom Package e localizar o pacote. Na janela de importação, certifique-se que todos os arquivos estão marcados e clique em Import para finalizar.
A partir desse momento o Unity será capaz de reconhecer os targets. Para usar seu novo database, basta adicionar um novo Image Target em cena: Botão direito dentro de Hierarchy > Vuforia Engine > Image Target. Se já houver um Image Target em cena, basta clicar nele.
Dentro do componente Image Target Behaviour defina o Database que você importou e, em seguida, o Image Target.
10 — Adicionando a Licença de Uso
Para terminar, vamos colocar a licença de uso, aquela do passo 4. Abra o Vuforia Configuration, ele está disponivel em Window > Vuforia Configuration (ou através do atalho Ctrl+Shift+V).
Na seção Global, cole a chave de licença no campo App License Key e depois salve o projeto.
Pronto. É isso. Quando você criar uma aplicação e buildar o projeto, a licença será validada.
Ufa, quem achou que esse tutorial não ia terminar levanta a mão 🙋♂️
Agora que você consegue criar um target com objetos que tem em casa, faça alguns experimentos e mostre para seus familiares!
👌
