3D Scenes Studio (préversion) pour Azure Digital Twins

Azure Digital Twins 3D Scenes Studio (préversion) est un environnement 3D immersif, où les utilisateurs finaux peuvent surveiller, diagnostiquer et examiner les données opérationnelles avec le contexte visuel des ressources 3D. 3D Scenes Studio permet aux organisations d’enrichir les modèles 3D existants avec des visualisations optimisées par les données Azure Digital Twins, sans avoir besoin d’expertise 3D. Les visualisations peuvent être facilement consommées à partir de navigateurs web.

Avec un graphe de jumeau numérique et un modèle 3D organisé, les experts du domaine peuvent tirer parti de l'outil de développement à faible code du studio pour mapper les éléments 3D aux jumeaux numériques, et définir la logique métier et l'interactivité de l'interface utilisateur pour une visualisation 3D d’un environnement professionnel. Les scènes 3D peuvent ensuite être consommées dans le studio 3D Scenes Studio hébergé ou dans une application personnalisée qui tire parti du composant de visionneuse 3D intégrable.

Cet article donne une vue d’ensemble de 3D Scenes Studio et de ses fonctionnalités clés. Pour obtenir des instructions détaillées détaillées sur l’utilisation de chaque fonctionnalité, consultez Utiliser 3D Scenes Studio (préversion).

Présentation du studio

Le travail dans 3D Scenes Studio est conçu autour du concept de scènes. Une scène est une vue d’un seul environnement métier et se compose de contenu 3D, de logique métier personnalisée et de références à une instance Azure Digital Twins. Vous pouvez avoir plusieurs scènes pour une seule instance de jumeau numérique.

Les scènes sont configurées dans le générateur à l’intérieur de 3D Scenes Studio. Vous pouvez ensuite afficher vos scènes terminées dans l’expérience d’affichage intégrée du studio ou incorporée dans des applications web personnalisées. Vous pouvez étendre la visionneuse intégrée ou créer vos propres visionneuses qui accèdent aux fichiers 3D Scenes et à votre graphe Azure Digital Twins.

Environnement et stockage

Du point de vue des ressources Azure, un environnement 3D Scenes Studio est formé à partir d’un jumelage unique d’une instance Azure Digital Twins et d’un conteneur de stockage Azure. Vous allez créer ces ressources Azure séparément et connecter 3D Scenes Studio à ces deux pour configurer un environnement 3D Scenes Studio unique. Vous pouvez ensuite commencer à créer des scènes dans cet environnement.

Chaque scène 3D s’appuie sur deux fichiers, qui seront stockés dans votre conteneur de stockage :

• Fichier 3D, qui contient des données de scénario et des maillages pour votre visualisation. Vous importez ce fichier dans 3D Scenes Studio.
• Un fichier de configuration, qui est créé automatiquement pour vous lorsque vous créez un environnement 3D Scenes Studio. Ce fichier contient la définition de mappage entre le contenu 3D et Azure Digital Twins, ainsi que toute la logique métier définie par l’utilisateur.

Remarque

Étant donné que vous gérez le conteneur de stockage dans votre compte Azure, vous pourrez modifier directement les fichiers de scène stockés. Toutefois, il n’est pas recommandé de modifier manuellement le fichier de configuration, car cela crée un risque d’incohérences dans le fichier qui peuvent ne pas être gérées correctement dans l’expérience de la visionneuse.

Une fois que vous avez créé un environnement 3D Scenes Studio avec une instance Azure Digital Twins et un conteneur de stockage Azure, il est possible de désactiver l’une ou l’autre de ces ressources pour une autre instance ou conteneur afin de modifier l’environnement. Voici les résultats de ces actions :

• Le passage à une nouvelle instance Azure Digital Twins change les données de jumeau numérique sous-jacentes pour la scène. Cette action n’est pas recommandée, car elle peut entraîner l’inclusion de références de jumeau numérique rompues dans votre scène.
• Le passage à un nouveau conteneur de stockage signifie passer à un nouveau fichier de configuration, ce qui modifie l’ensemble des scènes affichées dans le studio.

Pour partager vos scènes avec quelqu’un d’autre, le destinataire a besoin d’au moins un accès au niveau lecteur à l’instance Azure Digital Twins et au conteneur de stockage dans l’environnement, ainsi que des informations d’URL sur ces ressources. Pour obtenir des instructions détaillées sur la façon de partager votre environnement avec quelqu’un d’autre, consultez Partager votre environnement.

