Mengaktifkan penempatan model 3D di rumah realitas campuran

Artikel
07/12/2023

Catatan

Fitur ini ditambahkan sebagai bagian dari Pembaruan Windows 10 April 2018. Versi Windows yang lebih lama tidak kompatibel dengan fitur ini.

Rumah Windows Mixed Reality adalah titik awal di mana pengguna mendarat sebelum meluncurkan aplikasi. Dalam beberapa skenario, aplikasi 2D (seperti aplikasi Hologram) memungkinkan penempatan model 3D langsung ke rumah realitas campuran sebagai dekorasi atau untuk pemeriksaan lebih lanjut dalam 3D penuh. Protokol tambahkan model memungkinkan Anda mengirim model 3D dari situs web atau aplikasi Anda langsung ke rumah Windows Mixed Reality, di mana ia akan bertahan seperti peluncur aplikasi 3D, aplikasi 2D, dan hologram.

Misalnya, jika Anda mengembangkan aplikasi yang menampilkan katalog furnitur 3D untuk merancang ruang, gunakan protokol tambahkan model untuk memungkinkan pengguna menempatkan model furnitur 3D tersebut dari katalog. Setelah ditempatkan di dunia, pengguna dapat memindahkan, mengubah ukuran, dan menghapus model 3D ini seperti hologram lain di rumah. Artikel ini memberikan gambaran umum tentang menerapkan protokol tambahkan model untuk memungkinkan pengguna menghias dunia mereka dengan objek 3D dari aplikasi Atau web Anda.

Dukungan perangkat

Fitur	HoloLens	Headset imersif
Menambahkan protokol model	✔️	✔️

Dasar-dasar

Ada dua langkah untuk mengaktifkan penempatan model 3D di rumah Windows Mixed Reality:

Pastikan model 3D Anda kompatibel dengan Windows Mixed Reality home.
Terapkan protokol tambahkan model di aplikasi atau halaman web Anda (artikel ini).

Menerapkan protokol tambahkan model

Setelah Anda memiliki model 3D yang kompatibel, Anda dapat menerapkan protokol tambahkan model dengan mengaktifkan URI berikut dari halaman web atau aplikasi apa pun:

ms-mixedreality:addmodel?uri=<Path to a .glb 3D model either local or remote>

Jika URI menunjuk ke sumber daya jarak jauh, maka URI akan secara otomatis diunduh dan ditempatkan di rumah. Sumber daya lokal akan disalin ke folder data aplikasi rumah realitas campuran sebelum ditempatkan di rumah. Sebaiknya rancang pengalaman Anda untuk memperhitungkan skenario di mana pengguna mungkin menjalankan versi Windows yang lebih lama yang tidak mendukung fitur ini dengan menyembunyikan tombol atau menonaktifkannya jika memungkinkan.

Memanggil protokol tambahkan model dari aplikasi Platform Windows Universal:

private async void launchURI_Click(object sender, RoutedEventArgs e)
{
   // Define the add model URI
   var uriAddModel = new Uri(@"ms-mixedreality:addModel?uri=sample.glb");

   // Launch the URI to invoke the placement
   var success = await Windows.System.Launcher.LaunchUriAsync(uriAddModel);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}

Memanggil protokol tambahkan model dari halaman web:

<a class="btn btn-default" href="ms-mixedreality:addModel?uri=sample.glb"> Place 3D Model </a>

Pertimbangan untuk headset imersif (VR)

Untuk headset imersif (VR), portal Mixed Reality tidak harus berjalan sebelum memanggil protokol tambahkan model. Dalam hal ini, protokol tambahkan model akan meluncurkan portal Mixed Reality dan menempatkan objek langsung di mana headset terlihat setelah Anda tiba di rumah realitas campuran.
Saat memanggil protokol tambahkan model dari desktop dengan Portal Mixed Reality sudah berjalan, pastikan bahwa headset "terjaga". Jika tidak, penempatan tidak akan berhasil.

Bagikan melalui