Inicio rápido: Comenzar a usar 3D Scenes Studio (versión preliminar) para Azure Digital Twins

Azure Digital Twins 3D Scenes Studio (versión preliminar) es un entorno 3D inmersivo, donde los trabajadores empresariales y de primera línea pueden consumir e investigar datos operativos de sus soluciones de Azure Digital Twins con contexto visual.

En este artículo, configurará todos los recursos necesarios para usar 3D Scenes Studio, incluida una instancia de Azure Digital Twins con datos de ejemplo y recursos de Azure Storage. A continuación, creará una escena en el Studio que conecta con el entorno de ejemplo de Azure Digital Twins.

La escena de ejemplo que se usa en este inicio rápido supervisa la eficiencia de transporte de los brazos robóticos en una fábrica. Los brazos robóticos recogen algunas cajas cada hora, mientras que las cámaras de vídeo supervisan cada uno de los brazos para detectar si el brazo no pudo recoger una caja. Cada brazo tiene un gemelo digital asociado en Azure Digital Twins, y los gemelos digitales se actualizan con datos cada vez que un brazo no sujeta una caja. Según este escenario, este inicio rápido le guiará a través de la configuración de una escena 3D para que visualice los brazos en la fábrica, junto con las alertas visuales cada vez que no sujetan una caja.

La escena tiene este aspecto:

Requisitos previos

Necesita una suscripción de Azure para completar este inicio rápido. Si aún no tiene una, cree una gratis .

También debe descargar un archivo 3D 3D de ejemplo glTF (formato de transmisión de lenguaje gráfico) para usarlo para la escena de este inicio rápido. Descargue el siguiente archivo de ejemplo de GitHub: RobotArms.glb.

Configuración de Azure Digital Twins y datos de muestra

El primer paso para trabajar con Azure Digital Twins es crear una instancia de Azure Digital Twins. Después de crear una instancia del servicio, puede vincularla a una visualización de 3D Scenes Studio más adelante en el inicio rápido.

El resto de esta sección le guiará a través de los pasos de creación de la instancia. Si ya tiene una instancia de Azure Digital Twins configurada desde un inicio rápido anterior, puede ir a la sección siguiente.

Creación de una instancia de Azure Digital Twins

En esta sección, va a crear una instancia de Azure Digital Twins mediante Azure Portal. Vaya al Portal e inicie sesión con sus credenciales.

1. Una vez en el portal, seleccione Crear un recurso en el menú de la página principal de servicios de Azure, para comenzar.

   

2. Busque Azure Digital Twins en el cuadro de búsqueda y elija el servicio Azure Digital Twins en los resultados.

   Deje el campo Plan establecido en Azure Digital Twins y seleccione el botónCrear para empezar a crear una nueva instancia del servicio.

   

3. Rellene los campos de la pestaña Aspectos básicos de la configuración, incluida la suscripción, el grupo de recursos, un nombre de recurso para la nueva instancia y la región. Active la casilla Assign Azure Digital Twins Data Owner Role (Asignar el rol Propietario de datos de Azure Digital Twins) para concederse permisos para administrar los datos de la instancia.

   

   Nota

   Si la casilla Assign Azure Digital Twins Data Owner Role (Asignar el rol Propietario de datos de Azure Digital Twins) está en gris, significa que no tiene permisos en la suscripción de Azure para administrar el acceso de los usuarios a los recursos. Puede seguir creando la instancia en esta sección y, a continuación, debe hacer que alguien con los permisos necesarios le asigne este rol en la instancia antes de completar el resto de esta guía de inicio rápido.

   Los roles comunes que cumplen este requisito son propietario, administrador de cuentas o la combinación de administrador de acceso de usuarios y colaborador.

4. Seleccione Revisar y crear para terminar de crear la instancia.

5. Verá una página de resumen en la que se muestran los detalles especificados. Para confirmar y crear la instancia, seleccione Create (Crear).

Esta acción le lleva a una página información general que realiza el seguimiento del estado de implementación de la instancia.

Espere a que la página diga que la implementación ha finalizado.

Recopilación del nombre de host

Cuando termine la implementación de la instancia, use el botón Go to resource (Ir al recurso) para ir a la página de información general de la instancia en el portal.

A continuación, anote el valor del nombre de host de la instancia para usarlo más adelante.

Generación de modelos de ejemplo y gemelos

En esta sección, usará la herramienta de simulador de datos de Azure Digital Twins para generar modelos de ejemplo y gemelos para rellenar la instancia. A continuación, use el simulador para transmitir datos de ejemplo a los gemelos del grafo.

