Lihat kandungan 3D atau imej dapam realiti campuran

2025-05-21

Gunakan kawalan Lihat dalam MR untuk meletakkan model 3D objek atau imej dalam ruang dunia sebenar. Sebagai contoh, pratonton lukisan pada dinding sebelum anda menggantungkannya atau lihat sama ada rak buku maya 3D akan muat dalam ruang yang anda kehendaki.

Bagaimana jika anda tidak mempunyai model 3D objek? Muat naik imej objek dan tetapkan dimensi kepada saiz objek. Kawalan itu menggunakan imej sebagai wajah kiub maya saiz yang dikehendaki. Letakkan pengganti ini untuk model 3D dalam ruang anda.

Kawalan Lihat dalam MR menambah butang pada apl anda. Apabila pengguna memilih butang itu, aplikasi menindih model 3D yang dipilih (dalam format fail .glb, .stl atau .obj) atau imej (dalam format fail .jpg atau .png) pada suapan kamera peranti.

Foto skrin tablet yang menunjukkan model 3D forklift yang ditindih pada paparan dalaman gudang.

Anda juga boleh mengambil gambar menggunakan kawalan Lihat dalam MR dan memuat naiknya ke OneDrive.

Penting

Kandungan 3D anda mestilah dalam format fail .glb, .stl atau .obj. Anda boleh menukar model 3D sedia ada anda kepada format fail .glb daripada pelbagai format 3D. Kandungan 3D yang dimampatkan dengan mampatan Draco tidak disokong.

Tip

Pastikan model 3D anda dioptimumkan untuk digunakan untuk Power Apps meminimumkan masa muat.
Komponen kawalan realiti campuran (MR) bekerja dengan baik dalam persekitaran pencahayaan yang baik dengan permukaan bertekstur rata. Penjejakan lebih baik pada peranti yang didayakan LIDAR.
Kawalan MR dalam Power Apps menggunakan Babylon dan Babylon React Native. Kandungan realiti campuran yang berfungsi dalam kotak pasir Babylon harus berfungsi melalui Power Apps platform MR yang dikongsi ini. Jika kandungan anda berfungsi di Babylon tetapi tidak dalam Power Apps, ajukan Power Apps soalan dalam Forum Komuniti. (Tag dengan "realiti campuran.")

Tambah Pandangan dalam butang MR pada skrin aplikasi

Dengan apl anda dibuka untuk diedit dalam Power Apps Studio:

Buka tab Sisipkan dan kembangkan Realiti Campuran.
Pilih Lihat dalam MR untuk meletakkan kawalan dalam skrin apl atau seret kawalan ke skrin untuk meletakkannya dengan lebih tepat.

Kawalan ialah butang yang dilabelkan dengan ikon kiub dan teks Lihat dalam MR. Tukar label dan sembunyikan ikon jika anda suka dalam sifat jenis Teks dan Paparan.

Tangkapan skrin tab Sisipkan dalam Power Apps Studio, menunjukkan tempat untuk mencari kawalan Lihat dalam MR.

Lihat model yang berbeza dalam satu sesi

Kawalan Pandangan dalam MR memaparkan satu fail media secara lalai. Untuk melihat fail media berbeza yang dipilih melalui galeri media semasa pengalaman MR, gunakan sifat lanjutan Item kawalan . Sifat ini mencipta jadual yang menyenaraikan fail media pengguna yang boleh dipilih daripada dalam pengalaman realiti campuran.

Apabila anda menggunakan sifat Item , anda perlu mengesetkan nilai untuk sifat lanjutan tambahan berikut untuk memetakan lajur jadual anda:

Sifat	Description
ItemSumber (diperlukan)	Menentukan lajur dalam Item yang mengenal pasti model atau imej 3D untuk ditunjukkan dalam pandangan realiti campuran. Lihat Sambungkan model 3D untuk Power Apps mengetahui lebih lanjut tentang membawa model ke dalam Power Apps.
Label Item	Menentukan lajur dalam Item yang mengandungi label untuk dipaparkan dalam galeri media. Sifat teks alternatif digunakan untuk item yang tidak mempunyai label yang ditentukan.
ItemLakaran kecil	Menentukan lajur dalam Item mengenal pasti lakaran kecil untuk dipaparkan dalam galeri media. Imej kecil lalai disediakan untuk item yang tidak mempunyai imej kecil.
ItemObjectWidth, ItemsObjectHeight, ItemsObjectDepth	Tentukan saiz eksplisit untuk setiap item media dalam jadual. Lebar objek,Ketinggian objek dan Kedalaman objek digunakan untuk item yang tidak mempunyai saiz tertentu.

