

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création et édition de AWS IoT TwinMaker scènes
<a name="scenes"></a>

Les scènes sont des visualisations tridimensionnelles de votre jumeau numérique. Ils constituent le principal moyen pour vous de modifier votre jumeau numérique. Découvrez comment ajouter des alarmes, des données de séries chronologiques, des superpositions de couleurs, des balises et des règles visuelles à votre scène afin d'aligner vos visualisations jumelles numériques sur votre cas d'utilisation réel.

Cette section couvre les rubriques suivantes :
+ [Avant de créer votre première scène](scenes-before-starting.md)
+ [Télécharger des ressources dans la bibliothèque AWS IoT TwinMaker de ressources](scenes-using-resource-library.md)
+ [Créez vos scènes](scenes-creation.md)
+ [Ajouter des caméras fixes aux entités](scenes-camera.md)
+ [Montage de scène amélioré](scenes-ee.md)
+ [Modifiez vos scènes](scenes-editing.md)
+ [Format du modèle 3D Tiles](3d-tiles-model-format.md)
+ [Scènes dynamiques](dynamic-scenes.md)

# Avant de créer votre première scène
<a name="scenes-before-starting"></a>

 Les scènes s'appuient sur des ressources pour représenter votre jumeau numérique. Ces ressources sont constituées de modèles 3D, de données ou de fichiers de texture. La taille et la complexité de vos ressources, des éléments de la scène tels que l'éclairage et de votre matériel informatique ont un impact sur les performances des AWS IoT TwinMaker scènes. Utilisez les informations de cette rubrique pour réduire le décalage, les temps de chargement et améliorer la fréquence d'images de vos scènes.

## Optimisez vos ressources avant de les importer dans AWS IoT TwinMaker
<a name="scenes-before-starting-3D-optimization"></a>

Vous pouvez l'utiliser AWS IoT TwinMaker pour interagir avec votre jumeau numérique en temps réel. Pour une expérience optimale avec vos scènes, nous vous recommandons d'optimiser vos ressources pour une utilisation dans un environnement en temps réel.

Vos modèles 3D peuvent avoir un impact significatif sur les performances. La géométrie et les maillages complexes des modèles peuvent réduire les performances. Par exemple, les modèles de CAO industriels présentent un niveau de détail élevé. Nous recommandons de compresser les maillages de ces modèles et de réduire leur nombre de polygones avant de les utiliser dans AWS IoT TwinMaker des scènes. Si vous créez de nouveaux modèles 3D pour AWS IoT TwinMaker, vous devez établir un niveau de détail et le maintenir dans tous vos modèles. Supprimez les détails des modèles qui n'affectent pas la visualisation ou l'interprétation de votre cas d'utilisation.