Nota

En este inicio rápido se proporcionan modelos, gemelos y datos simulados para simplificar el proceso de creación de un entorno que puede ver en 3D Scenes Studio. Al diseñar su propia solución completa de Azure Digital Twins, cree modelos y gemelos para describir su propio entorno en detalle y configurar sus propios flujos de datos en consecuencia.

Este escenario de ejemplo representa un centro de distribución de paquetes que contiene seis brazos robóticos. Cada brazo tiene un gemelo digital con propiedades para realizar un seguimiento de cuántas cajas no puede recoger el brazo, junto con los id. de las cajas sin recoger.

1. Vaya al simulador de datos en el explorador web.

2. En el espacio de la dirección URL de la instancia, escriba el nombre de host de la instancia de Azure Digital Twins de la sección anterior. Establezca el Tipo de simulación en Brazos de robot.

3. Use el botón Generar entorno para crear un entorno de ejemplo con modelos y gemelos. (Si ya tiene modelos y gemelos en la instancia, esta acción no las elimina, solo agrega más).

   

4. Desplácese hacia abajo y seleccione Iniciar simulación para empezar a enviar datos simulados a la instancia de Azure Digital Twins. La simulación se ejecuta mientras esta ventana está abierta y la opción Iniciar simulación está activa.

Puede ver los modelos y gráficos que se crean mediante la herramienta Graph de Azure Digital Twins Explorer. Para cambiar a esa herramienta, seleccione el icono Graph en el menú izquierdo.

A continuación, use el botón Ejecutar consulta para consultar todos los gemelos y relaciones que se crean en la instancia.

Puede seleccionar cada gemelo para verlo con más detalle.

Para ver los modelos que se cargan y cómo se relacionan entre sí, seleccione Gráfico de modelos.

Sugerencia

Para obtener una introducción a Azure Digital Twins Explorer, consulte la guía de inicio rápido Introducción a Azure Digital Twins Explorer.

Creación de recursos de almacenamiento

A continuación, cree una cuenta de almacenamiento y un contenedor en la cuenta de almacenamiento. 3D Scenes Studio usa este contenedor de almacenamiento para almacenar la información de configuración y el archivo 3D.

También ha configurado permisos de lectura y escritura en la cuenta de almacenamiento. Para configurar estos recursos de copia de seguridad rápidamente, en esta sección se usa Azure Cloud Shell.

1. Vaya a Cloud Shell en el explorador.

   Ejecute el siguiente comando para establecer el contexto de la CLI en la suscripción de esta sesión.

   az account set --subscription "<your-Azure-subscription-ID>"
   

2. Ejecute el comando siguiente para crear una cuenta de almacenamiento en la suscripción. El comando contiene marcadores de posición para que escriba un nombre y elija una región para la cuenta de almacenamiento y un marcador de posición para el grupo de recursos.

   az storage account create --resource-group <your-resource-group> --name <name-for-your-storage-account> --location <region> --sku Standard_RAGRS
   

   Cuando el comando se complete correctamente, verá los detalles de la nueva cuenta de almacenamiento en la salida. Busque el valor de ID en la salida y cópielo para usarlo en el comando siguiente.

   

3. Ejecute el siguiente comando para concederse el rol Propietario de datos de blobs de almacenamiento en la cuenta de almacenamiento. Este nivel de acceso permite realizar operaciones de lectura y escritura en 3D Scenes Studio. El comando contiene marcadores de posición para el correo electrónico asociado a la cuenta de Azure y el id. de la cuenta de almacenamiento que copió en el paso anterior.

   az role assignment create --role "Storage Blob Data Owner" --assignee <your-Azure-email> --scope <ID-of-your-storage-account>
   

   Cuando el comando se complete correctamente, verá los detalles de la asignación de roles en la salida.

4. Ejecute el siguiente comando a fin de configurar CORS para la cuenta de almacenamiento. Esta configuración es necesaria para que 3D Scenes Studio acceda al contenedor de almacenamiento. El comando contiene un marcador de posición para el nombre de la cuenta de almacenamiento.

   az storage cors add --services b --methods GET OPTIONS POST PUT --origins https://explorer.digitaltwins.azure.net --allowed-headers Authorization x-ms-version x-ms-blob-type --account-name <your-storage-account>
   

   Este comando no tiene ninguna salida.