Untuk mengujinya, mari kita cipta galeri media yang menunjukkan tiga tumbuhan yang berbeza dalam persekitaran bilik. Jadual Item kami kelihatan seperti ini:

label	sumber	imej kecil
Cenderawasih	https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/bird_of_paradise_blue.glb	https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/bird_of_paradise_blue.png
Gambar Pokok Ara	https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/flf_orange.glb	https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/flf_orange.png
Pokok Sawit Kecil	https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/palm_green.glb	https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/palm_green.png

Video yang menunjukkan galeri media dalam pengalaman realiti campuran.

Dengan apl anda dibuka untuk diedit dalam Power Apps Studio:

Buka tab Sisipkan dan kembangkan Realiti Campuran.
Pilih Lihat dalam MR untuk meletakkan kawalan dalam skrin apl atau seret kawalan ke skrin untuk meletakkannya dengan lebih tepat.

Pada tab Sifat Lanjutan , pilih sifat Item dan taip atau tampal kod berikut:

Table(
{
label: "Birds of Paradise",
source: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/bird_of_paradise_blue.glb",
thumbnail: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/bird_of_paradise_blue.png"
},
{
label: "Fiddle Leaf Fig",
source: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/flf_orange.glb",
thumbnail: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/flf_orange.png"
},
{
label: "Small Palm Tree",
source: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/palm_green.glb",
thumbnail: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/palm_green.png"
}
)

Tetapkan sifat ItemsLabel kepada "label".
Tetapkan sifat ItemsSource kepada "source".
Tetapkan sifat ItemsThumbnail kepada "thumbnail".

Nota

Sifat Item ditetapkan kepada sumber data anda yang boleh menjadi koleksi, daripada penyambung atau jadual berkod keras seperti dalam contoh ini. Sifat ItemsSource,ItemsLabel dan ItemsThumbnail disetkan kepada nama lajur sumber data tersebut dalam tanda petikan.

Simpan dan terbitkan aplikasi, dan kemudian buka pada peranti mudah alih anda untuk mencubanya.

Cara objek diskalakan jika anda mengubah saiznya

Jika anda tidak menentukan dimensi apabila anda meletakkan model, kawalan Lihat dalam MR mengikut dimensi yang diberikan dalam fail objek. Anda boleh mengubah saiz model dengan memasukkan nilai selain daripada 0 dalam satu atau lebih sifat lebar, tinggi dan kedalaman kawalan (Lebar objek,Ketinggian objek dan Kedalaman objek). Cara model diskalakan bergantung pada bilangan dimensi yang anda ubah.

Jika semua dimensi ialah 0 (lalai), saiz model dibiarkan seperti yang ditetapkan dalam fail objek.
Jika satu dimensi ditetapkan, model akan diskalakan dengan sama berdasarkan dimensi yang ditukar, serupa dengan tetapan "kekalkan nisbah aspek" apabila anda mengubah saiz imej.
Jika dua dimensi ditetapkan, model diskalakan untuk dipadankan dengan dua dimensi yang diberikan dan purata skala untuk dua dimensi yang pertama.
Sebagai contoh, katakan anda mempunyai model dengan ketinggian 12 m, lebar 6 m dan kedalaman 3 m. Anda menetapkan sifat kawalan Paparan dalam MR seperti berikut: Ketinggian objek: 24,Lebar objek: 9,Kedalaman objek: 0 (tidak berubah). Ketinggian meningkat didarabkan faktor 2, dan lebar meningkat didarabkan faktor 1.5. Peningkatan ketinggian dan lebar dipuratakan untuk mencari faktor kedalaman sepatutnya ditingkatkan: 2 + 1.5 = 3.5/2 = 1.75. Dimensi akhir model ialah Ketinggian objek 24, lebar objek 9 dan kedalaman objek 5.25 (3 x 1.75).
Jika ketiga-tiga dimensi ditetapkan, saiz model diubah mengikut nilai yang anda tentukan.

