AWS IoT TwinMaker 매터포트 통합 - AWS IoT TwinMaker
통합 개요Matterport 통합 사전 요구 사항Matterport SDK 보안 인증 정보Matterport 자격 증명을 다음 위치에 저장하십시오. AWS Secrets ManagerMatterport, 장면 내 스캔 AWS IoT TwinMaker AWS IoT TwinMaker Grafana 대시보드의 매터포트앱 키트와 Matterport 통합 AWS IoT

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS IoT TwinMaker 매터포트 통합

Matterport는 실제 환경을 스캔하고 Matterport 디지털 트윈이라고도 하는 몰입형 3D 모델을 만들 수 있는 다양한 캡처 옵션을 제공합니다. 이러한 모델을 Matterport 스페이스라고 합니다. AWS IoT TwinMaker Matterport 통합을 지원하므로 Matterport 디지털 트윈을 AWS IoT TwinMaker 장면으로 가져올 수 있습니다. Matterport 디지털 트윈을 페어링하면 AWS IoT TwinMaker가상 환경에서 디지털 트윈 시스템을 시각화하고 모니터링할 수 있습니다.

가져온 AWS IoT TwinMaker Matterport 환경이 있는 장면.

Matterport 사용에 대한 자세한 내용은 Matterport의 문서AWS IoT TwinMaker 및 Matterport 페이지를 참조하십시오.

통합 개요

이 통합 기능을 사용하여 다음을 수행할 수 있습니다.

  • 앱 키트에 있는 Matterport 태그와 스페이스를 사용하세요. AWS IoT TwinMaker

  • 가져온 매터포트 데이터를 AWS IoT TwinMaker Grafana 대시보드에서 확인할 수 있습니다. Grafana 사용에 AWS IoT TwinMaker 대한 자세한 내용은 Grafana 대시보드 통합 설명서를 참조하십시오.

  • Matterport 공간을 씬으로 가져오세요. AWS IoT TwinMaker

  • 씬의 데이터에 바인딩하려는 Matterport 태그를 선택하고 가져오세요. AWS IoT TwinMaker

  • AWS IoT TwinMaker 씬에서 Matterport 공간과 태그 변경 사항을 자동으로 표시하고 동기화할 항목을 승인합니다.

통합 프로세스는 3개의 중요한 단계로 구성되어 있습니다.

  1. Matterport 보안 인증을 생성하고 기록하십시오.

  2. Matterport 자격 증명을 다음 위치에 저장하십시오. AWS Secrets Manager

  3. Matterport 공간을 씬으로 임포트할 수 있습니다. AWS IoT TwinMaker

AWS IoT TwinMaker 콘솔에서 통합을 시작합니다. 콘솔의 설정 페이지에서 타사 리소스 아래에서 Matterport 통합을 열어 통합에 필요한 다양한 리소스 사이를 탐색할 수 있습니다.

AWS IoT TwinMaker 콘솔 설정 페이지, 타사 리소스 탭 아래에 Matterport 통합 페이지가 표시됩니다.

Matterport 통합 사전 요구 사항

Matterport를 통합하기 전에 AWS IoT TwinMaker 다음 사전 요구 사항을 충족하는지 확인하십시오.

  • 엔터프라이즈급 Matterport 계정과 통합에 필요한 Matterport 제품을 구매했습니다. AWS IoT TwinMaker

  • 작업 공간이 있습니다. AWS IoT TwinMaker 자세한 내용은 시작하기를 참조하십시오 AWS IoT TwinMaker.

  • AWS IoT TwinMaker 작업 영역 역할을 업데이트했습니다. 작업 영역 역할을 만드는 방법에 대한 자세한 내용은 AWS IoT TwinMaker을(를) 위한 서비스 역할 만들기 및 관리를 참조하십시오.

    다음을 작업 영역 역할에 추가합니다.

    {
  "Effect": "Allow",
  "Action": "secretsmanager:GetSecretValue",
  "Resource": [
   "AWS Secrets Manager secret ARN"
  ]
}

  • 통합을 활성화하는 데 필요한 라이선스를 구성하려면 Matterport에 문의해야 합니다. 또한 Matterport는 통합을 위한 Private Model Embed (PME)를 활성화합니다.

    이미 Matterport 계정 관리자가 있다면 직접 문의하십시오.

    Matterport 연락처가 없는 경우 다음 절차를 사용하여 Matterport에 연락하고 통합을 요청하십시오.

    1. Matterport 및 AWS IoT TwinMaker 페이지를 엽니다.

    2. 문의하기 버튼을 눌러 연락처양식을 엽니다.

    3. 양식에 필수 정보를 입력합니다.

    4. 준비가 되면 SAY HELLO를 선택하여 Matterport에 요청을 보내십시오.

    통합을 요청하면 통합 프로세스를 계속하는 데 필요한 Matterport SDK 및 Private Model Embed(PME) 보안 인증을 생성할 수 있습니다.

    참고

    이로 인해 신제품 또는 서비스 구매 수수료가 발생할 수 있습니다.