5. Ejecute el comando siguiente para crear un contenedor privado en la cuenta de almacenamiento. Los archivos de 3D Scenes Studio se almacenan aquí. El comando contiene un marcador de posición para que introduzca un nombre para el contenedor de almacenamiento y un marcador de posición para el nombre de la cuenta de almacenamiento.

   az storage container create --name <name-for-your-container> --public-access off --account-name <your-storage-account>
   

   Cuando el comando se completa correctamente, la salida muestra "created": true.

Inicialización del entorno de 3D Scenes Studio

Ahora que todos los recursos están configurados, puede usarlos para crear un entorno en 3D Scenes Studio. En esta sección, creas una escena y la personalizas para el gráfico de ejemplo que está en la instancia de Azure Digital Twins.

1. Vaya a 3D Scenes Studio. El estudio se abre y está conectado a la instancia de Azure Digital Twins a la que accediste por última vez en el Azure Digital Twins Explorer. Ignore la demo de bienvenida.

   

2. Seleccione el icono Editar situado junto al nombre de la instancia para configurarla y ver los detalles del contenedor de almacenamiento.

   

   1. En el campo Azure Digital Twins instance URL, rellene el nombre de host de la instancia del paso Recopilación del nombre de host en esta dirección URL: https://<your-instance-host-name>.

   2. En Azure Storage container URL, rellene el nombre de la cuenta de almacenamiento en el paso Create storage resources en esta dirección URL: https://<your-storage-account>.blob.core.windows.net.

   3. En Azure Storage container name, escriba el nombre del contenedor de almacenamiento en el paso Create storage resources.

   4. Seleccione Guardar.

   

Incorporación de una nueva escena 3D

En esta sección, creará una nueva escena 3D con el archivo de modelo RobotArms.glb 3D que descargó anteriormente en Requisitos previos. Una escena consta de un archivo de modelo 3D y un archivo de configuración creado automáticamente.

Esta escena de ejemplo contiene una visualización del centro de distribución y sus brazos. Conectas esta visualización con los gemelos de ejemplo que creaste en el paso Generar modelos de ejemplo y gemelos y personalizarás la vista impulsada por los datos en pasos posteriores.

1. Seleccione el botón Agregar escena 3D para empezar a crear una nueva escena. Introduzca un nombre y una descripción para la escena y seleccione Upload file.

   

2. Busque el archivo RobotArms.glb en el equipo y ábralo. Seleccione Crear.

   

   Una vez cargado el archivo, verá que aparece de nuevo en la pantalla principal de 3D Scenes Studio.

3. Seleccione la escena para abrirla y verla. La escena se abre en modo de compilación .

   

Creación de un elemento de escena

A continuación, definirá un elemento en la visualización 3D y lo vinculará a un gemelo en el grafo de Azure Digital Twins que configuró anteriormente.

1. Seleccione cualquier brazo robotizado en la visualización de la escena. Esta selección muestra las posibles acciones del elemento. Seleccione + Crear un nuevo elemento.

   

2. En el panel Nuevo elemento, la lista desplegable Gemelo principal contiene los nombres de todos los gemelos de la instancia de Azure Digital Twins conectada.

   1. Seleccione Arm1. Esta selección aplica automáticamente el identificador del gemelo digital ($dtId) como nombre del elemento.

   2. Seleccione Crear elemento.

   

El elemento se muestra ahora en la lista de elementos de la escena.

Creación de un comportamiento

A continuación, creará un comportamiento para el elemento . Estos comportamientos le permiten personalizar los objetos visuales de datos del elemento y la lógica de negocios asociada. A continuación, puede explorar estos elementos visuales de datos para comprender el estado del entorno físico.

1. Cambie a la lista Comportamientos y seleccione Nuevo comportamiento.

   

2. En Nombre para mostrar, escriba Eficiencia de la línea de empaquetado. En Elements, seleccione Arm1.

   

3. Omita la pestaña Twins, que no se usa en este inicio rápido.

