Menambahkan pin ke model 3D di Power Apps

Tambahkan pin (ditampilkan sebagai penanda melingkar) ke model 3D di aplikasi kanvas Anda. Pengguna dapat menambahkan pin mereka sendiri dan melihat informasi tentang pin yang mereka pilih.

Menambahkan pin yang telah ditentukan ke model 3D dari buku kerja Excel

Cara termudah untuk menambahkan pin ke model 3D adalah dengan memuatnya dari buku kerja Excel.

Sumber data untuk pin harus berupa tabel bernama di Excel. Tabel harus memiliki empat kolom. Setiap kolom sesuai dengan properti kontrol objek 3D. Setiap baris diplot sebagai pin pada model. Baris menentukan penempatan pin dalam sistem koordinat tiga dimensi.

Penting

Kontrol mixed-reality (MR) Power Apps menggunakan sistem koordinat kidal.

Column	Sesuai dengan
Label	ItemsLabels
X	PinsX
Y	PinsY
Z	PinsZ

Berikut adalah contoh tabel bernama "TestPins" yang berisi koordinat untuk menempatkan empat pin pada model 3D:

Untuk mencoba contoh ini, mulailah dengan membuat tabel di Excel.

1. Salin data sampel berikut dan tempelkan di sel A1 lembar kerja Excel baru.

   Label	Pin X	Pin Y	Pin Z
   Depan kiri	-0.2	0.01	0.2
   Kanan depan	0.2	0.01	0.2
   Nol	0	0	0
   Titik X	0	0.72	-0.2

2. Pilih salah satu sel yang ditempelkan. Pada tab Beranda, pilih Format sebagai Tabel, pilih gaya, lalu pilih OK.

3. Pada tab Desain Tabel di bawah Nama Tabel, masukkan nama seperti TestPins.

4. Simpan buku kerja dan tutup.

Selanjutnya, tambahkan tabel sebagai sumber data untuk menampilkan pin pada model 3D.

1. Di Power Apps Studio, masukkan model 3D atau pilih model yang sudah ada.
2. Atur properti Sumber kontrol objek 3D ke https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/chair.glb (atau file model lain yang Anda pilih).

Catatan

Contoh pertama dari kontrol objek 3D diberi nama 3DObject1 secara default dan itulah nama yang akan kita gunakan dalam contoh berikut. Instans kontrol tambahan akan disebut sebagai ViewIn3D2, ViewIn3D3, dan sebagainya.

1. Pada tab Properti model , pilih daftar turun bawah Pin(Item ).
2. Ketik excel di kotak pencarian, lalu pilih Impor dari Excel.
3. Temukan buku kerja Excel yang Anda simpan sebelumnya dan buka.
4. Pilih nama yang Anda berikan tabel di Excel lalu pilih Hubungkan.
5. Pada tab Tingkat Lanjut, temukan PinsX, PinsY, dan PinsZ dan masukkan nama kolom yang sesuai dalam tabel. (Dalam contoh ini, masukkan Label di ItemsLabels, X di PinsX, dan sebagainya.) Lampirkan nama kolom dalam tanda kutip.

Pin muncul pada model di lokasi yang dijelaskan oleh koordinat.

Tampilkan label dan koordinat pin pada model 3D

Gunakan tabel data untuk menampilkan label dan koordinat pin yang dipilih di aplikasi kanvas.

Dengan aplikasi Anda terbuka untuk diedit di Power Apps Studio:

1. Buka tab Sisipkan dan perluas Tata Letak.

2. Pilih Tabel data untuk menempatkan tabel di layar aplikasi, atau seret kontrol ke layar untuk memposisikannya dengan lebih tepat.

3. Pilih untuk menampilkan informasi tentang semua pin atau hanya pin yang dipilih. Dengan tabel data yang dipilih:

   • Memperlihatkan semua pin: Di panel Properti , pilih daftar turun bawah Pin(Item) dan pilih tabel Excel yang Terhubung dengan Anda sebelumnya.

   • Tampilkan pin yang dipilih saja: Di Power Apps Studio editor ekspresi, masukkan 3DObject1.SelectedItems.

     