Nota

Jika ukuran tidak mematuhi nisbah aspek asal, model mungkin akan hancur atau herot-benyot apabila ia dipaparkan dalam MR.

Sifat

Tukar tingkah laku dan penampilan butang Lihat dalam MR menggunakan sifat. Sesetengah hartanah hanya tersedia pada tab Lanjutan .

Tangkapan skrin butang Lihat dalam MR dalam pembinaan dalam Microsoft Power Apps Studio, ditunjukkan bersama sifatnya.

Sifat	Description	Taip	Lokasi
Teks	Tetapkan teks label butang.	String	Hartanah; Lanjutan: Teks
Teks alternatif	Menentukan teks yang akan dipaparkan jika model tidak dapat dimuatkan atau jika pengguna aplikasi menuding pada model.	String	Hartanah; Lanjutan: AltText
Paparkan jenis	Tentukan sama ada label butang menunjukkan ikon kiub, teks, atau kedua-duanya.	Pilihan juntai bawah	Hartanah; Lanjutan: Jenis Paparan
Sumber	Mengenal pasti sumber data (fail.glb, .stl atau .obj) untuk dipaparkan.	Tidak berkenaan	Hartanah; Lanjutan: Sumber
Senarai Sumber (Item)	Sumber data (jadual) yang menyenaraikan berbilang fail media untuk dilihat dalam satu sesi realiti campuran.	Table	Hartanah; Lanjutan: Item
Lebar objek	Menetapkan lebar model.	Integer	Hartanah; Lanjutan: Lebar Objek
Ketinggian objek	Menetapkan ketinggian model.	Integer	Hartanah; Lanjutan: Ketinggian Objek
Kedalaman objek	Menetapkan kedalaman model.	Integer	Hartanah; Lanjutan: Kedalaman Objek
Unit ukuran	Tetapkan unit ukuran yang digunakan untuk lebar, tinggi, dan kedalaman model.	Senarai	Hartanah; Lanjutan: Unit
Dayakan bayang	Menentukan sama ada bayang digunakan untuk meningkatkan kesan 3D apabila model ditunjukkan.	Boolean	Hartanah; Lanjutan: EnableShadows
Dayakan pengesanan penanda	Menentukan sama ada pengesanan penanda akan digunakan untuk menentukan kedudukan model dan penggiliran. Lihat Gunakan pengesanan penanda dengan kawalan realiti campuran	Boolean	Hartanah; Lanjutan: EnableMarkerDetection
Kelihatan	Tunjuk atau sembunyi butang.	Boolean	Hartanah; Lanjutan: Boleh dilihat
Kedudukan	Letakkan penjuru kiri atas butang pada koordinat skrin yang dinyatakan dalam x dan y.	Nombor titik terapung	Hartanah; Lanjutan: X, Y ...
Saiz	Menentukan saiz butang menggunakan nilai piksel yang disediakan dalam Lebar dan Tinggi.	Integer	Hartanah; Lanjutan: Lebar, Tinggi
Atas pelapik	Menetapkan jarak antara teks label butang dan bahagian atas butang.	Nombor titik terapung	Hartanah; Lanjutan: PaddingTop
Bawah pelapik	Menetapkan jarak antara teks label butang dan bahagian bawah butang.	Nombor titik terapung	Hartanah; Lanjutan: PaddingBottom
Kiri pelapik	Menetapkan jarak antara teks label butang dan bahagian sisi kiri butang.	Nombor titik terapung	Hartanah; Lanjutan: PaddingLeft
Kanan pelapik	Menetapkan jarak antara teks label butang dan bahagian sisi kanan butang.	Nombor titik terapung	Hartanah; Lanjutan: PaddingRight
Fon	Menetapkan nama keluarga fon yang digunakan untuk teks label butang.	Senarai	Hartanah; Lanjutan: Fon
Saiz fon	Menetapkan saiz fon teks pada teks label butang.	Nombor titik terapung	Hartanah; Lanjutan: Saiz Fon
Berat fon	Menetapkan berat teks label butang, sama ada Tebal, Lebih Ringan, Normal atau Separa Tebal.	Senarai	Hartanah; Lanjutan: FontWeight
Penjajaran teks	Menetapkan penjajaran mendatar teks label dalam butang, sama ada Tengah, Justifikasi, Kiri atau Kanan.	Tidak berkenaan	Hartanah; Lanjutan: Penjajaran Teks
Penjajaran menegak	Mengesetkan penjajaran menegak teks label dalam butang, sama ada Bawah, Tengah atau Atas.	Senarai	Hartanah; Lanjutan: VerticalAlign
Gaya fon	Mengesetkan gaya teks label butang, sama ada Italik, Garis Bawah, Coretan atau tiada.	Tidak berkenaan	Hartanah; Lanjutan: Italic,Underline,Coretan
Jejari sempadan	Menentukan jejari penjuru bagi sempadan butang.	Nombor titik terapung	Hartanah; Lanjutan: BorderRadius
Warna	Menetapkan warna teks label butang dan latar belakang butang.	Tidak berkenaan	Hartanah; Lanjutan: FillColor, TextColor
Sempadan	Menentukan gaya, lebar dan warna sempadan butang.	Tidak berkenaan	Hartanah; Lanjutan: BorderStyle,BorderThickness,BorderFillColor......
Dinyahdayakan	Memadamkan butang tetapi memastikan ia boleh dilihat.	Boolean	Hartanah; Lanjutan: Kurang upaya
Warna apabila dinyahdayakan	Mengesetkan warna teks label butang, latar belakang butang dan sempadan butang jika DisplayMode Dilumpuhkan .	Tidak berkenaan	Hartanah; Lanjutan: DisabledContentColor, DisabledFillColor, DisabledBorderColor
Warna apabila ditekan	Menetapkan warna teks label butang, latar belakang butang dan sempadan butang apabila pengguna memilih butang.	Tidak berkenaan	Hartanah; Lanjutan: PressedContentColor, PressedFillColor, PressedBorderColor
Warna apabila hover	Menetapkan warna teks label butang, latar belakang butang dan sempadan butang apabila pengguna menudingkan penuding tetikus ke atasnya.	Tidak berkenaan	Hartanah; Lanjutan: HoverContentColor, HoverFillColor, HoverBorderColor
OnMixedRealitySelect	Tingkah laku yang dicetuskan apabila pengguna memilih butang untuk melancarkan ke pengalaman realiti campuran.	Tindakan ditakrifkan	Lanjutan
OnChange	Tingkah laku yang dicetuskan apabila sebarang sifat pada butang ditukar.	Tindakan ditakrifkan	Lanjutan
Petua alat	Menentukan teks untuk dipaparkan apabila pengguna menuding di atas butang.	String	Lanjutan
ContentLanguage	Menentukan bahasa paparan label butang, jika ia berbeza daripada bahasa yang digunakan dalam aplikasi.	String	Lanjutan
Mod Paparan	Menentukan sama ada butang membenarkan input pengguna (Edit), hanya memaparkan data (Lihat), atau dilumpuhkan (Dilumpuhkan).	Enum	Lanjutan
Indeks Tab	Menentukan susunan butang dipilih jika pengguna menavigasi aplikasi menggunakan kekunci Tab.	Integer	Hartanah; Lanjutan: TabIndex

Sifat output

Apl anda boleh menggunakan lebih banyak sifat apabila pengguna berinteraksi dengan kawalan Lihat dalam MR . Ini dikenali sebagai sifat output. Anda boleh menggunakan sifat output dalam kawalan lain atau untuk menyesuaikan pengalaman aplikasi.

Sifat	Description	Taip
Foto	Mengutip gambar yang ditangkap semasa sesi realiti campuran. Anda boleh memuat naik foto realiti campuran ke OneDrive dan tunjukkan dalam galeri.	Tidak berkenaan

Kawalan realiti campuran lain

Lihat kandungan 3D dengan kawalan objek 3D .
Ukur jarak, luas dan kelantangan dengan kawalan Ukur dalam realiti campuran .
Cipta dan lihat bentuk 3D yang telah ditetapkan dengan bentuk Lihat dalam kawalan realiti campuran
Cat garisan 3D atau lukis anak panah 3D untuk menentukan kawasan atau aset dalam persekitaran anda dengan kawalan Markup dalam MR .

Kongsi melalui