4. Cambie a la pestaña Reglas visuales. Las reglas visuales son superposiciones controladas por datos en los elementos que puede configurar para indicar el estado del elemento.

   1. En primer lugar, establece algunas condiciones para indicar la eficacia de la línea de embalaje.

      1. Seleccione Agregar regla.

         

      2. Escriba un Nombre para mostrar como Hourly pickups. Deje la Expresión de propiedad en Propiedad única y abra la lista desplegable de propiedades. Esta contiene los nombres de todas las propiedades del gemelo principal para el elemento Arm1. Seleccione PrimaryTwin.FailedPickupsLastHr. Luego seleccione Agregar condición.

         

      3. A continuación, definirá algunos límites para indicar cuándo faltan demasiadas recogidas por hora. En este escenario, supongamos que un brazo necesita atención si falla al intentar recoger más de tres paquetes en una hora. Etiquete la condición >3 paquetes no recogidos y defina un valor entre 4 e infinito (el valor de rango mín. es inclusivo, y el valor máx. es exclusivo). Asigne un Color de elemento rojo. Seleccione Guardar.

         

      4. Seleccione Agregar condición de nuevo y cree una condición etiquetada 1-3 paquetes no recogidos. Defina un intervalo de valores entre 1 y 4 y asigne un Color de elemento naranja. Guarde la condición.

         Seleccione Agregar condición una vez más y cree una condición etiquetada 0 paquetes no recogidos. Defina un intervalo de valores entre 0 y 1 y asigne un Color de elemento verde. Guarde la condición.

         Después de crear las tres condiciones, seleccione Guardar para guardar la nueva regla visual.

         

   2. A continuación, cree una regla visual más para mostrar alertas de paquetes no recogidos.

      1. En la pestaña Reglas visuales, seleccione Agregar regla de nuevo.

         

      2. Escriba un Nombre para mostrar como PickupFailedAlert. Cambie la Expresión de propiedad a Personalizada (avanzado), escriba una propiedad como PrimaryTwin.PickupFailedAlert; y establezca el Tipo en booleano. Esta selección de propiedades hace referencia a una propiedad booleana en el gemelo del brazo que se establece en True cuando se produce un error en la recogida de un paquete. Seleccione Agregar condición.

         

      3. Escriba una Etiqueta como ${PrimaryTwin.PickupFailedBoxID} failed. Más adelante, en la vista de escena, esta etiqueta muestra dinámicamente el valor de la propiedad de cadena del gemelo del brazo PickupFailedBoxID, que contiene un identificador que representa el cuadro que el brazo más recientemente no pudo recoger. Establezca el valor en True y elija un Tipo visualDistintivo. Establezca el Color en rojo y elija un Icono. Seleccione Guardar para agregar la condición y, a continuación, seleccione Guardar para guardar la regla visual.

         

      Ahora debería ver las dos reglas enumeradas en la pestaña Reglas visuales.

      

5. Cambie a la pestaña Widgets . Los widgets son objetos visuales controlados por datos que proporcionan más contexto y datos, para ayudarle a comprender el escenario que representa el comportamiento. Aquí agregas dos widgets visuales para mostrar información de propiedad del elemento del brazo.

   1. En primer lugar, cree un widget para mostrar un medidor del valor de presión hidráulica del brazo.

      1. Seleccione Agregar widget.

         

         En la biblioteca de widgets, seleccione el widget Medidor y, a continuación, Agregar widget.

      2. En las opciones de New widget, agregue un nombre para mostrar de Presión hidráulica, una unidad de medida de m/s y una expresión de propiedad de propiedad única de PrimaryTwin.HydraulicPressure.

         Establezca tres intervalos de valores para que los valores 0-40 aparezcan en un color, 40-80 aparecen en un segundo color y 80-Infinity aparecen en un tercer color. (Recuerde que el valor de intervalo mínimo es inclusivo y el valor máximo es exclusivo).

         

         Seleccione Crear widget.

   2. A continuación, cree un widget con un vínculo a una secuencia de cámara en directo del brazo.

      1. Seleccione Agregar widget. En la Biblioteca de widgets, seleccione el widget Vínculo y, a continuación, Agregar widget.

      2. En las opciones Nuevo widget, escriba una etiqueta de Cámara de brazo activo. Para la dirección URL, puede usar la dirección URL http://contoso.armstreams.com/${PrimaryTwin.$dtId}de ejemplo . No hay ninguna cámara en directo hospedada en la dirección URL de este ejemplo. El vínculo representa dónde se podría hospedar la fuente de vídeo en un escenario real.

      3. Seleccione Crear widget.

         

6. Ya ha completado las opciones de comportamiento. Para guardar el comportamiento, seleccione Crear comportamiento.

   

El comportamiento Eficiencia de la Línea de Empaque ahora se muestra en la lista de comportamientos de la escena.

Visualización de la escena

Hasta ahora, ha trabajado con 3D Scenes Studio en modo de compilación. Ahora cambie el modo a Vista.

En la lista de elementos, seleccione el elemento Arm1 que creó. La visualización se acerca para mostrar el elemento visual y muestra los comportamientos configurados para él.

