Antes de começar
O World Locking Tools for Unity oferece uma API muito poderosa para um bom controle sobre os serviços que oferece. À primeira vista, pode ser bastante avassalador.
Uma pergunta razoável pode ser: Quanto código devo esperar escrever para usar o WLT?
A resposta, que pode surpreendê-lo, é "Nenhuma".
O WLT foi cuidadosamente estruturado para lidar com a grande maioria dos casos de uso com uma interface simples de arrastar e soltar. Algumas pequenas modificações em sua cena, conforme descrito aqui, e seu aplicativo está bloqueado no mundo e livre de âncoras.
Personalizando o comportamento através do código
Há um pequeno número de casos em que você pode querer fazer codificação adicional em relação às APIs WLT.
Primeiro, você pode querer personalizar as experiências de seus clientes, especialmente em circunstâncias extraordinárias, como perda de rastreamento. Alguns desses comportamentos personalizados são descritos na seção Manipulação de condições excecionais.
Em segundo lugar, você pode querer fazer sua configuração WLT em tempo de execução. Qualquer configuração de WLT que possa ser feita no Unity Inspetor pode ser feita por chamadas de script. Da mesma forma, qualquer objeto ou componente WLT que possa ser adicionado à cena e implantado em tempo de compilação, pode ser adicionado à cena em tempo de execução a partir do script.
O último caso é quando é necessária uma entrada adicional do seu aplicativo para executar um serviço para você. Por exemplo, para alinhar seu sistema de coordenadas com os recursos do mundo físico da maneira desejada, você deve dar uma indicação de como deseja alinhar o sistema de coordenadas. Esta entrada adicional vem na forma de pares de poses de espaço virtual e de rastreamento.
Comece fácil
A WLT esforça-se por manter este padrão durante todo o processo. Para obter a funcionalidade mais comumente desejada não requer codificação e configuração mínima. O comportamento padrão é implementado como componentes disponíveis. A personalização do comportamento padrão requer apenas código suficiente para substituir o comportamento fornecido pelo comportamento desejado. Recursos adicionais exigem apenas interação suficiente com seu aplicativo para indicar suas intenções.
Há muita superfície de API no WLT. Essas são oportunidades de crescimento para mais adiante, de modo que a WLT nunca o encaixa. Mas comece simples. Você pode achar que o WLT faz tudo o que você precisa dele sem uma linha de código.
Primeiro, leia e compreenda esta documentação conceptual. Em locais apropriados, você encontrará links para a documentação da API, como referência para a sintaxe exata de chamada. Links diretos para a documentação geral da API estão incluídos abaixo.