Démarrage rapide : Bien démarrer avec 3D Scenes Studio (préversion) pour Azure Digital Twins

Azure Digital Twins 3D Scenes Studio (préversion) est un environnement 3D immersif, où les employés d’entreprise et de première ligne peuvent consommer et examiner les données opérationnelles de leurs solutions Azure Digital Twins avec un contexte visuel.

Dans cet article, vous allez configurer toutes les ressources requises pour l’utilisation de 3D Scenes Studio, notamment une instance Azure Digital Twins avec des exemples de données et des ressources de stockage Azure. Ensuite, vous créez une scène dans le studio qui se connecte à l’exemple d’environnement Azure Digital Twins.

Cet exemple de scène utilisé dans ce guide de démarrage rapide supervise l’efficacité de la manutention par des bras robotiques dans une usine. Les bras robotisés récupèrent des boîtes chaque heure, tandis que les caméras vidéo surveillent chacun des bras pour détecter si le bras n’a pas pu ramasser une boîte. Chaque bras est associé à un jumeau numérique dans Azure Digital Twins, et les données des jumeaux numériques sont mises à jour dès qu’un bras manque un colis. Pour ce scénario, ce guide de démarrage rapide explique pas à pas comment configurer une scène 3D qui permette de visualiser les bras dans l’usine, mais aussi d’afficher des alertes visuelles chaque fois qu’un colis est manqué.

La scène ressemble à ceci :

Prérequis

Vous avez besoin d’un abonnement Azure pour suivre ce guide de démarrage rapide. Si vous n’en avez pas, créez-en un gratuitement dès maintenant.

Vous devez également télécharger un exemple de fichier 3D (Graphics Language Transmission Format) à utiliser pour la scène dans ce guide de démarrage rapide. Téléchargez l’exemple de fichier suivant à partir de GitHub : RobotArms.glb.

Configurer Azure Digital Twins et des exemples de données

Pour utiliser Azure Digital Twins, la première étape consiste à créer une instance Azure Digital Twins. Après avoir créé une instance du service, vous pouvez lier l’instance à une visualisation 3D Scenes Studio, comme expliqué plus loin dans ce guide de démarrage rapide.

Le reste de cette section vous guide tout au long du processus de création de l’instance. Si vous disposez déjà d’une instance Azure Digital Twins configurée lors d’un guide de démarrage rapide précédent, vous pouvez passer directement à la section suivante.

Créer une instance Azure Digital Twins

Dans cette section, vous allez créer une nouvelle instance d’Azure Digital Twins à l’aide du portail Azure. Accédez au portail et connectez-vous à l’aide de vos informations d’identification.

1. Une fois dans le portail, commencez par sélectionner Créer une ressource dans le menu de la page d’accueil des services Azure.

   

2. Recherchez Azure Digital Twins dans la zone de recherche, puis choisissez le service Azure Digital Twins dans les résultats.

   Laissez le champ Plan défini sur Azure Digital Twins et sélectionnez le bouton Créer pour une nouvelle instance du service.

   

3. Renseignez les champs sous l’onglet Informations de base de la configuration, y compris votre abonnement, votre groupe de ressources, un nom de ressource pour votre nouvelle instance et votre nouvelle région. Cochez la case Attribuer le rôle Propriétaire des données Azure Digital Twins pour vous accorder les autorisations nécessaires afin de gérer les données dans l’instance.

   

   Remarque

   Si la zone Attribuer le rôle Propriétaire des données Azure Digital Twins est grisée, cela signifie que vous n’avez pas d’autorisations dans votre abonnement Azure pour gérer l’accès utilisateur aux ressources. Vous pouvez poursuivre la création de l’instance dans cette section. Une personne disposant des autorisations nécessaires doit ensuite vous attribuer ce rôle sur l’instance pour que vous puissiez terminer ce démarrage rapide.

   Les rôles communs qui répondent à cette exigence sont Propriétaire, Administrateur de compte ou la combinaison des rôles Administrateur de l’accès utilisateur et Contributeur.

4. Sélectionnez Vérifier + créer pour terminer la création de votre instance.

5. Vous voyez une page récapitulative montrant les détails que vous avez entrés. Confirmez et créez l’instance en sélectionnant Créer.

Cette action vous permet d’accéder à une page Vue d’ensemble qui suit l’état du déploiement de l’instance.

Attendez que la page indique que votre déploiement est terminé.

Collecter le nom d’hôte

Une fois le déploiement terminé, utilisez le bouton Accéder à la ressource pour passer à la page de présentation de l’instance dans le portail.

Notez ensuite la valeur du nom d’hôte de l’instance, car vous en aurez besoin plus tard.