4. Pada panel Properti, pilih Edit bidang, lalu pilih Tambahkan bidang.

5. Pilih kolom yang akan ditampilkan, lalu pilih Tambahkan.

   

Memperlihatkan label pin yang dipilih pada model 3D

Gunakan kotak teks untuk menampilkan hanya label pin yang dipilih di aplikasi kanvas.

Dengan aplikasi Anda terbuka untuk diedit di Power Apps Studio:

1. Buka tab Masukkan.
2. Pilih Label teks untuk menempatkan kotak teks di layar aplikasi, atau seret kontrol ke layar untuk memposisikannya dengan lebih tepat.
3. Di editor ekspresi, masukkan 3DObject1.Selected.Label.

Membuat koleksi untuk memungkinkan pengguna menambahkan pin mereka sendiri ke model 3D

Jika Anda ingin mengizinkan pengguna untuk menempatkan pin pada model 3D, gunakan koleksi.

Dengan aplikasi Anda terbuka untuk diedit di Power Apps Studio:

1. Buka tab Masukkan.

2. Pilih Input teks untuk menempatkan kotak entri teks di layar aplikasi.

3. Salin kotak teks dan tempelkan tiga kali untuk membuat empat kontrol input teks.

4. Atur properti Default untuk setiap kontrol ke X, Y, Z, dan Label, masing-masing.

5. Buka tab Tampilan pohon.

6. Ganti nama setiap kontrol, sebagaimana mestinya, menjadi XCoordinate, YCoordinate, ZCoordinate, dan LabelInput.

   

Selanjutnya, tambahkan tombol untuk menambahkan data pengguna ke kumpulan pin.

1. Buka tab Masukkan.

2. Pilih Tombol untuk menempatkan tombol di layar aplikasi.

3. Atur properti Teks tombol ke Tambahkan pin.

4. Masukkan kode berikut di properti OnSelect tombol, persis seperti yang ditunjukkan:

   Collect( 
   PinsCollection,
     {
       X: XCoordinate.Text,
       Y: YCoordinate.Text,
       Z: ZCoordinate.Text,
       Label: LabelInput.Text
     }
   )
   

Sekarang Anda akan mengubah sumber data pin dari tabel Excel ke koleksi baru.

1. Pilih model 3D.

2. Pada tab Properti, pilih daftar turun bawah Pins(Item), lalu pilih PinsCollection.

   

3. Pada tab Tingkat Lanjut, temukan PinsX, PinsY, dan PinsZ dan atur masing-masing ke X, Y, dan Z.

Ketika pengguna memasukkan koordinat dan label dan memilih Tambahkan pin, pin berlabel ditempatkan pada model pada koordinat yang dimasukkan.

Tampilkan informasi tentang pin saat ditambahkan ke model 3D

Terakhir, gabungkan contoh sebelumnya dengan menampilkan informasi tentang pin saat pengguna menambahkannya.

Dengan aplikasi Anda terbuka untuk diedit di Power Apps Studio:

1. Tambahkan tabel data ke layar.
2. Pada tab Properti, pilih daftar turun bawah Pins(Item) dan pilih PinsCollection.
3. Pilih Edit bidang, lalu pilih Tambahkan bidang.
4. Pilih kolom yang akan ditampilkan dalam tabel, lalu pilih Tambahkan.

Kontrol realitas campuran lainnya

• Lihat konten 3D dalam realitas campuran dengan Tampilan dalam kontrol MR.
• Ukur jarak, luas, dan volume dengan kontrol Kamera Pengukur.
• Buat dan lihat bentuk 3D yang telah ditentukan sebelumnya dengan bentuk Tampilan dalam kontrol MR.
• Cat garis 3D atau gambar panah 3D untuk menentukan area atau aset di lingkungan Anda dengan Markup dalam kontrol MR.

Catatan

Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)

Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).