Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# AWS IoT TwinMaker Integrasi Matterport
Matterport menyediakan berbagai opsi pengambilan untuk memindai lingkungan dunia nyata dan membuat model 3D imersif, juga dikenal sebagai kembar digital Matterport. Model-model ini disebut ruang Matterport. AWS IoT TwinMaker mendukung integrasi Matterport, memungkinkan Anda untuk mengimpor kembar digital Matterport Anda ke dalam adegan Anda. AWS IoT TwinMaker Dengan memasangkan kembar digital Matterport dengan AWS IoT TwinMaker, Anda dapat memvisualisasikan dan memantau sistem kembar digital Anda di lingkungan virtual.
![\[AWS IoT TwinMaker Adegan dengan lingkungan Matterport yang diimpor.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/tm-mp-industrial-site.png)
[Untuk informasi lebih lanjut tentang penggunaan Matterport, baca dokumentasi Matterport dan halaman AWS IoT TwinMaker Matterport.](https://matterport.com/partners/amazon-web-services)
**Topics**
+ [Ikhtisar integrasi](#tm-matterport-integration-overview)
+ [Prasyarat integrasi Matterport](#tm-matterport-integration-prereqs)
+ [Hasilkan dan catat kredensi Matterport Anda](#tm-matterport-integration-sdk-key)
+ [Simpan kredensi Matterport Anda di AWS Secrets Manager](#tm-matterport-integration-secrets)
+ [Impor ruang Matterport ke dalam adegan AWS IoT TwinMaker](#tm-matterport-integration-tm-console)
+ [Gunakan spasi Matterport di dasbor AWS IoT TwinMaker Grafana Anda](#tm-matterport-grafana)
+ [Gunakan spasi Matterport di aplikasi web Anda AWS IoT TwinMaker](#tm-matterport-app-kit)
## Ikhtisar integrasi
Integrasi ini memungkinkan Anda untuk melakukan hal berikut:
+ Gunakan tag dan spasi Matterport Anda di AWS IoT TwinMaker app kit.
+ Lihat data matterport yang Anda impor di dasbor Grafana AWS IoT TwinMaker Anda. Untuk informasi lebih lanjut tentang penggunaan AWS IoT TwinMaker dan Grafana, baca dokumentasi integrasi dasbor [Grafana](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/grafana-integration.html).
+ Impor ruang Matterport Anda ke dalam adegan Anda AWS IoT TwinMaker .
+ Pilih dan impor tag Matterport yang ingin Anda ikat ke data di adegan Anda. AWS IoT TwinMaker
+ Secara otomatis memunculkan ruang Matterport Anda dan menandai perubahan dalam AWS IoT TwinMaker adegan Anda dan menyetujui mana yang akan disinkronkan.
Proses integrasi terdiri dari 3 langkah penting.
1. **[Hasilkan dan catat kredensi Matterport Anda](#tm-matterport-integration-sdk-key)**
1. **[Simpan kredensi Matterport Anda di AWS Secrets Manager](#tm-matterport-integration-secrets)**
1. **[Impor ruang Matterport ke dalam adegan AWS IoT TwinMaker](#tm-matterport-integration-tm-console)**
Anda memulai integrasi Anda di [AWS IoT TwinMaker konsol](https://console.aws.amazon.com/iottwinmaker/). Di halaman **Pengaturan** konsol, di bawah **sumber daya pihak ke-3**, buka **integrasi Matterport** untuk menavigasi antara berbagai sumber daya yang diperlukan untuk integrasi.
![\[Halaman Pengaturan AWS IoT TwinMaker konsol, menampilkan halaman integrasi Matterport di bawah tab sumber daya pihak ke-3.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/Workspace details page.png)
## Prasyarat integrasi Matterport
Sebelum mengintegrasikan Matterport dengan AWS IoT TwinMaker pastikan Anda memenuhi prasyarat berikut:
+ Anda telah membeli akun Matterport tingkat Perusahaan dan [produk Matterport](https://my.matterport.com/) yang diperlukan untuk integrasi. AWS IoT TwinMaker
+ Anda memiliki AWS IoT TwinMaker ruang kerja. Untuk informasi selengkapnya, lihat [Memulai dengan AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs.html).
+ Anda telah memperbarui peran AWS IoT TwinMaker ruang kerja Anda. Untuk informasi selengkapnya tentang membuat peran ruang kerja, lihat [Membuat dan mengelola peran layanan](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs-service-role.html). AWS IoT TwinMaker
Tambahkan yang berikut ini ke peran ruang kerja Anda:
```
{
"Effect": "Allow",
"Action": "secretsmanager:GetSecretValue",
"Resource": [
"AWS Secrets Manager secret ARN"
]
}
```
+ Anda harus menghubungi Matterport untuk mengonfigurasi lisensi yang diperlukan untuk mengaktifkan integrasi. Matterport juga akan mengaktifkan Private Model Embed (PME) untuk integrasi.
Jika Anda sudah memiliki manajer akun Matterport, hubungi mereka secara langsung.
Gunakan prosedur berikut untuk menghubungi Matterport dan meminta integrasi jika Anda tidak memiliki titik kontak Matterport:
1. Buka **[Matterport dan AWS IoT TwinMaker halaman](https://matterport.com/partners/amazon-web-services)**.
1. Tekan tombol **Hubungi kami**, untuk membuka formulir kontak.
1. Isi informasi yang diperlukan pada formulir.
1. Saat Anda siap, pilih **SAY HELLO** untuk mengirim permintaan Anda ke Matterport.
Setelah Anda meminta integrasi, Anda dapat menghasilkan kredenal Matterport SDK dan Private Model Embed (PME) yang diperlukan untuk melanjutkan proses integrasi.
**catatan**
Ini mungkin melibatkan Anda dikenakan biaya untuk membeli produk atau layanan baru.
## Hasilkan dan catat kredensi Matterport Anda
Untuk mengintegrasikan Matterport dengan AWS IoT TwinMaker, Anda harus memberikan kredensi AWS Secrets Manager Matterport. Gunakan prosedur berikut untuk menghasilkan kredenal Matterport SDK.
1. Masuk ke akun [Matterport](https://authn.matterport.com) Anda.
1. Arahkan ke halaman pengaturan akun Anda.
1. Setelah di halaman pengaturan, pilih opsi **Alat pengembang**.
1. Pada halaman **Alat pengembang**, buka bagian **Manajemen Kunci SDK**.
1. Setelah berada di bagian **Manajemen Kunci SDK**, pilih opsi untuk menambahkan kunci SDK baru.
1. Setelah Anda memiliki kunci Matterport SDK, tambahkan domain ke kunci untuk dan server Grafana AWS IoT TwinMaker Anda. Jika Anda menggunakan kit AWS IoT TwinMaker aplikasi, pastikan untuk menambahkan domain khusus Anda juga.
1. Selanjutnya, temukan bagian **Manajemen Integrasi Aplikasi**, Anda akan melihat **aplikasi PME Anda terdaftar**. Catat informasi berikut:
+ **ID Klien**
+ **Rahasia Klien**
**catatan**
Karena **Rahasia Klien** hanya disajikan kepada Anda sekali, kami sangat menyarankan agar Anda mencatat **Rahasia Klien** Anda. Anda harus menunjukkan **Rahasia Klien** Anda di AWS Secrets Manager konsol untuk melanjutkan integrasi Matterport.
Kredensi ini secara otomatis dibuat ketika Anda telah membeli komponen yang diperlukan dan PME untuk akun Anda telah diaktifkan oleh Matterport. Jika kredensi ini tidak muncul, hubungi Matterport. Untuk meminta kontak, lihat **[Matterport dan formulir AWS IoT TwinMaker](https://matterport.com/partners/amazon-web-services)** kontak.
[Untuk informasi selengkapnya tentang kredenal Matterport SDK, lihat Ikhtisar Dokumen SDK dokumentasi SDK resmi Matterport.](https://matterport.github.io/showcase-sdk/index.html)
## Simpan kredensi Matterport Anda di AWS Secrets Manager
Gunakan prosedur berikut untuk menyimpan kredenal Matterport Anda di. AWS Secrets Manager
**catatan**
Anda memerlukan **Rahasia Klien** yang dibuat dari prosedur dalam [Hasilkan dan catat kredensi Matterport Anda](#tm-matterport-integration-sdk-key) topik untuk melanjutkan integrasi Matterport.
1. Masuk ke AWS Secrets Manager konsol.
1. Arahkan ke halaman **Rahasia** dan pilih **Simpan rahasia baru**.
1. Untuk **tipe Rahasia**, pilih **Jenis rahasia lainnya**.
1. Di bagian **pasangan kunci/nilai, tambahkan pasangan** kunci-nilai berikut, dengan kredenal Matterport Anda sebagai nilainya:
+ Buat pasangan kunci-nilai, dengan **Key:**`application_key`, dan **Value**:. **
+ Buat pasangan kunci-nilai, dengan **Key:**`client_id`, dan **Value**:. **
+ Buat pasangan kunci-nilai, dengan **Key:**`client_secret`, dan **Value**:. **
Setelah selesai, Anda harus memiliki konfigurasi yang mirip dengan contoh berikut:
![\[Pasangan kunci-nilai yang diperlukan yang mencantumkan kredenal Matterport yang digunakan dalam proses integrasi.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/tm-mp-key-value-step.png)
1. Untuk **kunci Enkripsi**, Anda dapat membiarkan kunci enkripsi default `aws/secretsmanager` dipilih.
1. Pilih **Berikutnya** untuk melanjutkan ke halaman **Konfigurasi rahasia**.
1. Isi kolom untuk **nama Rahasia** dan **Deskripsi**.
1. Tambahkan tag ke rahasia ini di bagian **Tag**.
Saat membuat tag, tetapkan kunci `AWSIoTTwinMaker_Matterport` seperti yang ditunjukkan pada gambar berikut:
![\[Halaman Konfigurasi konsol rahasia dengan tombol Tag dimasukkan.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/tm-mp-tag-step.png)
**catatan**
Anda harus menambahkan tag. Tag diperlukan saat menambahkan rahasia pihak ke-3 ke dalam AWS Secrets Manager, meskipun **Tag** terdaftar sebagai opsional.
Bidang **Nilai** adalah opsional. Setelah Anda memberikan **Kunci**, Anda dapat memilih **Tambah** untuk melanjutkan ke langkah berikutnya.
1. Pilih **Berikutnya** untuk melanjutkan ke halaman **Konfigurasi rotasi**. Menyiapkan rotasi rahasia adalah opsional. Jika Anda ingin menyelesaikan menambahkan rahasia Anda dan tidak perlu rotasi, pilih **Berikutnya** lagi. Untuk informasi selengkapnya tentang rotasi rahasia, lihat [Memutar AWS Secrets Manager rahasia](https://docs.aws.amazon.com//secretsmanager/latest/userguide/rotating-secrets.html).
1. Konfirmasikan konfigurasi rahasia Anda di halaman **Tinjauan**. Setelah Anda siap untuk menambahkan rahasia Anda, pilih **Store**.
Untuk informasi selengkapnya tentang penggunaan AWS Secrets Manager, lihat AWS Secrets Manager dokumentasi berikut:
+ [Buat dan kelola rahasia dengan AWS Secrets Manager](https://docs.aws.amazon.com//secretsmanager/latest/userguide/managing-secrets.html)
+ [Apa itu AWS Secrets Manager?](https://docs.aws.amazon.com//secretsmanager/latest/userguide/intro.html)
+ [Putar AWS Secrets Manager rahasia](https://docs.aws.amazon.com//secretsmanager/latest/userguide/rotating-secrets.html)
Sekarang Anda siap untuk mengimpor aset Matterport Anda ke dalam AWS IoT TwinMaker adegan. Lihat prosedur di bagian berikut, [Impor ruang Matterport ke dalam adegan AWS IoT TwinMaker](#tm-matterport-integration-tm-console)
## Impor ruang Matterport ke dalam adegan AWS IoT TwinMaker
Tambahkan pemindaian Matterport ke adegan Anda dengan memilih akun Matterport yang terhubung dari dalam halaman pengaturan adegan. Gunakan prosedur berikut untuk mengimpor pemindaian dan tag Matterport Anda:
1. Masuk ke [AWS IoT TwinMaker konsol](https://console.aws.amazon.com/iottwinmaker/).
1. Buat atau buka AWS IoT TwinMaker adegan yang ada di mana Anda ingin menggunakan ruang Matterport.
1. Setelah adegan terbuka, navigasikan ke tab **Pengaturan**.
1. Di **Pengaturan**, di bawah **sumber daya pihak ke-3**, temukan **nama Koneksi** dan masukkan rahasia yang Anda buat dalam prosedur dari[Simpan kredensi Matterport Anda di AWS Secrets Manager](#tm-matterport-integration-secrets).
![\[Isi tab pengaturan setelah menyimpan kredenal Matterport SDK sebagai rahasia.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/Project nav(1).png)
**catatan**
Jika Anda melihat pesan yang menyatakan **Tidak ada koneksi**, navigasikan ke halaman pengaturan [AWS IoT TwinMaker konsol](https://console.aws.amazon.com/iottwinmaker/) untuk memulai proses integrasi Matterport.
![\[Tab pengaturan dengan pesan “Tidak ada koneksi”.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/Project nav.png)
1. Selanjutnya, pilih ruang Matterport yang ingin Anda gunakan dalam adegan Anda dengan memilihnya di drop-down ruang **Matterport**.
![\[Tab pengaturan dengan tarik-turun ruang Matterport ditampilkan.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/Project nav(2).png)
1. Setelah memilih spasi, Anda dapat mengimpor tag Matterport Anda dan mengubahnya menjadi tag AWS IoT TwinMaker adegan dengan menekan tombol **Impor tag**.
![\[Tab pengaturan dengan tombol Impor tag ditampilkan.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/Project nav(3).png)
Setelah Anda mengimpor tag Matterport, tombol diganti dengan tombol **Perbarui tag**. Anda dapat terus memperbarui tag Matterport Anda AWS IoT TwinMaker sehingga selalu mencerminkan perubahan terbaru di akun Matterport Anda.
![\[Tab pengaturan dengan tombol Perbarui tag ditampilkan.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/Project nav(4).png)
1. Anda telah berhasil terintegrasi AWS IoT TwinMaker dengan Matterport, dan sekarang AWS IoT TwinMaker adegan Anda memiliki ruang dan tag Matterport yang diimpor. Anda dapat bekerja dalam adegan ini seperti yang Anda lakukan dengan AWS IoT TwinMaker adegan lainnya.
Untuk informasi selengkapnya tentang bekerja dengan AWS IoT TwinMaker adegan, lihat [Membuat dan mengedit AWS IoT TwinMaker adegan](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/scenes.html).
## Gunakan spasi Matterport di dasbor AWS IoT TwinMaker Grafana Anda
Setelah Anda mengimpor ruang Matterport Anda ke dalam sebuah AWS IoT TwinMaker adegan, Anda dapat melihat pemandangan itu dengan ruang Matterport di dasbor Grafana Anda. Jika Anda telah mengonfigurasi Grafana dengan AWS IoT TwinMaker, maka Anda cukup membuka dasbor Grafana untuk melihat pemandangan Anda dengan ruang Matterport yang diimpor.
Jika Anda belum mengonfigurasi AWS IoT TwinMaker dengan Grafana, selesaikan proses integrasi Grafana terlebih dahulu. Anda memiliki dua pilihan saat berintegrasi AWS IoT TwinMaker dengan Grafana. Anda dapat menggunakan instans Grafana yang dikelola sendiri atau Anda dapat menggunakan Grafana Terkelola Amazon.
Lihat dokumentasi berikut untuk mempelajari lebih lanjut tentang opsi Grafana dan proses integrasi:
+ [AWS IoT TwinMaker Integrasi dasbor Grafana](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/grafana-integration.html).
+ [Grafana yang Dikelola Amazon](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/amazon-managed-grafana.html).
+ [Grafana yang dikelola sendiri](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/self-managed-grafana.html).
## Gunakan spasi Matterport di aplikasi web Anda AWS IoT TwinMaker
Setelah mengimpor ruang Matterport ke dalam sebuah AWS IoT TwinMaker adegan, Anda dapat melihat adegan itu dengan ruang Matterport di aplikasi web kit AWS IoT aplikasi Anda.
Lihat dokumentasi berikut untuk mempelajari lebih lanjut tentang penggunaan kit AWS IoT aplikasi:
+ Untuk mempelajari lebih lanjut tentang menggunakan AWS IoT TwinMaker kit AWS IoT aplikasi, lihat[Buat aplikasi web yang disesuaikan menggunakan Komponen AWS IoT TwinMaker UI](tm-app-kit.md).
+ Untuk mempelajari lebih lanjut tentang menggunakan kit AWS IoT aplikasi, silakan kunjungi halaman [AWS IoT Application kit Github](https://github.com/awslabs/iot-app-kit).
+ Untuk petunjuk tentang cara memulai aplikasi web baru menggunakan kit AWS IoT aplikasi, silakan kunjungi halaman dokumentasi [Kit Aplikasi IoT](https://awslabs.github.io/iot-app-kit/?path=/docs/introduction--docs) resmi.