Générer des exemples de modèles et de jumeaux

Dans cette section, vous utilisez l’outil de simulateur de données Azure Digital Twins pour générer des exemples de modèles et de jumeaux pour remplir votre instance. Vous utilisez ensuite le simulateur pour envoyer les exemples de données vers les jumeaux dans le graphe.

Cet exemple de scénario représente un centre de distribution de colis qui contient six bras robotiques. Chaque bras est associé à un jumeau numérique dont certaines propriétés permettent de suivre le nombre de colis qui n’ont pas été saisis par le bras ainsi que les ID des colis manqués.

1. Accédez au simulateur de données dans votre navigateur web.

2. Dans la zone URL d’instance, entrez le nom d’hôte de votre instance Azure Digital Twins que vous avez noté dans la section précédente. Définissez Type de simulation sur Bras robotiques.

3. Utilisez le bouton Générer un environnement pour créer un exemple d’environnement avec des modèles et des jumeaux. (Si vous avez déjà des modèles et des jumeaux dans votre instance, cette action ne les supprime pas, elle ajoute simplement plus.)

   

4. Défilez vers le bas et sélectionnez Démarrer la simulation pour commencer à envoyer les données simulées vers votre instance Azure Digital Twins. La simulation s’exécute pendant que cette fenêtre est ouverte et que l’option Démarrer la simulation est active.

Vous pouvez afficher les modèles et graphiques créés à l’aide de l’outil Graph Azure Digital Twins Explorer. Pour accéder à cet outil, sélectionnez l’icône Graph dans le menu de gauche.

Ensuite, utilisez le bouton Exécuter la requête pour rechercher tous les jumeaux et relations créés dans l’instance.

Vous pouvez sélectionner chaque jumeau pour le visualiser plus en détail.

Pour afficher les modèles chargés et la façon dont ils se rapportent les uns aux autres, sélectionnez Graphique de modèle.

Créer des ressources de stockage

Vous allez maintenant créer un compte de stockage et un conteneur dans le compte de stockage. 3D Scenes Studio utilise ce conteneur de stockage pour stocker vos informations de configuration et de fichier 3D.

Vous configurez également les autorisations de lecture et d’écriture sur le compte de stockage. Pour configurer rapidement ces ressources de sauvegarde, cette section utilise Azure Cloud Shell.

1. Accédez à Cloud Shell dans votre navigateur.

   Exécutez la commande suivante pour définir le contexte CLI sur votre abonnement pour cette session.

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

2. Exécutez la commande suivante pour créer un compte de stockage dans votre abonnement. La commande contient des espaces réservés pour vous permettre d’entrer un nom et de choisir une région pour votre compte de stockage et un espace réservé pour votre groupe de ressources.

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

   Une fois la commande terminée, vous voyez les détails de votre nouveau compte de stockage dans la sortie. Recherchez la valeur ID dans la sortie et copiez-la pour l’utiliser dans la commande suivante.

   

3. Exécutez la commande suivante pour vous accorder le rôle Propriétaire des données blob de stockage sur le compte de stockage. Ce niveau d’accès vous permet d’effectuer des opérations de lecture et d’écriture dans 3D Scenes Studio. La commande contient des espaces réservés pour l’adresse e-mail associée à votre compte Azure et l’ID de votre compte de stockage que vous avez copié à l’étape précédente.

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

   Une fois la commande terminée, vous voyez les détails de l’attribution de rôle dans la sortie.

4. Exécutez la commande suivante afin de configurer CORS pour votre compte de stockage. Cette configuration est nécessaire pour que 3D Scenes Studio accède à votre conteneur de stockage. La commande contient un espace réservé pour le nom de votre compte de stockage.

   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>
   

   Cette commande n’a pas de sortie.

5. Utilisez la commande suivante pour créer un conteneur privé dans le compte de stockage. Vos fichiers 3D Scenes Studio sont stockés ici. La commande contient un espace réservé pour le nom de votre conteneur de stockage et un espace réservé pour le nom de votre compte de stockage.

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

   Une fois la commande terminée, la sortie s’affiche "created": true.

Initialiser votre environnement 3D Scenes Studio

Maintenant que toutes vos ressources sont configurées, vous pouvez les utiliser pour créer un environnement dans 3D Scenes Studio. Dans cette section, vous allez créer une scène et la personnaliser pour l’exemple de graphique qui se trouve dans votre instance Azure Digital Twins.

1. Accédez à 3D Scenes Studio. Le studio s’ouvre, connecté à l’instance Azure Digital Twins que vous avez consultée en dernier dans Azure Digital Twins Explorer. Ignorez la démo d’accueil.

   