Matterport 보안 인증을 생성하고 기록하십시오.

Matterport를 통합하려면 Matterport 자격 증명을 제공해야 AWS Secrets Manager 합니다. AWS IoT TwinMaker다음 절차를 사용하여 Matterport SDK 보안 인증을 생성하십시오.

  1. Matterport 계정에 로그인하십시오.

  2. 계정 설정 페이지로 이동합니다.

  3. 설정 페이지에서 개발자 도구 옵션을 선택합니다.

  4. 개발자 도구 페이지에서 SDK 키 관리 섹션으로 이동합니다.

  5. SDK 키 관리 섹션에서 새 SDK 키를추가하는 옵션을 선택합니다.

  6. Matterport SDK 키가 있으면 해당 키와 Grafana 서버에 도메인을 AWS IoT TwinMaker 추가하세요. AWS IoT TwinMaker 앱 키트를 사용하는 경우 사용자 지정 도메인도 추가해야 합니다.

  7. 다음으로 애플리케이션 통합 관리 섹션을 찾으면 PME 애플리케이션이 나열된 것을 확인할 수 있습니다. 다음의 정보를 기록합니다.

    • 클라이언트 ID

    • 클라이언트 비밀

    참고

    클라이언트 비밀은 한 번만 제공되므로 클라이언트 비밀을 기록해 두는 것이 좋습니다. Matterport 통합을 계속하려면 AWS Secrets Manager 콘솔에 클라이언트 비밀을 제시해야 합니다.

    이러한 보안 인증 정보는 필요한 구성 요소를 구매하고 Matterport에서 계정의 PME를 활성화하면 자동으로 생성됩니다. 이러한 보안 인증 정보가 나타나지 않으면 Matterport에 문의하십시오. 연락을 요청하려면 Matterport 및 AWS IoT TwinMaker연락처 양식을 참조하십시오.

Matterport SDK 보안 인증에 대한 자세한 내용은 Matterport의 공식 SDK 문서 SDK 문서 개요를 참조하십시오.

Matterport 자격 증명을 다음 위치에 저장하십시오. AWS Secrets Manager

다음 절차를 사용하여 Matterport 자격 증명을 저장하십시오. AWS Secrets Manager

참고

Matterport 통합을 계속하려면 Matterport 보안 인증을 생성하고 기록하십시오. 주제의 프로시저에서 생성한 클라이언트 시크릿이 필요합니다.

  1. 콘솔에 로그인합니다. AWS Secrets Manager

  2. 시크릿 페이지로 이동한 다음 새 비밀 저장을 선택합니다.

  3. 비밀 유형에서 다른 유형의 암호를 선택합니다.

  4. 키/값 쌍 섹션에서 Matterport 보안 인증을 값으로 사용하여 다음 키-값 쌍을 추가하십시오.

    • Key: application_key 및 Value:<your Matterport credentials>을(를) 사용하여 키-값 쌍을 생성합니다.

    • Key: client_id 및 Value:<your Matterport credentials>을(를) 사용하여 키-값 쌍을 생성합니다.

    • Key: client_secret 및 Value:<your Matterport credentials>을(를) 사용하여 키-값 쌍을 생성합니다.

    구성이 완료되면 다음 예와 비슷한 구성이 나타나는 것을 가질 수 있습니다.

    통합 프로세스에 사용된 Matterport 보안 인증을 나열하는 필수 키-값 쌍.

  5. 암호 키의 경우, 기본 암호 키aws/secretsmanager가 선택된 상태로 놔둘 수 있습니다.

  6. 다음을 선택하여 비밀 구성 페이지로 이동합니다.

  7. 비밀 이름 및 설명 필드를 입력합니다.

  8. 태그 섹션에서 이 비밀에 태그를 추가하십시오.

    태그를 생성할 때 다음 스크린샷과 AWSIoTTwinMaker_Matterport 같이 키를 할당합니다.

    태그 키가 입력된 보안 구성 콘솔 페이지
    참고

    태그를 추가해야 합니다. 태그가 선택 사항으로 나열되어 있더라도 타사 비밀을 AWS Secrets Manager로 추가할 때, 태그가 필요합니다.

    값 필드는 선택 사항입니다. 일단 키를 제공한 후에는 추가를 선택하여 다음 단계로 넘어갈 수 있습니다.

  9. 다음을 선택하여 로테이션 구성페이지로 이동합니다. 비밀 로테이션 설정은 선택 사항입니다. 비밀 추가를 완료하고 로테이션이 필요하지 않은 경우, 다음을 다시 선택합니다. 암호 교체에 대한 자세한 내용은 암호 교체를 AWS Secrets Manager 참조하십시오.

  10. 검토 페이지에서 비밀 구성을 확인하십시오. 비밀을 추가할 준비가 되면 스토어를 선택하십시오.