Configurer

Pour utiliser 3D Scenes Studio, vous aurez besoin des ressources requises suivantes :

• Une instance Azure Digital Twins

  • Vous aurez besoin d’un accès de propriétaire de données d'Azure Digital Twins ou d’un accès de lecteur de données d'Azure Digital Twins à l’instance
  • L’instance doit être peuplée de modèles et jumeaux

• Un compte de stockage Azure et un conteneur privé dans le compte de stockage

  • Pour afficher les scènes 3D, vous aurez besoin au moins d’un accès lecteur de données Blob de stockage à ces ressources de stockage. Pour créer des scènes 3D, vous aurez besoin d’un accès Contributeur aux Données Blob de Stockage ou Propriétaire des Données Blob de Stockage.

    Vous pouvez accorder les rôles nécessaires au niveau du compte de stockage ou au niveau du conteneur. Pour plus d’informations sur les autorisations de stockage Azure, consultez Affecter un rôle Azure.

  • Vous devez également configurer CORS (Cross-Origin Resource Sharing) pour votre compte de stockage, afin que 3D Scenes Studio puisse accéder à votre conteneur de stockage. Pour obtenir des informations complètes sur le paramètre CORS, consultez Utiliser 3D Scenes Studio (préversion).

Vous pouvez ensuite accéder à 3D Scenes Studio à ce lien : 3D Scenes Studio.

Une fois là, vous allez lier votre environnement 3D à vos ressources de stockage et configurer votre première scène. Pour obtenir des instructions détaillées sur l’exécution de ces actions, consultez Initialiser votre environnement 3D Scenes Studio et créer, modifier et afficher des scènes.

Constructeur

Le générateur dans 3D Scenes Studio est l’interface principale pour configurer vos scènes. Il s’agit d’une expérience visuelle à faible code.

Voici à quoi ressemble le constructeur :

Dans le générateur, vous allez créer des éléments et des comportements pour votre scène. Les sections suivantes expliquent ces fonctionnalités plus en détail.

Éléments

Les éléments sont des maillages 3D définis par l’utilisateur qui sont liés à des jumeaux numériques, mappant les éléments de visualisation aux données de jumeau pertinentes.

Lors de la création d’un élément dans le générateur, vous allez définir les composants suivants :

• Jumeau principal : chaque élément est connecté à un équivalent de jumeau numérique principal. Vous connectez l’élément à un jumeau dans votre instance Azure Digital Twins afin que l’élément puisse représenter votre jumeau et ses données dans la visualisation 3D.
• Nom : chaque élément a besoin d’un nom. Vous pourriez vouloir le faire correspondre au $dtId de son jumeau principal.
• Maillages : identifiez les composants du modèle 3D qui représentent cet élément.
• Comportements : les comportements décrivent comment les éléments apparaissent dans la visualisation. Vous pouvez affecter des comportements à cet élément ici.
• Autres jumeaux : si vous le souhaitez, vous pouvez ajouter des sources de données de jumeau numérique secondaires pour un élément. Vous ne devez ajouter d'autres jumeaux que s'il existe des jumeaux supplémentaires dont les données, en plus de celles de votre jumeau principal, peuvent être exploitées pour vos comportements. Après avoir configuré un autre jumeau, vous pourrez utiliser les propriétés de ce jumeau lors de la définition de comportements pour cet élément.

Comportements

Les comportements sont des règles de logique de productivité qui utilisent des données de jumeau numérique pour diriger les éléments visuels dans la scène.

Lors de la création d’un comportement pour un élément, vous allez définir les composants suivants :

• Éléments : les comportements décrivent les visuels appliqués à chaque élément de la visualisation. Vous pouvez choisir les éléments auxquels ce comportement s’applique.
• Jumeaux : identifiez l’ensemble de jumeaux dont les données sont disponibles pour ce comportement. Cela inclut les jumeaux principaux des éléments ciblés, ainsi que tous les autres jumeaux.
• Rè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.
• Widgets : les widgets sont des visuels pilotés par les données qui fournissent des données supplémentaires pour vous aider à diagnostiquer et à examiner le scénario que représente le comportement. La configuration des widgets vous aidera à vous assurer que les données appropriées sont détectables lorsqu’une condition particulière est active.