2. Sélectionnez l’icône Modifier en regard du nom de l’instance pour configurer les détails de l’instance et du conteneur de stockage.

   

   1. Pour l’URL de l’instance Azure Digital Twins, renseignez le nom d’hôte de votre instance indiqué à l’étape Collecter le nom d’hôte dans cette URL : https://<your-instance-host-name>.

   2. Pour l’URL du compte de stockage Azure, saisissez le nom de votre compte de stockage de l’étape Créer des ressources de stockage dans cette URL : https://<your-storage-account>.blob.core.windows.net.

   3. Pour le nom du conteneur stockage Azure, entrez le nom de votre conteneur de stockage à l’étape Créer des ressources de stockage .

   4. Sélectionnez Enregistrer.

   

Ajouter une nouvelle scène 3D

Dans cette section, vous allez créer une scène 3D à l’aide du fichier de modèle RobotArms.glb 3D que vous avez téléchargé précédemment dans Les prérequis. Une scène se compose d’un fichier de modèle 3D et d’un fichier de configuration créé automatiquement.

Cet exemple de scène contient une visualisation du centre de distribution et de ses bras robotiques. Vous connectez cette visualisation aux exemples de jumeaux que vous avez créés à l’étape Générer des exemples de modèles et de jumeaux , puis personnalisez la vue pilotée par les données dans les étapes ultérieures.

1. Sélectionnez le bouton Ajouter une scène 3D pour commencer à créer une scène. Entrez un nom et une description pour votre scène, et sélectionnez Charger le fichier.

   

2. Recherchez le fichier RobotArms.glb sur votre ordinateur et ouvrez-le. Sélectionnez Create (Créer).

   

   Une fois le fichier chargé, vous le voyez répertorié sur l’écran principal de 3D Scenes Studio.

3. Sélectionnez la scène pour l’ouvrir et la visualiser. La scène s’ouvre en mode Build .

   

Créer un élément de scène

Ensuite, vous définissez un élément dans la visualisation 3D et liez-le à un jumeau dans le graphique Azure Digital Twins que vous avez configuré précédemment.

1. Sélectionnez n’importe quel bras robotique dans la visualisation de la scène. Cette sélection affiche les actions d’élément possibles. Sélectionnez + Créer un élément.

   

2. Dans le panneau Nouveau élément, la liste déroulante Jumeau principal contient les noms de tous les jumeaux de l’instance d’Azure Digital Twins connectée.

   1. Sélectionnez Arm1 (Bras1). Cette sélection applique automatiquement l’ID de jumeau numérique ($dtId) comme nom d’élément.

   2. Sélectionnez Créer l’élément.

   

L’élément apparaît maintenant dans la liste des éléments de la scène.

Créer un comportement

Ensuite, vous créez un comportement pour l’élément. Les comportements vous permettent de personnaliser les visuels de données de l’élément et la logique métier associée. Vous pouvez explorer ces visuels de données pour analyser l’état de l’environnement physique.

1. Basculez vers la liste Comportements et sélectionnez Nouveau comportement.

   

2. Comme Nom d’affichage, entrez Efficacité de la ligne d’emballage. Sous Éléments, sélectionnez Arm1.

   

3. Ignorez l’onglet Jumeaux, qui n’est pas utilisé dans ce guide de démarrage rapide.

