Capítulo 1 del tutorial de Mesh 201: Introducción, configuración y introducción
Si completó el tutorial de Mesh 101, se puso en marcha con la creación de una experiencia de Mesh y obtuvo una comprensión sólida de interactables, física, scripting visual, etc. En este tutorial de "Mesh 201", se basará en ese conocimiento. Visitará varias estaciones y obtendrá información sobre lo siguiente:
- Cómo usar WebSlates para mostrar contenido web en su experiencia.
- Agregue un globo interactivo. Cuando un asistente de la experiencia hace clic en el mundo, se captura la latitud y longitud de la ubicación en la que se hace clic y estas coordenadas se incorporan en una dirección URL de Mapas de Bing como parámetros. Se ejecuta una solicitud HTTP mediante esta dirección URL; Mapas de Bing proporciona un mapa del área elegida y lo envía a un WebSlate cercano, que es una pantalla que puede mostrar imágenes, vídeos, contenido interactivo, etc.
A finales de mayo de 2024, se ha actualizado el tutorial de Mesh 201 para incluir dos estaciones adicionales que incluyen Mesh Cloud Scripting, que puede usar para llamar a cualquier API de .NET y traer datos en la nube en tiempo real al entorno. El tutorial de Mesh 101 se diseñó para enseñar a los asistentes en su experiencia sobre parques eólicos, y las dos nuevas estaciones continúan con ese tema proporcionando a los asistentes información que puede ayudarles a decidir dónde construir un nuevo parque eólico. En estas estaciones aprenderá a implementar lo siguiente:
Extraiga datos de orígenes internos o públicos en la escena. Un asistente en el evento podrá hacer clic en un globo interactivo para ver los datos meteorológicos en vivo de tres ciudades que están considerando para la ubicación de su nuevo parque eólico.
Configure interacciones con inteligencia artificial mediante un asistente virtual basado en OpenAI o un "bot de chat". Un asistente puede hacer clic en un botón "Info" y formular preguntas sobre las mejores ubicaciones para parques eólicos. Usted, el desarrollador, agregará código que proporcionará el LLM de OpenAI (modelo de lenguaje grande con algún contexto para las preguntas relacionadas con el parque eólico que es probable que los asistentes estén preguntando.
El proyecto de tutorial se denomina Mesh201 y se incluye al descargar los ejemplos y tutoriales de Mesh desde GitHub.
Importante
El proyecto del tutorial se rige por la licencia MIT, tal como se muestra en el archivo LICENSE.txt del repositorio Mesh-Toolkit-Unity . Sin embargo, la funcionalidad de ejemplos depende del kit de herramientas de Mesh, que se rige por una licencia independiente y contiene software de terceros. Se requiere una licencia de Teams Premium para usar la aplicación Mesh para espacios envolventes personalizados en Mesh en PC y Quest. No se requiere una licencia para desarrollar con el kit de herramientas de Mesh, pero se le bloqueará la creación y publicación de entornos en Mesh y la organización o unión de eventos en Mesh si usted y los usuarios no tienen licencias de Teams Premium. Para obtener más información, consulte Configuración de M365 para Microsoft Mesh.
El tutorial se estructura de la siguiente manera:
Capítulo 1: Información general, configuración y introducción. (este artículo)
Capítulo 2: Carga de un archivo HTML local no compartido en un webSlate.
Capítulo 3: Carga de un archivo HTML compartido local en un WebSlate.
Capítulo 5: Hacer clic en un globo interactivo para obtener datos meteorológicos en vivo
Capítulo 6: Obtención de respuestas a preguntas mediante Azure OpenAI
Requisitos previos
Familiaridad con la clonación de GitHub y Git LFS
Experiencia anterior de Unity
En este tutorial se supone que tiene las aptitudes de Unity intermedias a avanzadas necesarias para editar un entorno. También se recomienda que esté familiarizado con el scripting visual de Unity. Un buen lugar para aprender los conceptos básicos de Visual Scripting es a través del tutorial de Visual Scripting de Unity. Esto le enseña más si no todos los conceptos que necesita para empezar a trabajar con Mesh Visual Scripting.
Desarrollo anterior de Mesh con Visual Scripting o finalización del tutorial de Mesh 101
Si ha estado desarrollando experiencias de Mesh durante un tiempo y está familiarizado no solo con Unity Visual Scripting en general, sino también con algunos de los nodos de Visual Scripting específicos de Mesh más comunes, probablemente puede completar este tutorial correctamente sin haber pasado primero por el tutorial de Mesh 101. Si tiene alguna duda, le recomendamos que complete el tutorial de Mesh 101. Las siguientes características se trataron en la documentación del tutorial de Mesh 101 y también se incluyen en el proyecto de Unity de Mesh 201, pero no se tratarán de nuevo en la documentación de Mesh 201. Si tiene la necesidad de comprender mejor estos conceptos, haga clic en los vínculos.
Desactivar los iconos de objeto para una vista más clara
Modo de reproducción con emulación de malla
Requisitos de hardware
Requisitos mínimos de PC: 4 núcleos de CPU, 8 GB de RAM
Versión 2022.3.34 de Unity
La versión 2022.3.34 de Unity es necesaria para este tutorial.
Revisión de los requisitos del sistema para Unity
Obtener ayuda para instalar Unity
La instalación debe incluir módulos para Android y Windows. La aplicación Mesh funciona para pc y Meta Quest, y Android es el sistema operativo para quest.
Configuración de scripting en la nube de Mesh
Al final de este tutorial, tiene la opción de compilar y publicar el proyecto completado en Mesh en la web y, a continuación, crear un evento a partir de él que puede ejecutar en la aplicación Mesh. Gracias al emulador de Mesh, todavía puede ver cómo se verá el proyecto terminado en la aplicación Mesh sin compilar ni publicar. Si quiere recorrer paso a paso el proceso de compilación y publicación, necesita una preparación adicional para que el scripting en la nube de Mesh funcione. Para obtener más información, consulte el artículo Preparación para el primer proyecto de scripting en la nube de Mesh y asegúrese de que ha abordado los requisitos previos enumerados allí.
Una suscripción a M365 Office y familiaridad con el Azure Portal.
Tendrá que usar Azure Portal para configurar OpenAI en el capítulo 6.
Importante: OpenAI solo está disponible para clientes empresariales y asociados aprobados. Si aún no está en este grupo, debe enviar un formulario de registro. Obtenga más información sobre el proceso de registro.
Configuración de elementos para Mesh
Descarga de la aplicación de escritorio mesh
Descarga de Microsoft Mesh en PC
Descarga de los ejemplos y tutoriales de Mesh
Para obtener el tutorial de Mesh 201, debe ir al repositorio Mesh-Toolkit-Unity y clonar el repositorio.
NOTAS:
- GitHub también ofrece la opción de descargar los ejemplos en un archivo Zip. Se recomienda clonar el repositorio, ya que es más conveniente obtener actualizaciones futuras simplemente actualizando el repositorio en lugar de descargar un nuevo archivo Zip cada vez.
- Actualmente no aceptamos contribuciones de código a nuestros ejemplos. Si tiene algún comentario o si tiene algún problema con los ejemplos o el kit de herramientas de Mesh, haga lo siguiente: en un proyecto de Unity que tenga instalado el paquete del kit de herramientas de Mesh, seleccione Mesh Toolkit>Give feedback to Microsoft (Proporcionar comentarios a Microsoft ) y, a continuación, use el vínculo de comentarios del kit de herramientas de Mesh para informarnos.
Importante: Si va a clonar, debe tener instalado Git LFS.
Seleccione el botón Código y, a continuación, haga clic en el botón "Copiar dirección URL al Portapapeles".
Se recomienda crear una carpeta en la unidad C: denominada "Ejemplos de malla" y, a continuación, clonar el repositorio en esa carpeta. Este es un buen nombre por dos motivos: es corto, por lo que evita encontrarse con un problema con el límite de longitud de la ruta de acceso de Windows, que es de 256 caracteres. Además, hay otros ejemplos de Mesh además del tutorial de Mesh 201, por lo que todas las muestras se ubicarán en un solo lugar.
En la carpeta recién creada, cree un repositorio de Git y, a continuación, clone el repositorio pegando la dirección URL copiada después del comando de clonación de Git en Git Bash y, a continuación, presionando la tecla Entrar.
Paquete del kit de herramientas de Mesh
Para este tutorial, el único paquete que necesita es el paquete del kit de herramientas de Mesh y ya está cargado previamente en el proyecto del tutorial. Si estuviera creando su propio proyecto desde cero, tendría que importar el paquete del kit de herramientas de Mesh.
Escenas del proyecto
Abra el proyecto Mesh201 en Unity. Si tiene instalada más de una versión de Unity, asegúrese de abrir el proyecto con
Unity 2022.3.34el que es necesario para este tutorial.ADVERTENCIA: El proyecto podría tardar 15 minutos o un poco más en cargarse debido a grandes tamaños de recursos. Si es necesario, cambie la configuración del modo de suspensión para que el equipo no entre en suspensión mientras se carga el proyecto. Si esto sucede, podría hacer que el proyecto no se cargue correctamente.
En la carpeta Activos , tenga en cuenta que hay dos escenas disponibles: Punto inicial y Proyecto terminado.
StartingPoint: esta es la escena en la que va a realizar el tutorial. Contiene una configuración precompilada que incluye WebSlates y el mundo interativo al que visitará y agregará características de Mesh.
FinishedProject: como indica el título, esta escena contiene una versión completa precisa del tutorial. Puede hacer referencia a esto en cualquier momento para confirmar que ha completado los pasos del tutorial en la escena de StartingPoint correctamente. Guarde siempre el trabajo en la escena de StartingPoint antes de cambiar de escena.
Probar el proyecto finalizado
Se recomienda abrir la escena FinishedProject , ejecutarla y visitar algunas de las estaciones que contiene para probar algunas de las características de Mesh que va a implementar en el tutorial. Las estaciones se encuentran en un GameObject denominado Sphere Terrace.
Haga clic en el botón Unity Editor Reproducir.
Las estaciones 1, 2 y 3 se encuentran a un lado de la Terraza sphere. Vaya a esta área y colócate para que estés frente a las estaciones.
Acérquese a Las estaciones 1 y 2 y haga clic en los botones Cargar . Observe que esta acción carga páginas HTML en WebSlates.
Muévete delante de la Estación 3 y, a continuación, haz clic en varios puntos diferentes en el objeto de la Tierra ; puedes girarlo haciendo clic con el botón izquierdo sobre él y arrastrando. Observe cómo cada vez que hace clic, aparece un mapa de esa área en el WebSlate cercano.
Haga clic en el botón Unity Editor Play (Reproducir) para salir del modo de reproducción.
Compruebe la configuración de la ventana de escena "Scale" (Escala)
Si las cosas se ven un poco borrosas en la ventana Juego cuando estás en modo de reproducción, echa un vistazo al control deslizante Escala situado justo encima de la ventana. Para obtener la mejor fidelidad visual, el control deslizante debe moverse hasta la izquierda para que la escala sea igual a "1x".