Aplicar el comportamiento a otros elementos

A veces, un entorno puede contener varios elementos similares que deben mostrarse de forma similar en la visualización (como los seis brazos robotizados de este ejemplo). Ahora que ha creado un comportamiento para un brazo y ha confirmado lo que parece en el visor, en esta sección se muestra cómo agregar rápidamente el comportamiento a otros brazos para que todos muestren el mismo tipo de información en el visor.

1. Vuelva al modo de compilación. Igual que hizo en Crear un elemento de escena, seleccione un brazo diferente en la visualización y seleccione Crear nuevo elemento.

2. Seleccione un Gemelo principal de Arm2 para el nuevo elemento y luego cambie a la pestaña Comportamientos. .

3. Seleccione Agregar comportamiento. Elija el comportamiento Eficiencia de la línea de empaquetado que creó en este inicio rápido.

4. Seleccione Create element para terminar de crear el nuevo elemento de brazo.

Cambie a la pestaña Vista para ver el comportamiento que funciona en el nuevo elemento ARM. Toda la información que seleccionó al crear el comportamiento está disponible para ambos elementos ARM de la escena.

Sugerencia

Si quiere, puede repetir los pasos de esta sección para crear elementos para los cuatro brazos restantes y aplicar el comportamiento a todos ellos para completar la visualización.

Revisión y contextualización del aprendizaje

En este inicio rápido se muestra cómo crear un panel inmersivo para los datos de Azure Digital Twins, y así poder compartirlos con los usuarios finales y aumentar el acceso a información importante sobre su entorno real.

En el inicio rápido, creó una escena 3D de ejemplo para representar un centro de distribución de paquetes con brazos robóticos que recogen los paquetes. Esta visualización se conectó a un gráfico de gemelos digitales y vinculó un brazo de la visualización a su propio gemelo digital específico que proporcionó datos de respaldo. También ha creado un comportamiento visual para mostrar información clave sobre ese brazo al ver la escena completa, incluida la información sobre los cuadros que el brazo no pudo recoger en la última hora.

En este inicio rápido, los modelos de ejemplo y los gemelos del escenario de fábrica se crearon rápidamente mediante el simulador de datos de Azure Digital Twins. Al usar Azure Digital Twins con su propio entorno, cree sus propios modelos y gemelos para describir con precisión los elementos de su entorno en detalle. En este inicio rápido también se usó el simulador de datos para simular datos "activos" que impulsan las actualizaciones de propiedades de gemelos digitales cuando no se han recogido los paquetes. Cuando utiliza Azure Digital Twins con su propio entorno, la incorporación de datos en tiempo real es un proceso que usted configura según los sensores de su entorno.

Limpieza de recursos

Para hacer limpieza después de este inicio rápido, elija los recursos de Azure Digital Twins que quiere quitar en función de los pasos que quiera dar a continuación.

• Si tiene previsto seguir con los tutoriales de Azure Digital Twins, puede reutilizar la instancia de este inicio rápido en esos artículos, no es necesario eliminarla.

• Si quiere seguir usando la instancia de Azure Digital Twins de este artículo, pero borrar todos sus modelos, gemelos y relaciones, ejecute el siguiente comando de CLI az dt job deletion:

  az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -y
  

  Si solo desea eliminar algunos de estos elementos, puede usar los comandos az dt twin relationship delete, az dt twin delete y az dt model delete para eliminar de forma selectiva solo los elementos que desea quitar.

• Si ya no necesita la instancia Azure Digital Twins, puede eliminarla mediante Azure Portal.

  Vuelva a la página Información general de la instancia en el portal. (Si ya ha cerrado esa pestaña, puede volver a buscar la instancia buscando su nombre en la barra de búsqueda de Azure Portal y seleccionándola en los resultados de la búsqueda).

  Seleccione Eliminar para eliminar la instancia, incluidos todos sus modelos y gemelos.

  

Para eliminar los recursos de almacenamiento, vaya a la página Información general de la cuenta de almacenamiento en Azure Portal y seleccione Eliminar. Esta acción elimina la cuenta de almacenamiento y el contenedor dentro de ella, junto con los archivos de escena 3D que estaban en el contenedor.

También puede eliminar el archivo 3D de ejemplo descargado de la máquina local.

Pasos siguientes

A continuación, siga los pasos de los tutoriales de Azure Digital Twins para compilar su propio entorno de Azure Digital Twins.

Programación de una aplicación cliente