4. Passer à l’ongletRègles visuelles. Les règles visuelles sont des superpositions pilotées par les données sur vos éléments que vous pouvez configurer pour indiquer l’intégrité ou l’état de l’élément.

   1. Tout d’abord, vous définissez certaines conditions pour indiquer l’efficacité de la ligne d’emballage.

      1. Sélectionnez Ajouter une règle.

         

      2. Entrez Enlèvements horaires comme Nom d’affichage. Laissez Expression de propriété définie sur Propriété unique, et ouvrez la liste déroulante des propriétés. Cette liste contient les noms de toutes les propriétés définies sur le jumeau principal pour l’élément Bras1. Sélectionnez PrimaryTwin.FailedPickupsLastHr. Puis, sélectionnez Ajouter une condition.

         

      3. Ensuite, vous définissez des limites pour indiquer quand il manque trop de paquets pour les enlèvements horaires. Dans ce scénario, supposons qu’un bras a besoin d’attention s’il manque plus de trois enlèvements en une heure. Étiquetez la condition >3 enlèvements manqués et définissez une plage de valeurs comprise entre 4 et l’Infini (la valeur de plage minimale est inclusive et la valeur maximale est exclusive). Affectez une coloration d’élément rouge. Sélectionnez Enregistrer.

         

      4. Sélectionnez à nouveau Ajouter une condition, puis créez une condition intitulée 1 à 3 enlèvements manqués. Définissez une plage de valeurs comprise entre 1 et 4, puis affectez une couleur d’élément orange. Enregistrez la condition.

         Sélectionnez Ajouter une condition une fois de plus, puis créez une condition intitulée 0 enlèvement manqué. Définissez une plage de valeurs comprise entre 0 et 1, puis affectez une couleur d’élément verte. Enregistrez la condition.

         Après avoir créé les trois conditions, enregistrez la nouvelle règle visuelle.

         

   2. Ensuite, créez une autre règle visuelle pour afficher des alertes pour les paquets manqués.

      1. Sous l’onglet Règles visuelles, sélectionnez à nouveau Ajouter une règle.

         

      2. Entrez PickupFailedAlert comme Nom d’affichage. Remplacez l’Expression de propriété par Installation personnalisée (avancée), entrez une propriété PrimaryTwin.PickupFailedAlert et définissez le Type sur boolean. Cette sélection de propriété référence une propriété booléenne sur le jumeau de bras qui est définie sur True en cas d’échec de l’enlèvement d’un paquet. Sélectionnez Ajouter une condition.

         

      3. Entrez l’Étiquette${PrimaryTwin.PickupFailedBoxID} a échoué. Plus tard, dans la vue de scène, cette étiquette affiche dynamiquement la valeur de la propriété de chaîne PickupFailedBoxID du jumeau de bras, qui contient un ID représentant la zone que le bras n’a pas pu récupérer récemment. Définissez la Valeur sur True et choisissez un Type visuel de Badge. Définissez la Couleur sur rouge et choisissez une Icône. Sélectionnez Enregistrer pour ajouter la condition, puis sélectionnez Enregistrer pour enregistrer la règle visuelle.

         

      Vous devez maintenant voir les deux règles répertoriées sous l’onglet Règles visuelles.

      

5. Basculez vers l’onglet Widgets . Les widgets sont des visuels pilotés par les données qui fournissent plus de contexte et de données, pour vous aider à comprendre le scénario que représente le comportement. Ici, vous ajoutez deux widgets visuels pour afficher les informations de propriété pour l’élément arm.

   1. Tout d’abord, créez un widget pour afficher une jauge de la pression hydraulique du bras.

      1. Sélectionnez Ajouter un widget.

         

         Dans la bibliothèque de widgets, sélectionnez le widget Jauge et sélectionnez Ajouter le widget.

      2. Dans les options Nouveau widget, ajoutez le Nom d’affichageHydraulic Pressure, l’Unité de mesurem/s et l’expression de propriété (une seule propriété) PrimaryTwin.HydraulicPressure.

         Définissez trois plages de valeurs afin que les valeurs 0-40 apparaissent d’une couleur, 40-80 apparaissent dans une deuxième couleur et que 80-Infinity apparaissent dans une troisième couleur. (N’oubliez pas que la valeur de plage minimale est inclusive et que la valeur maximale est exclusive.)

         

         Sélectionnez Créer le widget.

   2. Ensuite, créez un widget contenant un lien vers un flux temps réel de la caméra du bras.

      1. Sélectionnez Ajouter un widget. Dans la bibliothèque de widgets, sélectionnez le widget Lien et sélectionnez Ajouter le widget.

      2. Dans les options Nouveau widget, entrez l’étiquetteCaméra temps réel du bras. Pour l’URL, vous pouvez utiliser l’exemple d’URL http://contoso.armstreams.com/${PrimaryTwin.$dtId}. Aucune caméra temps réel n’est hébergée à l’URL de cet exemple, mais le lien représente l’emplacement où le flux vidéo peut être hébergé dans un scénario réel.

      3. Sélectionnez Créer le widget.

         

6. La configuration des options du comportement est maintenant terminée. Enregistrez le comportement en sélectionnant Créer le comportement.

   

Le comportement Efficacité de la ligne d’emballage s’affiche désormais dans la liste des comportements de la scène.

Visualiser la scène

Jusqu’à présent, vous avez travaillé avec 3D Scenes Studio en mode Build. Passez maintenant en mode Affichage.

Dans la liste Éléments, sélectionnez l’élément Arm1 que vous avez créé. La visualisation effectue un zoom avant pour afficher l’élément visuel et affiche les comportements que vous avez configurés pour celui-ci.

Appliquer le comportement à d’autres éléments

