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.
# AWS IoT TwinMaker Intégration à Matterport
Matterport propose diverses options de capture pour scanner des environnements réels et créer des modèles 3D immersifs, également connus sous le nom de jumeaux numériques Matterport. Ces modèles sont appelés espaces Matterport. AWS IoT TwinMaker prend en charge l'intégration de Matterport, vous permettant d'importer vos jumeaux numériques Matterport dans vos scènes. AWS IoT TwinMaker En associant les jumeaux numériques Matterport à AWS IoT TwinMaker, vous pouvez visualiser et surveiller votre système de jumeaux numériques dans un environnement virtuel.
![\[Une AWS IoT TwinMaker scène avec un environnement Matterport importé.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/tm-mp-industrial-site.png)
[Pour plus d'informations sur l'utilisation de Matterport, consultez la documentation de Matterport sur AWS IoT TwinMaker la page Matterport.](https://matterport.com/partners/amazon-web-services)
**Topics**
+ [Présentation de l’intégration](#tm-matterport-integration-overview)
+ [Conditions préalables à l'intégration de Matterport](#tm-matterport-integration-prereqs)
+ [Générez et enregistrez vos informations d'identification Matterport](#tm-matterport-integration-sdk-key)
+ [Stockez vos informations d'identification Matterport dans AWS Secrets Manager](#tm-matterport-integration-secrets)
+ [Importer des espaces Matterport dans des scènes AWS IoT TwinMaker](#tm-matterport-integration-tm-console)
+ [Utilisez les espaces Matterport dans votre tableau de bord Grafana AWS IoT TwinMaker](#tm-matterport-grafana)
+ [Utilisez les espaces Matterport dans votre application Web AWS IoT TwinMaker](#tm-matterport-app-kit)
## Présentation de l’intégration
Cette intégration vous permet d'effectuer les opérations suivantes :
+ Utilisez vos tags et espaces Matterport dans le kit d' AWS IoT TwinMaker applications.
+ Consultez vos données Matterport importées dans votre tableau de bord Grafana AWS IoT TwinMaker . Pour plus d'informations sur l'utilisation AWS IoT TwinMaker de Grafana, consultez la documentation d'intégration du tableau de bord [Grafana](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/grafana-integration.html).
+ Importez vos espaces Matterport dans vos AWS IoT TwinMaker scènes.
+ Sélectionnez et importez les balises Matterport que vous souhaitez lier aux données de votre AWS IoT TwinMaker scène.
+ Affichez automatiquement votre espace Matterport et balisez les modifications apportées à votre AWS IoT TwinMaker scène et approuvez les modifications à synchroniser.
Le processus d'intégration comprend 3 étapes critiques.
1. **[Générez et enregistrez vos informations d'identification Matterport](#tm-matterport-integration-sdk-key)**
1. **[Stockez vos informations d'identification Matterport dans AWS Secrets Manager](#tm-matterport-integration-secrets)**
1. **[Importer des espaces Matterport dans des scènes AWS IoT TwinMaker](#tm-matterport-integration-tm-console)**
Vous commencez votre intégration dans la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/). Sur la page **Paramètres** de la console, sous **Ressources tierces**, ouvrez **l'intégration Matterport** pour naviguer entre les différentes ressources requises pour l'intégration.
![\[La page des paramètres de la AWS IoT TwinMaker console, qui affiche la page d'intégration de Matterport sous l'onglet Ressources tierces.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/Workspace details page.png)
## Conditions préalables à l'intégration de Matterport
Avant d'intégrer Matterport à, AWS IoT TwinMaker assurez-vous de remplir les conditions préalables suivantes :
+ Vous avez acheté un compte Matterport d'entreprise et les produits [Matterport](https://my.matterport.com/) nécessaires à l'intégration. AWS IoT TwinMaker
+ Vous disposez d'un AWS IoT TwinMaker espace de travail. Pour plus d'informations, consultez la section [Mise en route avec AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs.html).
+ Vous avez mis à jour votre rôle dans AWS IoT TwinMaker l'espace de travail. Pour plus d'informations sur la création d'un rôle d'espace de travail, voir [Créer et gérer un rôle de service pour AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs-service-role.html).
Ajoutez les éléments suivants à votre rôle dans l'espace de travail :
```
{
"Effect": "Allow",
"Action": "secretsmanager:GetSecretValue",
"Resource": [
"AWS Secrets Manager secret ARN"
]
}
```
+ Vous devez contacter Matterport pour configurer les licences nécessaires à l'activation de l'intégration. Matterport activera également un Private Model Embed (PME) pour l'intégration.
Si vous avez déjà un gestionnaire de compte Matterport, contactez-le directement.
Utilisez la procédure suivante pour contacter Matterport et demander une intégration si vous n'avez pas de point de contact Matterport :
1. Ouvrez le **[Matterport et AWS IoT TwinMaker](https://matterport.com/partners/amazon-web-services)** la page.
1. Cliquez sur le bouton **Contactez-nous** pour ouvrir le formulaire de contact.
1. Renseignez les informations requises sur le formulaire.
1. Lorsque vous êtes prêt, choisissez **SAY HELLO** pour envoyer votre demande à Matterport.
Une fois que vous avez demandé l'intégration, vous pouvez générer les informations d'identification nécessaires au SDK Matterport et au Private Model Embed (PME) nécessaires pour poursuivre le processus d'intégration.
**Note**
Cela peut impliquer que vous deviez payer des frais pour l'achat de nouveaux produits ou services.
## Générez et enregistrez vos informations d'identification Matterport
Pour intégrer Matterport à AWS IoT TwinMaker, vous devez fournir AWS Secrets Manager des informations d'identification Matterport. Utilisez la procédure suivante pour générer les informations d'identification du SDK Matterport.
1. Connectez-vous à votre compte [Matterport](https://authn.matterport.com).
1. Accédez à la page des paramètres de votre compte.
1. Une fois sur la page des paramètres, sélectionnez l'option **Outils** de développement.
1. Sur la page **des outils** de développement, accédez à la section **Gestion des clés du SDK**.
1. Une fois dans la section **Gestion des clés du SDK**, sélectionnez l'option permettant d'ajouter une nouvelle clé du SDK.
1. Une fois que vous avez la clé du SDK Matterport, ajoutez des domaines à la clé pour et à AWS IoT TwinMaker votre serveur Grafana. Si vous utilisez le kit d' AWS IoT TwinMaker applications, assurez-vous d'ajouter également votre domaine personnalisé.
1. Ensuite, recherchez la section **Gestion de l'intégration des applications**, vous devriez voir votre **application PME répertoriée**. Enregistrez les informations suivantes :
+ L'**identifiant du client**
+ Le **secret du client**
**Note**
**Comme le **secret client** ne vous est présenté qu'une seule fois, nous vous recommandons vivement de l'enregistrer.** Vous devez présenter votre **secret client** dans la AWS Secrets Manager console pour poursuivre l'intégration de Matterport.
Ces informations d'identification sont automatiquement créées lorsque vous avez acheté les composants nécessaires et que le PME de votre compte a été activé par Matterport. Si ces informations d'identification n'apparaissent pas, contactez Matterport. Pour demander un contact, consultez le **[Matterport et](https://matterport.com/partners/amazon-web-services)** le formulaire de AWS IoT TwinMaker contact.
[Pour plus d'informations sur les informations d'identification du SDK Matterport, consultez la documentation officielle du SDK de Matterport. Vue d'ensemble des documents SDK Docs.](https://matterport.github.io/showcase-sdk/index.html)
## Stockez vos informations d'identification Matterport dans AWS Secrets Manager
Utilisez la procédure suivante pour enregistrer vos informations d'identification Matterport dans. AWS Secrets Manager
**Note**
Vous avez besoin du **secret client** créé à partir de la procédure décrite dans la [Générez et enregistrez vos informations d'identification Matterport](#tm-matterport-integration-sdk-key) rubrique pour poursuivre l'intégration de Matterport.
1. Connectez-vous à la AWS Secrets Manager console.
1. Accédez à la page **Secrets** et sélectionnez **Enregistrer un nouveau secret**.
1. Pour le **type de secret**, sélectionnez **Autre type de secret**.
1. Dans la section **Paires clé/valeur, ajoutez les paires clé-valeur** suivantes, avec vos informations d'identification Matterport comme valeurs :
+ Créez une paire clé-valeur, avec **Key :** `application_key` et **Value** :. **
+ Créez une paire clé-valeur, avec **Key :** `client_id` et **Value** :. **
+ Créez une paire clé-valeur, avec **Key :** `client_secret` et **Value** :. **
Une fois terminé, vous devriez avoir une configuration similaire à l'exemple suivant :
![\[Les paires clé-valeur requises répertoriant les informations d'identification Matterport utilisées dans le processus d'intégration.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/tm-mp-key-value-step.png)
1. Pour la **clé de chiffrement**, vous pouvez laisser la clé de chiffrement par défaut `aws/secretsmanager` sélectionnée.
1. Choisissez **Next** pour accéder à la page de **configuration secrète**.
1. Remplissez le champ **Nom du secret** et **Description**.
1. Ajoutez un tag à ce secret dans la section **Tags**.
Lors de la création de la balise, attribuez la clé `AWSIoTTwinMaker_Matterport` comme indiqué dans la capture d'écran suivante :
![\[Une page de console secrète de configuration avec la clé Tag saisie.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/tm-mp-tag-step.png)
**Note**
Vous devez ajouter un tag. Les balises sont obligatoires lors de l'ajout de secrets tiers AWS Secrets Manager, bien que les **balises** soient répertoriées comme facultatives.
Le champ **Value** est facultatif. Une fois que vous avez fourni une **clé**, vous pouvez sélectionner **Ajouter** pour passer à l'étape suivante.
1. Choisissez **Next** pour passer à la page **Configurer la rotation**. La configuration d'une rotation secrète est facultative. Si vous souhaitez terminer d'ajouter votre secret et que vous n'avez pas besoin d'une rotation, choisissez à nouveau **Next**. Pour plus d'informations sur la rotation secrète, voir [Rotation AWS Secrets Manager des secrets](https://docs.aws.amazon.com//secretsmanager/latest/userguide/rotating-secrets.html).
1. Confirmez votre configuration secrète sur la page de **révision**. Une fois que vous êtes prêt à ajouter votre secret, choisissez **Store**.
Pour plus d'informations sur l'utilisation AWS Secrets Manager, consultez la AWS Secrets Manager documentation suivante :
+ [Créez et gérez des secrets avec AWS Secrets Manager](https://docs.aws.amazon.com//secretsmanager/latest/userguide/managing-secrets.html)
+ [Qu'est-ce que c'est AWS Secrets Manager ?](https://docs.aws.amazon.com//secretsmanager/latest/userguide/intro.html)
+ [Faire pivoter AWS Secrets Manager les secrets](https://docs.aws.amazon.com//secretsmanager/latest/userguide/rotating-secrets.html)
Vous êtes maintenant prêt à importer vos ressources Matterport dans AWS IoT TwinMaker des scènes. Reportez-vous à la procédure décrite dans la section suivante, [Importer des espaces Matterport dans des scènes AWS IoT TwinMaker](#tm-matterport-integration-tm-console)
## Importer des espaces Matterport dans des scènes AWS IoT TwinMaker
Ajoutez des scans Matterport à votre scène en sélectionnant le compte Matterport connecté sur la page des paramètres de scène. Suivez la procédure suivante pour importer vos scans et tags Matterport :
1. Connectez-vous à la [console AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/).
1. Créez ou ouvrez une AWS IoT TwinMaker scène existante dans laquelle vous souhaitez utiliser un espace Matterport.
1. Une fois la scène ouverte, accédez à l'onglet **Paramètres**.
1. Dans **Paramètres**, sous **Ressources tierces, recherchez** le **nom de la connexion** et entrez le secret que vous avez créé dans la procédure à partir de[Stockez vos informations d'identification Matterport dans AWS Secrets Manager](#tm-matterport-integration-secrets).
![\[Le contenu de l'onglet Paramètres après avoir enregistré les informations d'identification du SDK Matterport en tant que secret.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/Project nav(1).png)
**Note**
Si le message « **Aucune connexion** » s'affiche, accédez à la page des paramètres de la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/) pour commencer le processus d'intégration de Matterport.
![\[L'onglet des paramètres avec le message « Aucune connexion ».\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/Project nav.png)
1. Ensuite, choisissez l'espace Matterport que vous souhaitez utiliser dans votre scène en le sélectionnant dans le menu déroulant de l'espace **Matterport**.
![\[L'onglet des paramètres avec la liste déroulante de l'espace Matterport s'affiche.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/Project nav(2).png)
1. Après avoir sélectionné un espace, vous pouvez importer vos tags Matterport et les convertir en tags de AWS IoT TwinMaker scène en appuyant sur le bouton **Importer des tags**.
![\[L'onglet des paramètres avec le bouton Importer les tags s'affiche.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/Project nav(3).png)
Après avoir importé les tags Matterport, le bouton est remplacé par un bouton **Mettre à jour les tags**. Vous pouvez continuellement mettre à jour vos tags Matterport AWS IoT TwinMaker afin qu'ils reflètent toujours les modifications les plus récentes apportées à votre compte Matterport.
![\[L'onglet des paramètres avec le bouton Mettre à jour les balises s'affiche.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/Project nav(4).png)
1. Vous avez réussi l'intégration AWS IoT TwinMaker à Matterport, et votre AWS IoT TwinMaker scène contient à la fois votre espace Matterport et vos tags importés. Vous pouvez travailler dans cette scène comme vous le feriez avec n'importe quelle autre AWS IoT TwinMaker scène.
Pour plus d'informations sur l'utilisation des AWS IoT TwinMaker scènes, voir [Création et modification de AWS IoT TwinMaker scènes](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/scenes.html).
## Utilisez les espaces Matterport dans votre tableau de bord Grafana AWS IoT TwinMaker
Une fois que vous avez importé votre espace Matterport dans une AWS IoT TwinMaker scène, vous pouvez visualiser cette scène avec l'espace Matterport dans votre tableau de bord Grafana. Si vous avez déjà configuré Grafana avec AWS IoT TwinMaker, vous pouvez simplement ouvrir le tableau de bord Grafana pour afficher votre scène avec l'espace Matterport importé.
Si vous n'avez pas encore configuré AWS IoT TwinMaker avec Grafana, terminez d'abord le processus d'intégration de Grafana. Vous avez deux choix lors de l'intégration AWS IoT TwinMaker à Grafana. Vous pouvez utiliser une instance Grafana autogérée ou vous pouvez utiliser Amazon Managed Grafana.
Consultez la documentation suivante pour en savoir plus sur les options et le processus d'intégration de Grafana :
+ AWS IoT TwinMaker Intégration au tableau de [bord Grafana](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/grafana-integration.html).
+ [Amazon a géré Grafana](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/amazon-managed-grafana.html).
+ [Grafana autogéré](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/self-managed-grafana.html).
## Utilisez les espaces Matterport dans votre application Web AWS IoT TwinMaker
Une fois que vous avez importé votre espace Matterport dans une AWS IoT TwinMaker scène, vous pouvez visualiser cette scène avec l'espace Matterport dans l' AWS IoT application Web de votre kit d'applications.
Consultez la documentation suivante pour en savoir plus sur l'utilisation du kit AWS IoT d'application :
+ Pour en savoir plus sur AWS IoT TwinMaker l'utilisation du kit d' AWS IoT applications, consultez[Création d'une application Web personnalisée à l'aide des composants de l' AWS IoT TwinMaker interface utilisateur](tm-app-kit.md).
+ Pour en savoir plus sur l'utilisation du kit AWS IoT d'application, rendez-vous sur la page [Github du kit d'AWS IoT application](https://github.com/awslabs/iot-app-kit).
+ Pour savoir comment démarrer une nouvelle application Web à l'aide du kit AWS IoT d'application, rendez-vous sur la page de documentation officielle de [l'IoT App Kit](https://awslabs.github.io/iot-app-kit/?path=/docs/introduction--docs).