Pour compresser les modèles et réduire la taille des fichiers, utilisez des outils de compression de maillage open source, tels que la [compression de données 3D DRACO](https://google.github.io/draco/).

Des textures non optimisées peuvent également avoir un impact sur les performances. Si vous n'avez pas besoin de transparence dans vos textures, pensez à choisir le format d'image PEG plutôt que le format PNG. Vous pouvez compresser vos fichiers de texture à l'aide d'outils de compression de texture open source, tels que [la compression de texture Basis Universal](https://www.khronos.org/blog/google-and-binomial-contribute-basis-universal-texture-format-to-khronos-gltf-3d-transmission-open-standard).

## Les meilleures pratiques en matière de performance dans AWS IoT TwinMaker
<a name="scenes-best-practices-optimization"></a>

Pour de meilleures performances avec AWS IoT TwinMaker, tenez compte des limites et des meilleures pratiques suivantes.
+ AWS IoT TwinMaker les performances de rendu de scène dépendent du matériel. Les performances varient en fonction de la configuration matérielle de l'ordinateur.
+ Nous recommandons un nombre total de polygones inférieur à 1 million pour tous les objets de votre AWS IoT TwinMaker.
+ Nous recommandons un total de 200 objets par scène. L'augmentation du nombre d'objets d'une scène au-delà de 200 peut réduire la fréquence d'images de votre scène.
+ Nous recommandons que la taille totale de toutes les ressources 3D uniques de votre scène ne dépasse pas 100 mégaoctets. Dans le cas contraire, vous risquez de rencontrer des temps de chargement lents ou une dégradation des performances en fonction de votre navigateur et de votre matériel.
+ Les scènes disposent d'un éclairage d'ambiance par défaut. Vous pouvez ajouter des lumières supplémentaires à une scène pour mettre en valeur certains objets ou projeter des ombres sur des objets. Nous recommandons d'utiliser une lampe par scène. Utilisez des lumières là où c'est nécessaire et évitez de reproduire les lumières du monde réel dans une scène.

## En savoir plus
<a name="scenes-learn-more"></a>

Utilisez ces ressources pour en savoir plus sur les techniques d'optimisation que vous pouvez utiliser pour améliorer les performances de vos scènes.
+ [Comment convertir et compresser des modèles OBJ en GLTF pour les utiliser avec AWS IoT TwinMaker](https://aws.amazon.com/blogs/iot/how-to-convert-and-compress-obj-models-to-glb-gltf-for-use-with-aws-iot-twinmaker/)
+ [Optimisez vos modèles 3D pour le contenu Web](https://medium.com/@michael.andrew/6-things-you-havent-optimised-in-your-webvr-content-272d74d541f0)
+ [Optimisation des scènes pour de meilleures performances WebGL](https://www.soft8soft.com/docs/manual/en/introduction/Optimizing-WebGL-performance.html)

# Télécharger des ressources dans la bibliothèque AWS IoT TwinMaker de ressources
<a name="scenes-using-resource-library"></a>

Vous pouvez utiliser la bibliothèque de ressources pour contrôler et gérer toutes les ressources que vous souhaitez placer dans des scènes pour votre application de jumelage numérique. Pour AWS IoT TwinMaker connaître les ressources, téléchargez-les à l'aide de la page de console de la bibliothèque de ressources.

## Téléchargez des fichiers dans la bibliothèque de ressources à l'aide de la console
<a name="scenes-resource-library-console"></a>

**Procédez comme suit pour ajouter des fichiers à la bibliothèque de ressources à l'aide de la AWS IoT TwinMaker console.**

1. Dans le menu de navigation de gauche, sous **Espaces de travail**, sélectionnez **Bibliothèque de ressources**.

1. Sélectionnez **Ajouter des ressources** et choisissez les fichiers que vous souhaitez télécharger.   
![\[La page de console de la bibliothèque de ressources contenant la liste des fichiers pouvant être sélectionnés pour le téléchargement.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/scenes-resource-lib-upload.png)

# Créez vos scènes
<a name="scenes-creation"></a>

Dans cette section, vous allez configurer une scène afin de pouvoir modifier votre jumeau numérique. Vous pouvez importer un modèle 3D qui a été chargé dans la [bibliothèque de ressources](scenes-using-resource-library.md), puis ajouter des widgets et lier des données de propriété à des objets pour compléter votre jumeau numérique. Les objets de scène peuvent inclure un bâtiment ou un espace entier, ou des pièces d'équipement individuelles positionnées à leur emplacement physique. 

**Note**  
Avant de créer une scène, vous devez créer un espace de travail.

Utilisez la procédure suivante pour créer votre scène dans AWS IoT TwinMaker.

1. Pour ouvrir le volet des scènes, dans le menu de navigation de gauche de votre espace de travail, sélectionnez **Scènes**.

1. Choisissez **Create scene** (Créer la scène). Le volet de création d'une nouvelle scène s'ouvre.

1. Dans le volet de création de scène, entrez le nom et la description de votre nouvelle scène. Si vous avez un plan tarifaire standard ou échelonné, vous pouvez sélectionner votre type de scène. Il est recommandé d'utiliser une [scène dynamique](dynamic-scenes.md).

1. Lorsque vous êtes prêt à créer la scène, choisissez **Create scene**. La nouvelle scène s'ouvre et est prête à être utilisée.  
![\[Une toile de scène vide prête à être travaillée.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/scenes-fresh-scene.png)

## Utilisez la navigation 3D AWS IoT TwinMaker dans vos scènes
<a name="scenes-navigation"></a>

La AWS IoT TwinMaker scène dispose d'un ensemble de commandes de navigation que vous pouvez utiliser pour naviguer efficacement dans l'espace 3D de votre scène. Pour interagir avec l'espace 3D et les objets représentés par votre scène, utilisez les widgets et options de menu suivants.
+ **Inspecteur** : utilisez la fenêtre Inspector pour afficher et modifier les propriétés et les paramètres d'une entité ou d'un composant sélectionné dans votre hiérarchie.
+ **Canevas** de scène : Le canevas de scène est l'espace 3D dans lequel vous pouvez positionner et orienter les ressources 3D que vous souhaitez utiliser.
+ **Hiérarchie des graphes de scène** : vous pouvez utiliser ce panneau pour voir toutes les entités présentes dans votre scène. Il apparaît sur le côté gauche de la fenêtre.
+ **Gadget d'objet** : utilisez ce gadget pour déplacer des objets sur le canevas. Il apparaît au centre d'un objet 3D sélectionné dans le canevas de scène. 
+ **Modifier le gadget de caméra** : utilisez le gadget d'édition de caméra pour visualiser rapidement l'orientation actuelle de la caméra de visualisation de scène et modifier l'angle de vue. Vous pouvez trouver ce gadget dans le coin inférieur droit de la vue de scène.
+ **Commandes de zoom** : pour naviguer sur le canevas de scène, cliquez avec le bouton droit de la souris et faites glisser le pointeur dans la direction que vous souhaitez déplacer. Pour faire pivoter, cliquez avec le bouton gauche de la souris et faites glisser pour faire pivoter. Pour zoomer, utilisez la molette de défilement de votre souris ou pincez et écartez vos doigts sur le pavé tactile de votre ordinateur portable.

![\[Un canevas de scène avec un gadget d'objet récemment ajouté.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/scenes-nav-layout.png)


Les boutons de scène du volet hiérarchique comportent les fonctions suivantes répertoriées, dans l'ordre de disposition des boutons :
+ **Annuler** : annule la dernière modification apportée à la scène.
+ **Rétablir** : refaites votre dernière modification dans la scène.
+ **Plus (\$1)** : utilisez ce bouton pour accéder aux actions suivantes : **Ajouter un nœud vide, ajouter** un **modèle 3D, ajouter** une **balise, ajouter** de la **lumière et ajouter** **un shader de modèle**.
+ **Modifier le mode de navigation** : accédez aux options de navigation de la caméra de scène, **Orbit** et **Pan**.
+ **Corbeille (supprimer)** : utilisez ce bouton pour supprimer un objet sélectionné dans votre scène.
+ **Outils de manipulation d'objets** : utilisez ce bouton pour déplacer, faire pivoter et redimensionner l'objet sélectionné.

# Ajouter des caméras fixes aux entités
<a name="scenes-camera"></a>

Vous pouvez associer des vues de caméra fixes à vos entités au sein de vos AWS IoT TwinMaker scènes. Ces caméras fournissent une perspective fixe sur un modèle 3D, ce qui vous permet de déplacer rapidement et facilement votre perspective dans une scène vers une entité ciblée. 

1. Accédez à votre scène dans la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/).

1. Dans le menu de hiérarchie des scènes, sélectionnez l'entité à laquelle vous souhaitez associer la caméra.

1. Appuyez sur le bouton **\$1**, puis dans les options du menu déroulant, sélectionnez **Ajouter une caméra à partir de la vue actuelle**. Pour appliquer une caméra avec la perspective actuelle à l'entité.

1. Dans l'inspecteur, vous pouvez configurer votre caméra et régler les paramètres suivants :
   + Un **nom** de caméra
   + La **position et la** **rotation de la** caméra
   + **Distance focale** de la caméra
   + Le **niveau de zoom**
   + Avions découpés de **près** ou de **loin**

1. Pour accéder à votre caméra après l'avoir placée. Sélectionnez l'entité à laquelle vous avez ajouté la caméra dans la hiérarchie. Recherchez le nom de la caméra indiqué sous l'entité.

1. Une fois que vous avez sélectionné la caméra placée dans votre entité, la vue de la caméra des scènes s'adapte à la perspective définie de la caméra placée.

# Montage de scène amélioré
<a name="scenes-ee"></a>

AWS IoT TwinMaker les scènes comportent un ensemble d'outils permettant d'améliorer, d'éditer et de manipuler les ressources présentes dans votre scène.

Les rubriques suivantes vous expliquent comment utiliser les fonctionnalités d'édition améliorées dans vos AWS IoT TwinMaker scènes.
+ [Placement ciblé des objets de scène](#scenes-ee-placement)
+ [Sélection du sous-modèle](#scenes-ee-submodel)
+ [Modifier les entités dans la hiérarchie des scènes](#scenes-ee-hierarchy)

## Placement ciblé des objets de scène
<a name="scenes-ee-placement"></a>

AWS IoT TwinMaker vous permet de placer et d'ajouter des objets avec précision dans votre scène. Cette fonction d'édition améliorée vous permet de mieux contrôler l'endroit où vous placez les balises, les entités, les lumières et les modèles dans votre scène.

1. Accédez à votre scène dans la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/).

1. Appuyez sur le bouton **\$1**, puis sélectionnez l'une des options dans le menu déroulant. Il peut s'agir d'un modèle, d'une lampe, d'un tag ou de tout autre élément du menu **\$1**.

   Lorsque vous déplacez votre curseur dans l'espace 3D de votre scène, vous devriez voir une cible autour de votre curseur.

1. Utilisez la cible pour placer des éléments avec précision dans votre scène.

## Sélection du sous-modèle
<a name="scenes-ee-submodel"></a>

AWS IoT TwinMaker vous permet de sélectionner des sous-modèles de modèles 3D dans des scènes et de leur appliquer des propriétés standard, telles que des balises, des lumières ou des règles.

Les formats de fichier de modèle 3D contiennent des métadonnées qui peuvent spécifier des sous-zones du modèle en tant que sous-modèles au sein d'un modèle plus large. Par exemple, un modèle peut être un système de filtration, les différentes parties du système, telles que les réservoirs, les tuyaux ou un moteur, sont marquées comme des sous-modèles du modèle 3D de la filtration.

**Formats de fichiers 3D pris en charge dans les scènes** : GLB et GLTF.

1. Accédez à votre scène dans la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/).

1. Si votre scène ne contient aucun modèle, assurez-vous d'en ajouter un en sélectionnant l'option dans le menu **\$1**.

1. Sélectionnez le modèle répertorié dans la hiérarchie de votre scène. Une fois sélectionné, la hiérarchie doit afficher tous les sous-modèles situés sous le modèle.
**Note**  
Si aucun sous-modèle n'est répertorié, il est probable que le modèle n'ait pas été configuré pour comporter de sous-modèles.

1. Pour activer la visibilité d'un sous-modèle, appuyez sur l'icône en forme d'œil, située à droite du nom du sous-modèle dans la hiérarchie.

1. Pour modifier les données du sous-modèle, telles que son nom ou sa position, l'inspecteur de scène s'ouvre lorsqu'un sous-modèle est sélectionné. Utilisez le menu de l'inspecteur pour mettre à jour ou modifier les données du sous-modèle.

1. Pour ajouter des balises, des lumières, des règles ou d'autres propriétés aux sous-modèles, appuyez sur le **\$1** pendant que le sous-modèle est sélectionné dans la hiérarchie.

## Modifier les entités dans la hiérarchie des scènes
<a name="scenes-ee-hierarchy"></a>

AWS IoT TwinMaker les scènes vous permettent de modifier directement les propriétés des entités dans la table hiérarchique. La procédure suivante indique les actions que vous pouvez effectuer sur une entité via le menu de hiérarchie.

1. Accédez à votre scène dans la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/).

1. Ouvrez la hiérarchie des scènes et sélectionnez un sous-élément d'une entité que vous souhaitez manipuler.

1. Une fois l'élément sélectionné, appuyez sur le bouton **\$1**, puis dans le menu déroulant, sélectionnez l'une des options suivantes :
   + **Ajouter un nœud vide**
   + **Ajouter un modèle 3D**
   + **Ajoutez de la lumière**
   + **Ajouter une caméra depuis la vue actuelle**
   + **Ajouter un tag**
   + **Ajouter un shader de modèle**
   + **Ajouter un indicateur de mouvement**

1. Après avoir sélectionné l'une des options dans le menu déroulant, la sélection sera appliquée à la scène en tant qu'enfant de l'élément sélectionné à l'étape 2.

1. Vous pouvez réorganiser les éléments enfants et les éléments reparents en sélectionnant un élément enfant et en le faisant glisser dans la hiérarchie vers un nouveau parent.

## Ajouter des annotations aux entités
<a name="scenes-ee-annotations"></a>

Le compositeur de AWS IoT TwinMaker scène vous permet d'annoter n'importe quel élément de la hiérarchie de scène. L'annotation est rédigée en Markdown.

Pour plus d'informations sur l'écriture en Markdown, consultez la documentation officielle sur la syntaxe Markdown, [Basic](https://www.markdownguide.org/basic-syntax/) Syntax.

**Note**  
AWS IoT TwinMaker annotations et superpositions : syntaxe Markdown uniquement et non HTML.

**Ajouter une annotation à une entité**

1. Accédez à votre scène dans la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/).

1. Sélectionnez un élément dans la hiérarchie des scènes que vous souhaitez annoter. Si aucun élément de la hiérarchie n'est sélectionné, vous pouvez ajouter une annotation à la racine.

1. Appuyez sur le bouton plus **\$1** et choisissez l'option **Ajouter une annotation**.  
![\[Une page de canevas de scène avec le signe plus étendu pour afficher l'option Ajouter une annotation.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/Scene composer -annotation-menu.png)

1. Dans la fenêtre **Inspector** sur la gauche, faites défiler la page vers le bas jusqu'à la section des **annotations**. À l'aide de la syntaxe Markdown, écrivez le texte que vous souhaitez que votre annotation affiche.

   Pour plus d'informations sur l'écriture en Markdown, consultez la documentation officielle sur la syntaxe Markdown, [Basic](https://www.markdownguide.org/basic-syntax/) Syntax.  
![\[Une page de canevas de scène affichant le formulaire de saisie du contenu Markdown du panneau d'annotation.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/tm-step4a.png)

1. Pour lier les données de votre AWS IoT TwinMaker scène à une annotation, choisissez **Ajouter une liaison de données**, ajoutez l'**identifiant de l'entité**, puis sélectionnez le nom du **composant et le nom** de **propriété** de l'entité à partir de laquelle vous souhaitez faire apparaître les données. Vous pouvez mettre à jour le nom de la liaison pour l'utiliser comme variable Markdown et faire apparaître les données dans l'annotation.  
![\[Lorsque les trois points situés à droite du menu déroulant des annotations sont sélectionnés, le bouton Ajouter une liaison de données apparaît.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/tm-step5a1.png)  
![\[Lorsque le bouton Ajouter une liaison de données est sélectionné, vous pouvez saisir le nom de la liaison, l'identifiant de l'entité, ainsi que les noms des composants et des propriétés.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/tm-step5a2.png)

1. Le **nom de liaison** est utilisé pour représenter la variable de l'annotation.

   Entrez un **nom de liaison** pour faire apparaître la dernière valeur historique d'une série chronologique d'une entité dans la syntaxe variable AWS IoT TwinMaker de l'annotation : `${variable-name}`

   Par exemple, cette superposition affiche la valeur de`mixer0alarm`, dans l'annotation avec la syntaxe`${mixer0alarm}`.  
![\[Exemple de liaison de données d'annotation terminé.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/tm-step6a.png)

## Ajouter des superpositions aux balises
<a name="scenes-ee-overlay"></a>

Vous pouvez créer des superpositions pour vos AWS IoT TwinMaker scènes. Les superpositions de scènes sont associées à des balises et peuvent être utilisées pour faire apparaître des données critiques associées à vos entités de scène. La superposition est créée et rendue dans Markdown.

Pour plus d'informations sur l'écriture en Markdown, consultez la documentation officielle sur la syntaxe Markdown, [Basic](https://www.markdownguide.org/basic-syntax/) Syntax.

**Note**  
Par défaut, une **superposition** n'est visible dans une scène que lorsque la balise qui lui est associée est sélectionnée. Vous pouvez activer cette option dans les **paramètres** de la scène afin que toutes les **superpositions** soient visibles en même temps.

1. Accédez à votre scène dans la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/).

1. La AWS IoT TwinMaker **superposition** est associée à une scène de tag, vous pouvez mettre à jour un tag existant ou en ajouter un nouveau.

   Appuyez sur le bouton Plus **\$1** et choisissez l'option **Ajouter une étiquette**.  
![\[Scène dans laquelle le bouton plus a été sélectionné et où l'option Ajouter un tag est surlignée.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/Scene composer-overlay-add-tag.png)

1. Dans le panneau **Inspector** sur la droite, sélectionnez le bouton **\$1** (symbole plus), puis sélectionnez **Ajouter une superposition**.  
![\[Le panneau Inspector avec le bouton plus sélectionné et Ajouter une superposition surligné.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/tm-step4b.png)

1. Dans la syntaxe Markdown, écrivez le texte que vous souhaitez afficher dans votre superposition.

   Pour plus d'informations sur l'écriture en Markdown, consultez la documentation officielle sur la syntaxe Markdown, [Basic](https://www.markdownguide.org/basic-syntax/) Syntax.

1. Pour lier les données de votre AWS IoT TwinMaker scène à une superposition, sélectionnez **Ajouter une liaison de données**.  
![\[Le panneau Inspector avec les trois points sélectionnés et le bouton Ajouter une liaison de données surligné.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/tm-step6b.png)

   Ajoutez le **nom de la liaison** et **l'identifiant de l'entité**, puis sélectionnez le **nom du composant** et le **nom de propriété** de l'entité dont vous souhaitez faire apparaître les données.

1. Vous pouvez faire apparaître la dernière valeur historique des données chronologiques d'une entité dans la syntaxe variable AWS IoT TwinMaker de la superposition :. `${variable-name}`

   Par exemple, cette superposition affiche la valeur de`mixer0alarm`, dans la superposition avec la syntaxe. `${mixer0alarm}`  
![\[Le panneau Inspector avec les informations d'état de l'alarme saisies dans la zone de saisie du contenu Markdown.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/tm-step7b.png)

1. Pour activer la visibilité des **superpositions**, ouvrez l'onglet **Paramètres** en haut à gauche et assurez-vous que le bouton **Superposition** est activé afin que toutes les **superpositions** soient visibles en même temps.
**Note**  
Par défaut, une **superposition** n'est visible dans une scène que lorsque la balise qui lui est associée est sélectionnée.  
![\[L'onglet Paramètres affichant le bouton Overlay est désactivé.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/scene-setting.png)

# Modifiez vos scènes
<a name="scenes-editing"></a>

Après avoir créé une scène, vous pouvez y ajouter des entités, des composants et configurer des widgets augmentés. Utilisez des composants d'entité et des widgets pour modéliser votre jumeau numérique et fournir des fonctionnalités adaptées à votre cas d'utilisation.

**Topics**
+ [Ajoutez des modèles à vos scènes](scenes-editing-add-models.md)
+ [Ajoutez des widgets d'interface utilisateur augmentée avec Model Shader à votre scène](scenes-editing-add-color-widget.md)
+ [Création de tags pour vos scènes](scenes-editing-add-tags.md)

# Ajoutez des modèles à vos scènes
<a name="scenes-editing-add-models"></a>

Pour ajouter des modèles à votre scène, procédez comme suit.

**Note**  
Pour ajouter des modèles dans votre scène, vous devez d'abord les télécharger dans la bibliothèque de AWS IoT TwinMaker ressources. Pour de plus amples informations, veuillez consulter [Télécharger des ressources dans la bibliothèque AWS IoT TwinMaker de ressources](scenes-using-resource-library.md).

1. Sur la page du compositeur de scène, choisissez le signe plus (**\$1**), puis choisissez **Ajouter un modèle 3D**.

1. **Dans la fenêtre **Ajouter une ressource à partir de la bibliothèque** de ressources, sélectionnez le fichier **CookieFactorMixer.glb**, puis sélectionnez Ajouter.** Le compositeur de scène s'ouvre.

1. **Facultatif** : choisissez le signe plus (**\$1**), puis choisissez **Ajouter de la lumière**.

1. Choisissez chaque option d'éclairage pour voir comment elle affecte la scène.  
![\[Un canevas de scène avec les commandes « Type de lumière » et « Couleur » affichées pour le mélangeur de cookies sélectionné.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/CookieMixerInScene.png)
**Note**  
Les scènes disposent d'un éclairage d'ambiance par défaut. Pour éviter toute perte de fréquence d'images, pensez à limiter le nombre de lumières supplémentaires placées dans votre scène.

# Ajoutez des widgets d'interface utilisateur augmentée avec Model Shader à votre scène
<a name="scenes-editing-add-color-widget"></a>

Les widgets Model Shader peuvent modifier la couleur d'un objet selon les conditions que vous définissez. Par exemple, vous pouvez créer un widget couleur qui modifie la couleur d'un mixeur de cookies dans votre scène en fonction des données de température du mixeur.

Utilisez la procédure suivante pour ajouter des widgets de model-shader à un objet sélectionné.

1. Sélectionnez un objet dans la hiérarchie auquel vous souhaitez ajouter un widget. Appuyez sur le bouton **\$1**, puis choisissez **Model Shader**. 

1. Pour ajouter un nouveau groupe de règles visuelles, suivez d'abord les instructions ci-dessous pour le créer ColorRule, puis choisissez dans le panneau Inspector pour l'objet de l'ID de règle **ColorRule**.

1. Sélectionnez l'EntityId ComponentName, et PropertyName vous souhaitez lier le shader du modèle à.

## Créez des règles visuelles pour vos scènes
<a name="scenes-editing-add-visual-rules"></a>

Vous pouvez utiliser des cartes de règles visuelles pour spécifier les conditions basées sur les données qui modifient l'apparence visuelle d'un widget d'interface utilisateur augmentée, tel qu'une balise ou un shader de modèle. Des exemples de règles sont fournis, mais vous pouvez également créer les vôtres. L'exemple suivant montre une règle visuelle.

![\[Exemples de règles visuelles avec des expressions basées sur la température qui activent les icônes d'erreur, d'avertissement et d'information.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/scene-topic-temp-sample-rule.png)


L'image ci-dessus montre une règle concernant le moment où une propriété de données définie précédemment avec l'ID « température » est vérifiée par rapport à une certaine valeur. Par exemple, si la « température » est supérieure ou égale à 40, l'état transformera l'apparence de l'étiquette en cercle rouge. La **cible**, lorsqu'elle est choisie dans le tableau de bord Grafana, remplit un panneau détaillé configuré pour utiliser la même source de données.

La procédure suivante explique comment ajouter un nouveau groupe de règles visuelles pour la couche d'interface utilisateur augmentée par colorisation du maillage.

1. Dans l'onglet règles de la console, entrez un nom tel que ColorRule dans le champ de texte et choisissez **Ajouter un nouveau groupe de règles**.  
![\[L'onglet « Règles » avec le nom de la nouvelle carte de règles saisi au-dessus du bouton « Ajouter un nouveau groupe de règles ».\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/scenes-new-vis-rule-create.png)

1. Définissez une nouvelle règle pour votre cas d'utilisation. Par exemple, vous pouvez en créer un en fonction de la propriété de données « temperature », où la valeur déclarée est inférieure à 20. **Utilisez la syntaxe suivante pour les expressions de règles : inférieur à **<**, supérieur à **>**, inférieur ou égal est **<=**, supérieur ou égal est **>=** et égal est ==.** (Pour plus d'informations, consultez la [syntaxe JEXL d'Apache Commons](https://commons.apache.org/proper/commons-jexl/reference/syntax.html).) 

1. Définissez la cible sur une couleur. Pour définir une couleur, utilisez par exemple `#fcba03` des valeurs hexadécimales. (Pour plus d'informations sur les valeurs hexadécimales, voir [Hexadécimal](https://en.wikipedia.org/wiki/Hexadecimal).)

# Création de tags pour vos scènes
<a name="scenes-editing-add-tags"></a>

Une balise est une annotation ajoutée à une position de `x,y,z` coordonnées spécifique d'une scène. La balise utilise une propriété d'entité pour connecter une partie de scène au graphe de connaissances. Vous pouvez utiliser une balise pour configurer le comportement ou l'apparence visuelle d'un élément de la scène, tel qu'une alarme.

**Note**  
Pour ajouter des fonctionnalités aux balises, vous devez leur appliquer des règles visuelles.

Pour ajouter des balises à votre scène, procédez comme suit.

1. Sélectionnez un objet dans la hiérarchie, cliquez sur le bouton **\$1**, puis choisissez **Ajouter une étiquette**.

1. Donnez un nom au tag. Ensuite, pour appliquer une règle visuelle, sélectionnez un identifiant de groupe visuel.

1. Dans les listes déroulantes, choisissez ComponentName EntityId, et. PropertyName

1. Pour renseigner le champ Data Path, choisissez **Create DataFrameLabel**.

# Format du modèle 3D Tiles
<a name="3d-tiles-model-format"></a>

## Utilisation de tuiles 3D dans votre scène
<a name="scenes-3dtiles-using"></a>

Si les temps d'attente sont longs lorsque vous chargez des scènes 3D AWS IoT TwinMaker ou si les performances de rendu sont médiocres lorsque vous naviguez dans un modèle 3D complexe, vous souhaiterez peut-être convertir vos modèles en tuiles 3D. Cette section décrit le format des tuiles 3D et les outils tiers disponibles. Poursuivez votre lecture pour savoir si 3D Tiles convient à votre cas d'utilisation et pour obtenir de l'aide pour démarrer.

### Cas d'utilisation d'un modèle complexe
<a name="scenes-3dtiles-use-case"></a>

La présence d'un modèle 3D dans votre AWS IoT TwinMaker scène peut entraîner des problèmes de performances tels que des temps de chargement lents et des retards de navigation si le modèle est :
+ **Grand** : la taille de son fichier est supérieure à 100 Mo.
+ **Dense** : il est composé de centaines ou de milliers de mailles distinctes.
+ **Complexe** : la géométrie du maillage comporte des millions de triangles pour former des formes complexes.

### Format 3D Tiles
<a name="scenes-3dtiles-format"></a>

[Le format 3D Tiles](https://www.ogc.org/standard/3dtiles/) est une solution pour diffuser la géométrie des modèles et améliorer les performances de rendu 3D. Il permet le chargement instantané de modèles 3D dans une AWS IoT TwinMaker scène et optimise les interactions 3D en chargeant des parties d'un modèle en fonction de ce qui est visible dans la vue de la caméra. 

Le format 3D Tiles a été créé par [Cesium](https://cesium.com/). Cesium dispose d'un service géré pour convertir les modèles 3D en tuiles 3D appelé [Cesium Ion](https://cesium.com/platform/cesium-ion/). Il s'agit actuellement de la meilleure solution pour créer des tuiles 3D, et nous la recommandons pour vos modèles complexes dans les [formats pris en charge](https://cesium.com/learn/3d-tiling/tiler-data-formats/#supported-data-formats). Vous pouvez enregistrer Cesium et choisir le plan d'abonnement approprié en fonction des besoins de votre entreprise sur la page [de tarification de Cesium](https://cesium.com/platform/cesium-ion/pricing/).

Pour préparer un modèle 3D Tiles que vous pouvez ajouter à une AWS IoT TwinMaker scène, suivez les instructions documentées par Cesium Ion :
+ [Importer un modèle dans Cesium Ion](https://cesium.com/learn/3d-tiling/tiler-data-formats/)

### Téléchargez des tuiles Cesium 3D sur AWS
<a name="scenes-3dtiles-upload"></a>

Une fois que votre modèle a été converti en 3D Tiles, téléchargez les fichiers du modèle, puis chargez-les dans le compartiment Amazon S3 de votre AWS IoT TwinMaker espace de travail :

1. [Créez et téléchargez votre archive de modèles 3D Tiles](https://cesium.com/learn/ion/cesium-ion-archives-and-exports/#create-and-download-an-asset-archive).

1. Décompressez l'archive dans un dossier.

1. Téléchargez l'intégralité du dossier 3D Tiles dans le compartiment Amazon S3 associé à votre AWS IoT TwinMaker espace de travail. (Consultez la section [Chargement d'objets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) dans le guide de l'utilisateur Amazon S3.)

1. Si votre modèle 3D Tiles a été chargé avec succès, vous verrez un chemin de dossier Amazon S3 dans votre [bibliothèque de AWS IoT TwinMaker ressources](scenes-using-resource-library.md) avec type`Tiles3D`.

**Note**  
La bibliothèque de AWS IoT TwinMaker ressources ne prend pas en charge le téléchargement direct de modèles 3D Tiles.

### Utilisation de tuiles 3D dans AWS IoT TwinMaker
<a name="scenes-3dtiles-cesium-ion"></a>

AWS IoT TwinMaker est au courant de tout modèle 3D Tiles chargé dans le compartiment S3 de votre espace de travail. Le modèle doit avoir un `tileset.json` et tous les fichiers dépendants (.gltf, .b3dm, .i3dm, .cmpt, .pnts) disponibles dans le même répertoire Amazon S3. Le chemin du répertoire Amazon S3 apparaîtra dans la bibliothèque de ressources avec le type`Tiles3D`.

Pour ajouter le modèle 3D Tiles à votre scène, procédez comme suit :

1. Sur la page du compositeur de scène, choisissez le signe plus (**\$1**), puis choisissez **Ajouter un modèle 3D**.

1. Dans la fenêtre **Ajouter une ressource à partir de la bibliothèque** de ressources, choisissez le chemin d'accès à votre modèle 3D Tiles avec le type`Tiles3D`, puis choisissez **Ajouter**.

1. Cliquez sur le canevas pour placer le modèle dans votre scène.

#### Différences entre les tuiles 3D
<a name="scenes-3dtiles-differences"></a>

3D Tiles ne prend actuellement pas en charge les métadonnées géométriques et sémantiques, ce qui signifie que la hiérarchie de maillage du modèle d'origine n'est pas disponible pour la fonction de sélection du sous-modèle. Vous pouvez toujours ajouter des widgets à votre modèle 3D Tiles, mais vous ne pouvez pas utiliser les fonctionnalités adaptées aux sous-modèles : shader de modèle, transformations 3D séparées ou liaison d'entités pour un maillage de sous-modèle. 

Il est recommandé d'utiliser la conversion de tuiles 3D pour les éléments volumineux qui servent de contexte à l'arrière-plan d'une scène. Si vous souhaitez qu'un sous-modèle soit encore décomposé et annoté, il doit être extrait en tant que glTF/glb ressource distincte et ajouté directement à la scène. Cela peut être fait avec des outils 3D gratuits et courants tels que [Blender](https://www.blender.org/). 

**Exemple de cas d'utilisation :**
+ Vous disposez d'un modèle d'usine de 1 Go avec des salles des machines et des sols détaillés, des boîtiers électriques et des tuyaux de plomberie. Les boîtiers et tuyaux électriques doivent briller en rouge lorsque les données de propriété associées franchissent un seuil.
+ Vous isolez les mailles de boîte et de tuyauterie dans le modèle et vous les exportez dans un glTF distinct à l'aide de Blender.
+ Vous convertissez l'usine sans éléments électriques et de plomberie en un modèle 3D Tiles et vous le téléchargez sur S3.
+ Vous ajoutez à la fois le modèle 3D Tiles et le modèle glTF à une AWS IoT TwinMaker scène à l'origine (0,0,0).
+ Vous ajoutez des composants de model-shader aux sous-modèles de boîtiers électriques et de tuyaux du glTF pour rendre les maillages rouges en fonction des règles de propriété.

# Scènes dynamiques
<a name="dynamic-scenes"></a>

AWS IoT TwinMaker les scènes exploitent la puissance du [graphe de connaissances](tm-knowledge-graph.md) en stockant les nœuds de scène et les paramètres dans un composant d'entité. Utilisez la AWS IoT TwinMaker console pour créer des **scènes dynamiques** afin de gérer, de créer et de rendre plus facilement des scènes 3D.

**Caractéristiques principales :**
+ Tous les objets, paramètres et liaisons de données des nœuds de scène 3D sont rendus « dynamiquement » sur la base de requêtes de graphes de connaissances.
+ Si vous utilisez le visualiseur de scènes en lecture seule dans une application Grafana ou personnalisée, vous pouvez obtenir des mises à jour de vos scènes toutes les 30 secondes.

## Scènes statiques ou dynamiques
<a name="dynamic-scenes-vs-static"></a>

Les **scènes statiques** sont composées d'un fichier JSON de scène stocké dans S3 qui contient les détails de tous les nœuds et paramètres de scène. Toute modification apportée à la scène doit être apportée au document JSON et enregistrée dans S3. Une scène statique est la seule option si vous avez un [plan tarifaire de base](https://aws.amazon.com/iot-twinmaker/pricing/).

Les **scènes dynamiques** sont composées d'un fichier JSON contenant les paramètres globaux de la scène, tandis que tous les autres nœuds de scène et paramètres de nœuds sont stockés en tant que composants d'entité dans le graphe de connaissances. Les scènes dynamiques ne sont prises en charge que dans les plans tarifaires standard et échelonnés. Consultez [Changer de mode de AWS IoT TwinMaker tarification](tm-pricing-mode.md) pour plus d'informations sur la manière de mettre à niveau votre plan tarifaire).

Vous pouvez convertir une scène statique existante en scène dynamique en procédant comme suit :
+ Accédez à votre scène dans la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/).
+ Sur le panneau de gauche, cliquez sur l'onglet **Paramètres**.
+ Développez la section **Convertir la scène** en bas du panneau.
+ Cliquez sur le bouton **Convertir la scène**, puis sur **Confirmer**.

**Avertissement**  
 La conversion d'une scène statique en scène dynamique est irréversible. 

![\[3D modeling interface with grid and a robotic arm model in the center.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/convert-scene.png)


## Types de composants et entités de scène
<a name="dynamic-scenes-types-entities"></a>

Afin de créer des composants d'entité spécifiques à une scène, les types de composants 1P suivants sont pris en charge :
+ **com.amazon.iottwinmaker.3d.component.camera** [Type de composant qui stocke les paramètres d'un widget de caméra.](scenes-camera.md)
+ **com.amazon.iottwinmaker.3d.component.dataoverlay Type de composant qui stocke les paramètres d'une superposition** [d'un widget d'annotation ou de balise.](scenes-ee.md#scenes-ee-overlay)
+ **com.amazon.iottwinmaker.3d.component.light** Type de composant qui stocke les paramètres d'un widget lumineux.
+ **com.amazon.iottwinmaker.3d.component.modelref Type de composant qui stocke les paramètres et l'emplacement S3** d'un modèle 3D utilisé dans une scène.
+ **com.amazon.iottwinmaker.3d.component.modelshader Type de composant qui stocke les paramètres d'un model shader** [sur un modèle 3D.](scenes-editing-add-color-widget.md)
+ **com.amazon.iottwinmaker.3d.component.motionindicator Type de composant qui stocke les paramètres d'un widget indicateur de mouvement.**
+ **com.amazon.iottwinmaker.3d.component.submodelref Type de composant qui stocke les paramètres d'un sous-modèle d'un modèle** [3D.](scenes-ee.md#scenes-ee-submodel)
+ **com.amazon.iottwinmaker.3d.component.tag** [Type de composant qui stocke les paramètres d'un widget de balises.](scenes-editing-add-tags.md)
+ **com.amazon.iottwinmaker.3d.node Type de composant qui stocke les paramètres de base d'un nœud** de scène, tels que sa transformation 3D, son nom et ses propriétés génériques.

## Concepts de scène dynamiques
<a name="dynamic-scenes-concepts"></a>

Les entités de scène dynamiques sont stockées sous une entité globale étiquetée`$SCENES`. Chaque scène est composée d'une entité racine et d'une hiérarchie d'entités enfants correspondant à la hiérarchie des nœuds de scène. Chaque nœud de scène situé sous la racine possède un composant **com.amazon.iottwinmaker.3d.node et un composant correspondant au type de nœud** (modèle 3D, widget, etc.).

**Avertissement**  
Ne supprimez aucune entité de scène manuellement, sinon votre scène est peut-être en mauvais état. Si vous souhaitez supprimer partiellement ou totalement une scène, utilisez la page du compositeur de scène pour ajouter et supprimer des nœuds de scène, et utilisez la page des scènes pour sélectionner et supprimer une scène.