Parfois, un environnement peut contenir plusieurs éléments similaires, qui doivent tous s’afficher de la même façon dans la visualisation (comme les six bras robotiques différents dans cet exemple). Maintenant que vous avez créé un comportement pour un bras et confirmé à quoi il ressemble dans la visionneuse, cette section vous montre comment ajouter rapidement le comportement à d'autres bras afin qu'ils affichent tous le même type d'informations dans la visionneuse.

1. Repassez en mode Build. Comme vous l’avez fait dans la section Créer un élément de scène, sélectionnez un autre bras dans la visualisation, puis sélectionnez Créer un élément.

2. Sélectionnez Bras2 comme Jumeau principal pour le nouvel élément, puis accédez à l’onglet Comportements.

3. Sélectionnez Ajouter un comportement. Choisissez le comportement Packing Line Efficiency que vous avez créé précédemment dans ce guide de démarrage rapide.

4. Sélectionnez Créer l’élément pour terminer la création de l’élément arm.

Basculez vers l’onglet Affichage pour voir le comportement appliqué au nouvel élément arm. Toutes les informations que vous avez sélectionnées au moment de la création du comportement sont désormais appliquées aux deux éléments bras de la scène.

Passer en revue et contextualiser les apprentissages

Ce guide de démarrage rapide montre comment créer un tableau de bord immersif pour les données Azure Digital Twins, dans le but de partager les informations avec les utilisateurs finaux et d’améliorer l’accès à des insights utiles au sujet de votre environnement réel.

Dans le guide de démarrage rapide, vous avez créé un exemple de scène 3D pour représenter un centre de distribution de colis où des bras robotiques saisissent les colis. Cette visualisation était connectée à un graphe de jumeaux numériques, et vous avez lié un bras dans la visualisation à son propre jumeau numérique spécifique qui fournissait des données de stockage. Vous avez également créé un comportement visuel pour afficher des informations clés sur ce bras lors de l’affichage de la scène complète, y compris des informations sur les boîtes que le bras n’a pas pu récupérer au cours de la dernière heure.

Dans ce guide de démarrage rapide, les exemples de modèles et de jumeaux utilisés dans le scénario d’usine ont été rapidement créés pour vous, à l’aide du simulateur Azure Digital Twins Data. Lorsque vous utilisez Azure Digital Twins avec votre propre environnement, vous créez vos propres modèles et jumeaux pour décrire avec précision les éléments de votre environnement en détail. Ce guide de démarrage rapide a également utilisé le simulateur de données pour simuler des données en temps réel donnant lieu à des mises à jour des propriétés de jumeau numérique lorsque des colis étaient manqués. Lorsque vous utilisez Azure Digital Twins avec votre propre environnement, l’ingestion de données actives est un processus que vous avez configuré en fonction de vos propres capteurs d’environnement.

Nettoyer les ressources

Pour procéder au nettoyage à la fin de ce guide de démarrage rapide, choisissez les ressources Azure Digital Twins que vous souhaitez supprimer en fonction de ce que vous voulez faire par la suite.

• Si vous envisagez de passer aux tutoriels Azure Digital Twins, ne supprimez pas l’instance de ce guide de démarrage rapide, car vous pourrez la réutiliser.

• Si vous souhaitez continuer à utiliser l’instance Azure Digital Twins à partir de cet article, mais souhaitez effacer tous ses modèles, jumeaux et relations, exécutez la commande CLI az dt job suppression suivante :

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

  Si vous souhaitez uniquement supprimer certains de ces éléments, vous pouvez utiliser les commandes suppression de relation de jumeau az dt, az dt twin delete et az dt model delete pour supprimer sélectivement uniquement les éléments que vous souhaitez supprimer.

• Si vous n’avez plus besoin de votre instance Azure Digital Twins, vous pouvez la supprimer dans le portail Azure.

  Revenez à la page Vue d’ensemble de l’instance dans le portail. (Si vous avez déjà fermé cet onglet, vous pouvez retrouver l’instance en recherchant son nom dans la barre de recherche du portail Azure et en la sélectionnant dans les résultats de la recherche.)

  Sélectionnez Supprimer pour supprimer l’instance, y compris tous ses modèles et jumeaux.

  

Vous pouvez supprimer vos ressources de stockage en accédant à la page Vue d’ensemble de votre compte de stockage dans le portail Azure, puis en sélectionnant Supprimer. Cette action supprime le compte de stockage et le conteneur à l’intérieur de celui-ci, ainsi que les fichiers de scène 3D qui se trouvaient dans le conteneur.

Vous pouvez également supprimer l’exemple de fichier 3D téléchargé à partir de votre ordinateur local.

Étapes suivantes

Ensuite, passez aux tutoriels Azure Digital Twins pour créer votre propre environnement Azure Digital Twins.