사용에 AWS Secrets Manager대한 자세한 내용은 다음 AWS Secrets Manager 문서를 참조하십시오.

이제 Matterport 에셋을 씬으로 가져올 준비가 되었습니다. AWS IoT TwinMaker 다음 섹션 Matterport 공간을 씬으로 임포트할 수 있습니다. AWS IoT TwinMaker의 절차를 참조하십시오.

Matterport 공간을 씬으로 임포트할 수 있습니다. AWS IoT TwinMaker

장면 설정 페이지 내에서 연결된 Matterport 계정을 선택하여 장면에 Matterport 스캔을 추가하십시오. Matterport 스캔 및 태그를 가져오려면 다음 절차를 따르십시오.

  1. AWS IoT TwinMaker 콘솔에 로그인합니다.

  2. Matterport 공간을 사용하려는 기존 AWS IoT TwinMaker 씬을 만들거나 여십시오.

  3. 장면이 열리면 설정 탭으로 이동합니다.

  4. 설정에서 타사 리소스에서 연결 이름을 찾아서, Matterport 자격 증명을 다음 위치에 저장하십시오. AWS Secrets Manager의 절차에서 생성한 비밀을 입력합니다.

    Matterport SDK 자격 증명을 비밀로 저장한 후의 설정 탭 내용입니다.
    참고

    연결 없음이라는 메시지가 표시되면 AWS IoT TwinMaker 콘솔 설정 페이지로 이동하여 Matterport 통합 프로세스를 시작하십시요.

    설정 탭에 “연결 없음” 메시지가 표시됩니다.

  5. 다음으로, Matterport 스페이스 드롭다운에서 해당 공간을 선택하여 장면에서 사용하려는 Matterport 스페이스를 선택합니다.

    Matterport 공간 드롭다운이 있는 설정 탭이 표시됩니다.

  6. 공간을 선택한 후, Matterport 태그를 가져오고 태그 가져오기 버튼을 눌러 AWS IoT TwinMaker 장면 태그로 변환할 수 있습니다.

    태그 가져오기 버튼이 있는 설정 탭이 표시됩니다.

    Matterport 태그를 가져오면 버튼이 태그 업데이트 버튼으로 대체됩니다. Matterport 태그가 항상 Matterport 계정의 최신 변경 사항을 반영하도록 Matterport 태그를 계속 업데이트할 수 있습니다. AWS IoT TwinMaker

    설정 탭에 태그 업데이트 버튼이 표시됩니다.

  7. AWS IoT TwinMaker Matterport와 성공적으로 통합되었으며 이제 AWS IoT TwinMaker 씬에 가져온 Matterport 공간과 태그가 모두 생겼습니다. 다른 씬과 마찬가지로 이 씬 안에서도 작업할 수 있습니다. AWS IoT TwinMaker

AWS IoT TwinMaker 씬 작업에 대한 자세한 내용은 씬 생성 및 편집을 AWS IoT TwinMaker 참조하십시오.

AWS IoT TwinMaker Grafana 대시보드에서 Matterport 스페이스를 사용하세요

Matterport 공간을 AWS IoT TwinMaker 씬으로 가져온 후에는 Grafana 대시보드의 Matterport 공간에서 해당 장면을 볼 수 있습니다. 이미 Grafana를 구성했다면 Grafana 대시보드를 열기만 하면 가져온 Matterport 공간이 AWS IoT TwinMaker있는 장면을 볼 수 있습니다.

아직 AWS IoT TwinMaker Grafana로 구성하지 않았다면 먼저 Grafana 통합 프로세스를 완료하세요. AWS IoT TwinMaker Grafana와 통합할 때는 두 가지 선택이 있습니다. 자체 관리형 Grafana 인스턴스를 사용하거나 Amazon Managed Grafana를 사용할 수 있습니다.

Grafana 옵션 및 통합 프로세스에 대해 자세히 알아보려면 다음 설명서를 참조하십시오.

웹 애플리케이션에서 Matterport 스페이스를 사용하세요. AWS IoT TwinMaker

Matterport 공간을 AWS IoT TwinMaker 장면으로 가져온 후에는 앱 키트 웹 애플리케이션의 Matterport 공간을 사용하여 해당 장면을 볼 수 있습니다. AWS IoT

애플리케이션 키트 사용에 대한 자세한 내용은 다음 문서를 참조하십시오. AWS IoT