本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS IoT TwinMaker Matterport 集成
<a name="tm-matterport-integration"></a>

Matterport 提供多种拍摄选项，用于扫描现实世界环境和创建身临其境的 3D 模型，也称为 Matterport 数字孪生。这些模型被称为 Matterport 空间。 AWS IoT TwinMaker 支持 Matterport 集成，可以将 Matterport 数字孪生导入 AWS IoT TwinMaker 场景。通过将 Matterport 数字双胞胎与 Matterport 配对 AWS IoT TwinMaker，您可以在虚拟环境中可视化和监控您的数字双胞胎系统。

![具有导入的 Matterport 环境的 AWS IoT TwinMaker 场景。](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/tm-mp-industrial-site.png)


有关使用 Matterport 的更多信息，请阅读 [AWS IoT TwinMaker 和 Matterport](https://matterport.com/partners/amazon-web-services) 页面上的 Matterport 文档。

**Topics**
+ [集成概述](#tm-matterport-integration-overview)
+ [Matterport 集成的先决条件](#tm-matterport-integration-prereqs)
+ [生成并记录 Matterport 凭证](#tm-matterport-integration-sdk-key)
+ [将你的 Matterport 凭证存储在 AWS Secrets Manager](#tm-matterport-integration-secrets)
+ [将 Matterport 空间导入场景 AWS IoT TwinMaker](#tm-matterport-integration-tm-console)
+ [在 Gra AWS IoT TwinMaker fana 控制面板中使用 Matterport 空间](#tm-matterport-grafana)
+ [在你 AWS IoT TwinMaker 的 Web 应用程序中使用 Matterport 空格](#tm-matterport-app-kit)

## 集成概述
<a name="tm-matterport-integration-overview"></a>

此集成让您可以执行以下操作：
+ 在 AWS IoT TwinMaker 应用程序套件中使用你的 Matterport 标签和空格。
+ 在 Graf AWS IoT TwinMaker ana 控制面板中查看您导入的 matterport 数据。有关使用 AWS IoT TwinMaker 和 Grafana 的更多信息，请阅读 Grafana 控制面板[集成文档](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/grafana-integration.html)。
+ 将你的 Matterport 空间导入场景中。 AWS IoT TwinMaker 
+ 选择并导入要绑定到场景中数据的 Matterport 标签。 AWS IoT TwinMaker 
+ 在 AWS IoT TwinMaker 场景中自动显示您的 Matterport 空间和标记更改，并批准要同步哪些更改。

集成过程由 3 个关键步骤组成。

1. **[生成并记录 Matterport 凭证](#tm-matterport-integration-sdk-key)**

1. **[将你的 Matterport 凭证存储在 AWS Secrets Manager](#tm-matterport-integration-secrets)**

1. **[将 Matterport 空间导入场景 AWS IoT TwinMaker](#tm-matterport-integration-tm-console)**

可以在 [AWS IoT TwinMaker 控制台](https://console.aws.amazon.com/iottwinmaker/)开始集成。在控制台的**设置**页面的**第三方资源**下，打开 **Matterport 集成**以浏览集成所需的不同资源。

![AWS IoT TwinMaker 控制台设置页面，在 “第三方资源” 选项卡下显示 Matterport 集成页面。](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/Workspace details page.png)


## Matterport 集成的先决条件
<a name="tm-matterport-integration-prereqs"></a>

在与 Matterport 集成 Matterport 之前， AWS IoT TwinMaker 请确保满足以下先决条件：
+ 您已经购买了企业级 [Matterport](https://my.matterport.com/) 账户和集成所需的 Matterport 产品。 AWS IoT TwinMaker 
+ 你有一个 AWS IoT TwinMaker 工作空间。有关更多信息，请参阅[入门 AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs.html)。
+ 您已经更新了 AWS IoT TwinMaker 工作空间角色。有关创建工作区角色的更多信息，请参阅[创建和管理 AWS IoT TwinMaker的服务角色](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs-service-role.html)。

  为工作区角色添加以下内容：

  ```
  {
    "Effect": "Allow",
    "Action": "secretsmanager:GetSecretValue",
    "Resource": [
     "AWS Secrets Manager secret ARN"
    ]
  }
  ```
+ 必须联系 Matterport 以配置启用集成的必要许可。Matterport 还将为集成启用私有模型嵌入 (PME)。

  如果您已经有 Matterport 客户经理，请直接与他们联系。

  如果您没有 Matterport 联系人，请按照以下步骤联系 Matterport 并申请进行集成：

  1. 打开 **[Matterport 和 AWS IoT TwinMaker](https://matterport.com/partners/amazon-web-services)**页面。

  1. 按**联系我们**按钮以打开联系表单。

  1. 在表格上填写所需信息。

  1. 准备就绪后，选择 **SAY HELLO** 将请求发送到 Matterport。

  请求集成后，您可以生成继续集成过程所需的 Matterport SDK 和私有模型嵌入 (PME) 凭证。
**注意**  
这可能会因购买新产品或服务而发生费用。

## 生成并记录 Matterport 凭证
<a name="tm-matterport-integration-sdk-key"></a>

要与 Matterport 集成 AWS IoT TwinMaker，您必须提供 Matterport AWS Secrets Manager 凭证。使用以下程序生成 Matterport SDK 凭证。

1. 登录您的 [Matterport 账户](https://authn.matterport.com)。

1. 导航到您的账户设置页面。

1. 进入设置页面后，选择**开发者工具**选项。

1. 在**开发者工具**页面，前往 **SDK 密钥管理**部分。

1. 进入 **SDK 密钥管理**部分后，选择添加新 SDK 密钥的选项。

1. 获得 Matterport SDK 密钥后，在 Grafana 服务器的 AWS IoT TwinMaker 密钥中添加域名。如果您使用的是 AWS IoT TwinMaker 应用程序套件，请务必同时添加您的自定义域名。

1. 接下来，找到** 应用程序集成管理**部分，您应该会看到**列出的 PME 应用程序**。请注意以下信息：
   + **客户端 ID**
   + **客户端密钥**
**注意**  
由于**客户端密钥**仅提供给您一次，因此我们强烈建议您记下**客户端密钥**。必须在 AWS Secrets Manager 控制台出示**客户端密钥**才能继续进行 Matterport 集成。

   当您购买了必要的组件并且 Matterport 已为您的账户启用了 PME 后，这些凭证就会自动创建。如果这些凭证未出现，请联系 Matterport。要想请求联系，请参阅 **[Matterport 和 AWS IoT TwinMaker](https://matterport.com/partners/amazon-web-services)** 联系表单。

有关 Matterport SDK 凭证的更多信息，请参阅 Matterport 的官方 SDK 文档 [SDK 文档概述](https://matterport.github.io/showcase-sdk/index.html)。

## 将你的 Matterport 凭证存储在 AWS Secrets Manager
<a name="tm-matterport-integration-secrets"></a>

使用以下步骤将您的 Matterport 凭据存储在中。 AWS Secrets Manager

**注意**  
 您需要有根据 [生成并记录 Matterport 凭证](#tm-matterport-integration-sdk-key) 主题中的步骤创建的**客户端密钥**才能继续进行 Matterport 集成。

1. 登录 AWS Secrets Manager 控制台。

1. 导航到**密钥**页面，然后选择**存储新密钥**。

1. 对于**密钥类型**，请选择**其他密钥类型**。

1. 在**键/值对**部分，添加以下键值对，并将 Matterport 凭证作为值：
   + 使用 Key: 和 Value**: `application_key` 创建键****值**对。{{<your Matterport credentials>}}
   + 使用 Key: 和 Value**: `client_id` 创建键****值**对。{{<your Matterport credentials>}}
   + 使用 Key: 和 Value**: `client_secret` 创建键****值**对。{{<your Matterport credentials>}}

   完成后，您应当会有似类于以下示例的配置：  
![列出集成过程中使用的 Matterport 凭证的必要键值对。](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/tm-mp-key-value-step.png)

1. 对于**加密键**，仍选择默认的加密键 `aws/secretsmanager`。

1. 选择**下一步**转至**配置密钥**页面。

1. 填写**密钥名称**和**描述**字段。

1. 在**标签**部分为该密钥添加一个标签。

   创建标签时，按以下屏幕截图`AWSIoTTwinMaker_Matterport`所示分配密钥：  
![输入标签密钥的 “配置密钥” 控制台页面。](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/tm-mp-tag-step.png)
**注意**  
必须添加一个标签。尽管**标签**被列为可选，但向 AWS Secrets Manager添加第三方密钥时仍需要标签。

   **值**字段为可选项。提供一个**键**后，您可以选择**添加**继续下一步。

1. 在**配置旋转**页面，选择 **Next**（下一步）。设置密钥轮换为可选操作。如果您希望完成密钥的添加且不需要轮换，请再次选择 **Next**（下一步）。有关密钥轮换的更多信息，请参阅[轮换 AWS Secrets Manager 密钥](https://docs.aws.amazon.com//secretsmanager/latest/userguide/rotating-secrets.html)。

1. 在**查看**页面上确认密钥配置。准备好添加密钥后，请选择**存储**。

有关使用的更多信息 AWS Secrets Manager，请参阅以下 AWS Secrets Manager 文档：
+ [使用创建和管理密钥 AWS Secrets Manager](https://docs.aws.amazon.com//secretsmanager/latest/userguide/managing-secrets.html)
+ [什么是 AWS Secrets Manager？](https://docs.aws.amazon.com//secretsmanager/latest/userguide/intro.html)
+ [轮换 AWS Secrets Manager 秘密](https://docs.aws.amazon.com//secretsmanager/latest/userguide/rotating-secrets.html)

现在，您可以将 AWS IoT TwinMaker Matterport 资源导入场景了。请参阅下一节中的步骤，[将 Matterport 空间导入场景 AWS IoT TwinMaker](#tm-matterport-integration-tm-console)

## 将 Matterport 空间导入场景 AWS IoT TwinMaker
<a name="tm-matterport-integration-tm-console"></a>

从场景设置页面中选择关联的 Matterport 账户，将 Matterport 扫描添加到场景中。使用以下步骤导入 Matterport 扫描和标签：

1. 登录 [AWS IoT TwinMaker 控制台](https://console.aws.amazon.com/iottwinmaker/)。

1. 创建或打开要在其中使用 Matterport 空间的现有 AWS IoT TwinMaker 场景。

1. 场景打开后，导航到**设置**选项卡。

1. 在**设置**的**第三方资源**下，找到**连接名称**，然后输入在以下过程中从 [将你的 Matterport 凭证存储在 AWS Secrets Manager](#tm-matterport-integration-secrets) 创建的密钥。  
![将 Matterport SDK 凭据存储为机密后显示的设置选项卡内容。](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/Project nav(1).png)
**注意**  
如果看到一条显示**无连接**的消息，请导航到 [AWS IoT TwinMaker 控制台](https://console.aws.amazon.com/iottwinmaker/)设置页面，以开始 Matterport 集成的过程。  
![带有 “无连接” 消息的设置选项卡。](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/Project nav.png)

1. 接下来，在 **Matterport 空间**下拉列表中选择要在场景中使用的 Matterport 空间。  
![显示了 Matterport 空间下拉列表的设置选项卡。](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/Project nav(2).png)

1. 选择空间后，您可以导入 Matterport 标签并将其转换为 AWS IoT TwinMaker 场景标签，方法是按下**导入标签按钮**。  
![显示带有导入标签按钮的设置选项卡。](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/Project nav(3).png)

   导入 Matterport 标签后，该按钮将被**更新标签**按钮所取代。您可以不断更新您的 Matterport 标签， AWS IoT TwinMaker 以便它们始终反映您的 Matterport 账户中的最新更改。  
![显示带有更新标签按钮的设置选项卡。](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/Project nav(4).png)

1. 你已经成功 AWS IoT TwinMaker 与 Matterport 集成，现在你的 AWS IoT TwinMaker 场景既有导入的 Matterport 空间又有标签。你可以像处理任何其他场景一样在这个 AWS IoT TwinMaker 场景中工作。

有关使用 AWS IoT TwinMaker 场景的更多信息，请参阅[创建和编辑 AWS IoT TwinMaker 场景](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/scenes.html)。

## 在 Gra AWS IoT TwinMaker fana 控制面板中使用 Matterport 空间
<a name="tm-matterport-grafana"></a>

将 Matterport 空间导入 AWS IoT TwinMaker 场景后，你可以使用 Grafana 仪表板中的 Matterport 空间查看该场景。如果你已经为 Grafana 配置了，那么你只需打开 Grafana 仪表板，即可 AWS IoT TwinMaker使用导入的 Matterport 空间查看场景。

如果您尚未 AWS IoT TwinMaker 使用 Grafana 进行配置，请先完成 Grafana 集成流程。在 AWS IoT TwinMaker 与 Grafana 集成时，你有两种选择。您可以使用自行管理的 Grafana 实例，也可以使用 Amazon Managed Grafana。

如需详细了解 Grafana 选项和集成过程，请参阅以下文档：
+ [AWS IoT TwinMaker 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](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/self-managed-grafana.html)。

## 在你 AWS IoT TwinMaker 的 Web 应用程序中使用 Matterport 空格
<a name="tm-matterport-app-kit"></a>

将 Matterport 空间导入 AWS IoT TwinMaker 场景后，即可在应用程序套件 Web AWS IoT 应用程序中使用 Matterport 空间查看该场景。

要了解有关使用该 AWS IoT 应用套件的更多信息，请参阅以下文档：
+ 要了解有关与 AWS IoT 应用套件 AWS IoT TwinMaker 配合使用的更多信息，请参阅[使用 AWS IoT TwinMaker 用户界面组件创建自定义 Web 应用程序](tm-app-kit.md)。
+ 要了解有关使用 AWS IoT 应用程序套件的更多信息，请访问[AWS IoT 应用程序套件 Github](https://github.com/awslabs/iot-app-kit) 页面。
+ 有关如何使用 AWS IoT 应用套件启动新 Web 应用程序的说明，请访问官方 [IoT App Kit](https://awslabs.github.io/iot-app-kit/?path=/docs/introduction--docs) 文档页面。