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

3D Scenes Studio (versión preliminar) para Azure Digital Twins es un entorno 3D envolvente, 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 almacenamiento de Azure. A continuación, creará una escena en Studio que estará conectada al entorno de Azure Digital Twins de ejemplo.

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 un número determinado de cajas cada hora, mientras que las cámaras de vídeo supervisan cada uno de los brazos para detectar si alguno 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 tendrá el siguiente aspecto:

Requisitos previos

Necesitará una suscripción de Azure para completar esta guía de inicio rápido. Si aún no tiene una, cree una gratis .

También tendrá que descargar un archivo 3D glTF (formato de transmisión de lenguaje gráfico) de ejemplo para usarlo en 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, 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 su suscripción, el grupo de recursos, la ubicación y un nombre de recurso para la nueva instancia. 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 Review + Create (Revisar y crear) para terminar de crear la instancia.

5. Verá una página de resumen que muestra los detalles que ha escrito. Para confirmar y crear la instancia, seleccione Create (Crear).

Esto le llevará a una página de información general que hace un 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 Simulador de datos de Azure Digital Twins para generar modelos de ejemplo y gemelos para rellenar la instancia. A continuación, usará el simulador para transmitir datos de ejemplo a los gemelos del gráfico.

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, creará 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, esto no los eliminará, solo agregará 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 solo se ejecutará mientras esta ventana esté abierta y la opción Iniciar simulación esté activa.

Puede ver los modelos y el gráfico que se han creado 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 las relaciones que se han creado en la instancia.

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

Para ver los modelos que se han cargado 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 usará este contenedor de almacenamiento para guardar la información de configuración y el archivo 3D.

También configurará permisos de lectura y escritura en la cuenta de almacenamiento. Para configurar estos recursos de respaldo 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 introduzca un nombre y elija una región para la cuenta de almacenamiento, así como 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 le permitirá 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. Esto será necesario 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 almacenarán 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 complete correctamente, la salida mostrará "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, creará una escena y la personalizará para el gráfico de ejemplo que se encuentra en la instancia de Azure Digital Twins.

1. Vaya a 3D Scenes Studio. El estudio se abrirá, y verá que está conectado a la instancia de Azure Digital Twins a la que accedió por última vez en 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 mediante el archivo de modelo 3D RobotArms.glb que descargó anteriormente en Requisitos previos. Una escena consta de un archivo de modelo 3D y un archivo de configuración que se crea automáticamente.

Esta escena de ejemplo contiene una visualización del centro de distribución y sus brazos. Tiene que conectar esta visualización a los gemelos de ejemplo que creó en el paso Generar modelos y gemelos de ejemplo y personalizar la vista controlada por 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. Esta se abrirá en modo de compilación.

   

Creación de un elemento de escena

A continuación, tiene que definir un elemento en la visualización 3D y vincularlo a un gemelo en el gráfico de Azure Digital Twins que configuró anteriormente.

1. Seleccione cualquier brazo robotizado en la visualización de la escena. Se mostrarán 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 opción aplicará automáticamente el id. de gemelo digital ($dtId) como el elemento de nombre.

   2. Seleccione Crear elemento.

   

El elemento se mostrará en la lista de elementos de la escena.

Creación de un comportamiento

A continuación, debe 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, establecerá algunas condiciones para indicar la eficiencia de la línea de empaquetado.

      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 estas recogidas por hora no están procesando suficientes paquetes. 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 es una propiedad booleana del gemelo digital del brazo, que se establece en True cuando no se puede recoger un paquete. Seleccione Agregar condición.

         

      3. Escriba una Etiqueta como ${PrimaryTwin.PickupFailedBoxID} failed. Más adelante, en la vista de escena, se mostrará dinámicamente el valor de la propiedad de cadena del gemelo digital del brazo PickupFailedBoxID, que contiene un id. que representa la caja que el brazo no pudo recoger la última vez. Establezca el valor en True y elija un Tipo visualDistintivo. Establezca el Color en rojo y elija un Icono. Seleccione Guardar.

         

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

      

5. Cambie a la pestaña de Widgets. Los widgets son objetos visuales controlados por datos que proporcionan contexto y datos adicionales, para que pueda comprender el escenario que representa el comportamiento. Aquí, agregará dos widgets visuales para mostrar información de propiedades para el elemento ARM.

   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, los intervalos 40-80 aparezcan en un segundo color y los intervalos 80-Infinito aparezcan 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. En el campo URL, puede usar la dirección URL de ejemplo http://contoso.armstreams.com/${PrimaryTwin.$dtId}. 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 línea de empaquetado se mostrará 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 hará zoom para que vea mejor el elemento visual y mostrar los comportamientos configurados en él.

Aplicación del comportamiento a elementos adicionales

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 su aspecto en el visor, esta sección le mostrará 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 creó un comportamiento visual para mostrar información clave sobre ese brazo al ver la escena completa, incluidas las recogidas de cajas que han devuelto un error en ese brazo 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, creará sus propios modelos y gemelos para describir con precisión los elementos del 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. Al usar Azure Digital Twins con su propio entorno, la ingesta de datos activos es un proceso que configurará según sus propios sensores de 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 encontrar la instancia buscando su nombre en la barra de búsqueda de Azure Portal y seleccionándolo 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. Esto eliminará la cuenta de almacenamiento y el contenedor que contiene, junto con los archivos de la escena 3D que estaban en el contenedor.

También puede eliminar el archivo 3D de ejemplo que descargó de su 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