As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# AWS IoT TwinMaker Integração com Matterport
O Matterport fornece uma variedade de opções de captura para a digitalização de ambientes do mundo real e criação de modelos 3D imersivos, também conhecidos como gêmeos digitais Matterport. Esses modelos são chamados de espaços Matterport. O AWS IoT TwinMaker é compatível com integração com o Matterport, permitindo que você importe seus gêmeos digitais do Matterport para suas cenas AWS IoT TwinMaker . Ao emparelhar gêmeos digitais Matterport com AWS IoT TwinMaker, você pode visualizar e monitorar seu sistema de gêmeos digitais em um ambiente virtual.
Para obter mais informações sobre como usar o Matterport, leia a documentação do Matterport na página [AWS IoT TwinMaker e Matterport](https://matterport.com/partners/amazon-web-services).
**Topics**
+ [Visão geral da integração](#tm-matterport-integration-overview)
+ [Pré-requisitos da integração com o Matterport](#tm-matterport-integration-prereqs)
+ [Gere e registre suas credenciais do Matterport](#tm-matterport-integration-sdk-key)
+ [Armazene suas credenciais da Matterport em AWS Secrets Manager](#tm-matterport-integration-secrets)
+ [Importe espaços do Matterport para cenas AWS IoT TwinMaker](#tm-matterport-integration-tm-console)
+ [Use espaços do Matterport em seu painel do Grafana AWS IoT TwinMaker](#tm-matterport-grafana)
+ [Use espaços Matterport em seu aplicativo web AWS IoT TwinMaker](#tm-matterport-app-kit)
## Visão geral da integração
Essa integração permite que você:
+ Use suas tags e espaços Matterport no kit do AWS IoT TwinMaker aplicativo.
+ Visualize seus dados importados do matterport no painel do Grafana AWS IoT TwinMaker . Para obter mais informações sobre como usar o AWS IoT TwinMaker Grafana, leia a documentação de integração do painel do [Grafana](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/grafana-integration.html).
+ Importe seus espaços do Matterport para suas AWS IoT TwinMaker cenas.
+ Selecione e importe suas tags Matterport que você gostaria de vincular aos dados em sua cena. AWS IoT TwinMaker
+ Mostre automaticamente seu espaço no Matterport, marque as alterações em sua AWS IoT TwinMaker cena e aprove quais sincronizar.
O processo de integração é composto por três etapas críticas.
1. **[Gere e registre suas credenciais do Matterport](#tm-matterport-integration-sdk-key)**
1. **[Armazene suas credenciais da Matterport em AWS Secrets Manager](#tm-matterport-integration-secrets)**
1. **[Importe espaços do Matterport para cenas AWS IoT TwinMaker](#tm-matterport-integration-tm-console)**
Você inicia sua integração no [console do AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/). Na página **Configurações** do console, em **Recursos de terceiros**, abra **Integração com o Matterport** para navegar entre os diferentes recursos necessários para a integração.
## Pré-requisitos da integração com o Matterport
Antes de integrar o Matterport com AWS IoT TwinMaker , certifique-se de atender aos seguintes pré-requisitos:
+ Você adquiriu uma conta Matterport de nível corporativo e os produtos [Matterport](https://my.matterport.com/) necessários para a integração. AWS IoT TwinMaker
+ Você tem um AWS IoT TwinMaker espaço de trabalho. Para obter mais informações, consulte [Introdução ao AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs.html).
+ Você atualizou sua função no AWS IoT TwinMaker espaço de trabalho. Para obter mais informações sobre como criar um perfil de serviço do espaço de trabalho, consulte [Criar e gerenciar uma função de serviço para AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs-service-role.html).
Adicione o conteúdo a seguir ao seu perfil do espaço de trabalho:
```
{
"Effect": "Allow",
"Action": "secretsmanager:GetSecretValue",
"Resource": [
"AWS Secrets Manager secret ARN"
]
}
```
+ Você deve entrar em contato com o Matterport para configurar o licenciamento necessário para permitir a integração. O Matterport também habilitará um Private Model Embed (PME) para a integração.
Se você já tem um gerente de contas Matterport, entre em contato com ele diretamente.
Use o procedimento a seguir para entrar em contato com o Matterport e solicitar uma integração caso não tenha um ponto de contato com o Matterport:
1. Abra a página **[Matterport e AWS IoT TwinMaker](https://matterport.com/partners/amazon-web-services)**.
1. Pressione o botão **Fale conosco** para abrir o formulário de contato.
1. Preencha as informações necessárias no formulário.
1. Quando estiver pronto, escolha **DIGA OLÁ** para enviar sua solicitação para o Matterport.
Depois de solicitar a integração, você poderá gerar as credenciais necessárias do SDK do Matterport e do Private Model Embed (PME) necessárias para dar continuidade ao processo de integração.
**nota**
Isso pode envolver a cobrança de uma taxa pela compra de novos produtos ou serviços.
## Gere e registre suas credenciais do Matterport
Para integrar o Matterport com AWS IoT TwinMaker, você deve fornecer AWS Secrets Manager as credenciais do Matterport. Use o procedimento a seguir para gerar as credenciais do SDK do Matterport.
1. Faça login na sua conta [Matterport](https://authn.matterport.com).
1. Navegue até a página de configurações da sua conta.
1. Uma vez na página de configurações, selecione a opção **Ferramentas do desenvolvedor**.
1. Na página **Ferramentas do desenvolvedor**, acesse a seção **Gerenciamento de chaves do SDK**.
1. Na seção **Gerenciamento de chaves do SDK**, selecione a opção para adicionar uma nova chave do SDK.
1. Depois de ter a chave do Matterport SDK, adicione domínios à chave e ao AWS IoT TwinMaker seu servidor Grafana. Se você estiver usando o kit de AWS IoT TwinMaker aplicativos, certifique-se de adicionar também seu domínio personalizado.
1. Então, localize a seção **Gerenciamento de integração de aplicativos**. Nela, você deve ver seu **aplicativo PME listado**. Registre as seguintes informações:
+ O **ID do cliente**
+ O **Segredo do cliente**
**nota**
Como o **Segredo do cliente** é apresentado a você apenas uma vez, recomendamos que você registre o **Segredo do cliente**. Você deve apresentar seu **Segredo do cliente** no console do AWS Secrets Manager para dar continuidade à integração com o Matterport.
Essas credenciais são criadas automaticamente quando você adquire os componentes necessários e o PME da sua conta é ativado pelo Matterport. Se essas credenciais não forem exibidas, entre em contato com a Matterport. Para solicitar contato, consulte o **[Matterport e o formulário de contato AWS IoT TwinMaker](https://matterport.com/partners/amazon-web-services)**.
Para obter mais informações sobre as credenciais do SDK do Matterport, consulte a documentação oficial do SDK do Matterport em [isão geral da documentação do SDK](https://matterport.github.io/showcase-sdk/index.html).
## Armazene suas credenciais da Matterport em AWS Secrets Manager
Use o procedimento a seguir para armazenar suas credenciais do Matterport em. AWS Secrets Manager
**nota**
O **Segredo do cliente**, criado a partir do procedimento no tópico [Gere e registre suas credenciais do Matterport](#tm-matterport-integration-sdk-key), é necessário para dar continuidade à integração com o Matterport.
1. Faça login no AWS Secrets Manager console.
1. Navegue até a página **Segredos** e selecione **Armazenar um novo segredo**.
1. Para o **Tipo de segredo**, selecione **Outro tipo de segredo**.
1. Na seção **Pares de chave/valor**, adicione os seguintes pares de chave-valor, usando suas credenciais do Matterport como valores:
+ Crie um par de valores-chave, com **Key:** `application_key` e **Value**:. {{}}
+ Crie um par de valores-chave, com **Key:** `client_id` e **Value**:. {{}}
+ Crie um par de valores-chave, com **Key:** `client_secret` e **Value**:. {{}}
Ao concluir, você deverá ter uma configuração semelhante à do seguinte exemplo:
1. Em **Chave de criptografia**, você pode deixar a chave de criptografia padrão `aws/secretsmanager` selecionada.
1. Escolha **Próximo** para ir para a página **Configurar segredo**.
1. Preencha o campo para o **Nome do segredo** e a **Descrição**.
1. Adicione uma tag a esse segredo na seção **Tags**.
Ao criar a tag, atribua a chave `AWSIoTTwinMaker_Matterport` conforme mostrado na captura de tela a seguir:
**nota**
É necessário adicionar uma tag. Tags são obrigatórias ao adicionar segredos de terceiros ao AWS Secrets Manager, mesmo que as **Tags** sejam listadas como opcionais.
O campo **Valor** é opcional. Depois de fornecer uma **Chave**, você pode selecionar **Adicionar** para passar para a próxima etapa.
1. Escolha **Próximo** para ir para a página **Configurar alternação**. Configurar uma alternação de segredos é opcional. Se quiser terminar de adicionar seu segredo e não precisar de uma rotação, escolha **Próximo** novamente. Para obter mais informações sobre rotação de segredos, consulte [Rotacionar AWS Secrets Manager segredos](https://docs.aws.amazon.com//secretsmanager/latest/userguide/rotating-secrets.html).
1. Confirme a configuração do seu segredo na página **Revisão**. Quando estiver pronto para adicionar seu segredo, escolha **Loja**.
Para obter mais informações sobre o uso AWS Secrets Manager, consulte a AWS Secrets Manager documentação a seguir:
+ [Crie e gerencie segredos com AWS Secrets Manager](https://docs.aws.amazon.com//secretsmanager/latest/userguide/managing-secrets.html)
+ [O que AWS Secrets Manageré](https://docs.aws.amazon.com//secretsmanager/latest/userguide/intro.html)
+ [Rotacione segredos AWS Secrets Manager](https://docs.aws.amazon.com//secretsmanager/latest/userguide/rotating-secrets.html)
Agora você está pronto para importar seus ativos do Matterport para AWS IoT TwinMaker cenas. Consulte o procedimento na seção a seguir, [Importe espaços do Matterport para cenas AWS IoT TwinMaker](#tm-matterport-integration-tm-console)
## Importe espaços do Matterport para cenas AWS IoT TwinMaker
Adicione digitalizações do Matterport à sua cena selecionando a conta conectada do Matterport na página de configurações de cena. Utilize o procedimento a seguir para importar suas digitalizações e tags do Matterport:
1. Fazer login no [console do AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/).
1. Crie ou abra uma AWS IoT TwinMaker cena existente na qual você deseja usar um espaço Matterport.
1. Depois que a cena for aberta, navegue até a guia **Configurações**.
1. Em **Configurações**, em **Recursos de terceiros**, localize **Nome da conexão** e insira o segredo que você criou no formulário de procedimento do [Armazene suas credenciais da Matterport em AWS Secrets Manager](#tm-matterport-integration-secrets).
.png)
**nota**
Caso seja uma mensagem informando **Conexões indisponíveis**, navegue até a página de configurações do [console do AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/) para iniciar o processo de integração com o Matterport.
1. Em seguida, escolha o espaço Matterport que você gostaria de usar em sua cena selecionando-o no menu suspenso do **espaço Matterport**.
.png)
1. Depois de selecionar um espaço, você pode importar suas tags Matterport e convertê-las em tags de AWS IoT TwinMaker cena pressionando o botão **Importar tags**.
.png)
Depois de importar as tags do Matterport, o botão é substituído pelo botão **Atualizar tags**. Você pode atualizar continuamente suas tags Matterport AWS IoT TwinMaker para que elas sempre reflitam as alterações mais recentes em sua conta Matterport.
.png)
1. Você se integrou AWS IoT TwinMaker com sucesso ao Matterport e agora sua AWS IoT TwinMaker cena tem seu espaço e tags importados do Matterport. Você pode trabalhar nessa cena como faria com qualquer outra AWS IoT TwinMaker cena.
Para obter mais informações sobre como trabalhar com AWS IoT TwinMaker cenas, consulte [Criação e edição de AWS IoT TwinMaker cenas](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/scenes.html).
## Use espaços do Matterport em seu painel do Grafana AWS IoT TwinMaker
Depois de importar seu espaço do Matterport para uma AWS IoT TwinMaker cena, você pode visualizar essa cena com o espaço do Matterport no painel do Grafana. Se você já configurou o Grafana com AWS IoT TwinMaker, basta abrir o painel do Grafana para ver sua cena com o espaço importado do Matterport.
Se você ainda não configurou AWS IoT TwinMaker com o Grafana, conclua primeiro o processo de integração do Grafana. Você tem duas opções ao se integrar ao AWS IoT TwinMaker Grafana. Você pode usar uma instância autogerenciada do Grafana ou usar o Amazon Managed Grafana.
Consulte a documentação a seguir para saber mais sobre as opções e o processo de integração do Grafana:
+ AWS IoT TwinMaker Integração do [painel Grafana](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/grafana-integration.html).
+ [Amazon Managed Grafana](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/amazon-managed-grafana.html).
+ [Grafana autogerenciado](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/self-managed-grafana.html).
## Use espaços Matterport em seu aplicativo web AWS IoT TwinMaker
Depois de importar o espaço do Matterport para uma AWS IoT TwinMaker cena, você pode visualizar essa cena com o espaço do Matterport no AWS IoT aplicativo web do kit de aplicativos.
Consulte a documentação a seguir para saber mais sobre como usar o kit de AWS IoT aplicativos:
+ Para saber mais sobre como usar AWS IoT TwinMaker com o kit de AWS IoT aplicativos, consulte[Crie um aplicativo web personalizado usando componentes de AWS IoT TwinMaker interface do usuário](tm-app-kit.md).
+ Para saber mais sobre como usar o kit de AWS IoT aplicativos, visite a página do [Github do kit de AWS IoT aplicativos](https://github.com/awslabs/iot-app-kit).
+ Para obter instruções sobre como iniciar um novo aplicativo web usando o kit de AWS IoT aplicativos, visite a página oficial de documentação do [IoT App Kit](https://awslabs.github.io/iot-app-kit/?path=/docs/introduction--docs).