Vous pouvez également créer des couches dans votre scène pour vous aider à organiser vos comportements. Les calques sont comme des étiquettes applicables aux comportements. Vous pouvez vous en servir pour définir les comportements à voir ensemble, ce qui vous permet ainsi de créer des vues personnalisées de la scène pour différents rôles ou différentes tâches.

Visionneuse

3D Scenes Studio contient également une visionneuse, que les utilisateurs finaux (comme les opérateurs) peuvent utiliser pour explorer la scène 3D.

Voici à quoi ressemble la visionneuse :

Vous pouvez utiliser la liste Éléments pour explorer tous les éléments et conditions actives de votre scène, ou cliquer sur des éléments directement dans la visualisation pour explorer leurs détails.

Composant de visionneuse incorporable

3D Scenes Studio est extensible pour prendre en charge des besoins d’affichage supplémentaires. Le composant visionneuse peut être incorporé dans des applications personnalisées et peut fonctionner conjointement avec les composants tiers.

Voici un exemple de ce à quoi la visionneuse incorporée peut ressembler dans une application indépendante :

La bibliothèque de composants de visualisation 3D est disponible dans GitHub, dans le référentiel iot-cardboard-js. Cette bibliothèque est une bibliothèque de composants React open source permettant de créer des expériences web IoT (Internet des objets).

Pour obtenir des instructions sur l’utilisation de la bibliothèque afin d’incorporer des expériences 3D dans des applications personnalisées, consultez le wiki du référentiel, Incorporation de scènes 3D. Vous pouvez également utiliser l’exemple CRA IoT Cardboard, qui déploie un modèle Create React App pour la bibliothèque, pour commencer à créer une application personnalisée avec une visionneuse incorporée.

Limites et performances

Lorsque vous utilisez 3D Scenes Studio, il est recommandé de rester dans les limites suivantes. Si vous dépassez ces limites recommandées, vous pouvez rencontrer des performances détériorées ou un comportement d’application inattendu.

Capacité	Limite recommandée
Nombre de jumeaux liés (y compris tous les jumeaux principaux uniques et les jumeaux secondaires des éléments)	Aucune limite, mais envisagez des implications en termes de performances à mesure que le nombre de jumeaux augmente. Pour plus d’informations, consultez Le taux d’actualisation et les performances ci-dessous.
Taille du fichier 3D	100 Mo

Ces limites sont recommandées, car 3D Scenes Studio tire parti des API Azure Digital Twins standard et est donc soumis aux limites de taux d’API publiées. À mesure que le nombre de jumeaux numériques liés aux scènes augmente, la quantité de données extraites dans votre scène lors d’une actualisation régulière des données augmente (pour plus d’informations sur les taux d’actualisation, consultez la partie suivante de cette section). Cela signifie que vous verrez ces appels d’API supplémentaires reflétés dans les compteurs de facturation et le débit d’opération.

Taux d’actualisation et performances

Le taux d’actualisation par défaut de la visionneuse de scène 3D commence à 10 secondes pour moins de 100 jumeaux. Il augmente à mesure que le nombre de jumeaux augmente, à un taux d’environ une seconde pour chaque 10 jumeaux.

Le taux d’actualisation minimal peut également être configuré manuellement pour exercer un certain contrôle sur la fréquence à laquelle les données sont extraites et l’impact résultant sur les performances. Vous pouvez configurer le taux d'actualisation minimal de la visionneuse pour qu'il soit compris entre 10 secondes et une heure. La visionneuse ne tombera jamais en dessous du taux de rafraîchissement minimal que vous définissez. Toutefois, l'utilisateur peut augmenter le taux de rafraîchissement réel au fur et à mesure que le nombre de jumeaux augmente, afin d’améliorer les performances.

Pour obtenir des instructions sur la configuration du taux d’actualisation minimal pour la visionneuse, consultez Configurer le taux d’actualisation minimal.

Étapes suivantes

Essayez 3D Scenes Studio avec un exemple de scénario dans Bien démarrer avec 3D Scenes Studio.

Vous pouvez également apprendre à utiliser l’ensemble complet de fonctionnalités du studio dans Use 3D Scenes Studio.