Antes de empezar
World Locking Tools para Unity ofrece una API muy eficaz para un control preciso sobre los servicios que ofrece. A primera vista puede ser bastante abrumador.
Una pregunta razonable podría ser: ¿Cuánto código debo escribir para utilizar WLT?
La respuesta, que puede que le sorprenda, es "Ninguno".
WLT se ha estructurado cuidadosamente para controlar la gran mayoría de los casos de uso con una sencilla interfaz de arrastrar y colocar. Algunas pequeñas modificaciones en la escena, como se describe aquí, y la aplicación estará bloqueada en el mundo y sin anclajes.
Personalización del comportamiento mediante código
Hay un pequeño número de casos en los que es posible que quiera crear código adicional para las API de WLT.
En primer lugar, es posible que quiera personalizar las experiencias de los clientes, especialmente en circunstancias excepcionales, como la pérdida de seguimiento. Algunos de estos comportamientos a medida se describen en la sección Control de condiciones excepcionales.
En segundo lugar, es posible que quiera realizar la configuración de WLT en tiempo de ejecución. Cualquier configuración de WLT que se pueda realizar en el inspector de Unity se puede hacer mediante llamadas de script. Del mismo modo, cualquier objeto o componente de WLT que se pueda agregar a la escena e implementar en tiempo de compilación, se puede agregar a la escena en tiempo de ejecución desde el script.
El último caso es cuando se necesita una entrada adicional desde su aplicación con el fin de realizar un servicio para usted. Por ejemplo, para alinear el sistema de coordenadas con las características del mundo físico de la manera deseada, debe proporcionar una indicación de cómo quiere que el sistema de coordenadas se alinee. Esta entrada adicional viene en forma de pares de posiciones de espacio virtual y seguimiento.
Comenzar con calma
WLT se esfuerza por mantener este patrón en todo momento. Para obtener la funcionalidad más comúnmente deseada se requiere una configuración mínima y ningún código. El comportamiento predeterminado se implementa como componentes disponibles. Para personalizar el comportamiento predeterminado, solo se necesita código suficiente para reemplazar el comportamiento proporcionado por el que quiera. Las características adicionales requieren solo una interacción suficiente con la aplicación para indicar sus intenciones.
Hay una gran cantidad de superficie de API en WLT. Se trata de oportunidades de crecimiento para más adelante, por lo que WLT nunca le encasilla. Pero empiece con calma. Puede encontrarse con que WLT hace todo lo que necesita de él sin una línea de código.
En primer lugar, lea y comprenda esta documentación conceptual. En los lugares adecuados encontrará vínculos a la documentación de la API, como referencia para la sintaxis exacta de las llamadas. A continuación, se incluyen vínculos directos a la documentación general de la API.