Włączanie umieszczania modeli 3D w domu rzeczywistości mieszanej

Artykuł
07/12/2023

Uwaga

Ta funkcja została dodana w ramach aktualizacji Windows 10 kwietnia 2018 r. Starsze wersje systemu Windows nie są zgodne z tą funkcją.

Dom Windows Mixed Reality to punkt wyjścia, w którym użytkownicy lądują przed uruchomieniem aplikacji. W niektórych scenariuszach aplikacje 2D (takie jak aplikacja Holograms) umożliwiają umieszczanie modeli 3D bezpośrednio w domu rzeczywistości mieszanej jako dekoracje lub dalsze inspekcje w pełnym 3D. Protokół dodawania modelu umożliwia wysyłanie modelu 3D z witryny internetowej lub aplikacji bezpośrednio do strony głównej Windows Mixed Reality, gdzie będzie ona utrwalana w taki sposób, jak uruchamianie aplikacji 3D, aplikacje 2D i hologramy.

Jeśli na przykład tworzysz aplikację, która zawiera wykaz mebli 3D do projektowania przestrzeni, użyj protokołu dodawania modelu , aby umożliwić użytkownikom umieszczanie tych modeli mebli 3D z katalogu. Po umieszczeniu na świecie użytkownicy mogą przenosić, zmieniać rozmiar i usuwać te modele 3D tak samo jak inne hologramy w domu. Ten artykuł zawiera omówienie implementacji protokołu dodawania modelu umożliwiającego użytkownikom udekorowanie świata obiektami 3D z aplikacji lub sieci Web.

Obsługa urządzeń

Funkcja	HoloLens	Immersyjne zestawy słuchawkowe
Dodawanie protokołu modelu	✔️	✔️

Podstawy

Istnieją dwa kroki umożliwiające umieszczenie modeli 3D w Windows Mixed Reality domu:

Upewnij się, że model 3D jest zgodny z Windows Mixed Reality domu.
Zaimplementuj protokół dodawania modelu w aplikacji lub na stronie internetowej (ten artykuł).

Implementowanie protokołu dodawania modelu

Po utworzeniu zgodnego modelu 3D można zaimplementować protokół dodawania modelu , aktywując następujący identyfikator URI z dowolnej strony internetowej lub aplikacji:

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

Jeśli identyfikator URI wskazuje zasób zdalny, zostanie on automatycznie pobrany i umieszczony w domu. Zasoby lokalne zostaną skopiowane do folderu danych aplikacji głównej rzeczywistości mieszanej przed umieszczeniem ich w domu. Zalecamy zaprojektowanie środowiska do obsługi scenariuszy, w których użytkownik może uruchomić starszą wersję systemu Windows, która nie obsługuje tej funkcji, ukrywając przycisk lub wyłączając go, jeśli to możliwe.

Wywoływanie protokołu dodawania modelu z aplikacji platforma uniwersalna systemu Windows:

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
   }
}

Wywoływanie protokołu dodawania modelu ze strony internetowej:

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

Zagadnienia dotyczące immersyjnych zestawów słuchawkowych (VR)

W przypadku immersyjnych zestawów słuchawkowych (VR) Mixed Reality Portal nie musi być uruchomiony przed wywołaniem protokołu dodawania modelu. W takim przypadku protokół dodawania modelu uruchomi Mixed Reality Portal i umieści obiekt bezpośrednio, gdzie zestaw słuchawkowy szuka po nadejściu do domu rzeczywistości mieszanej.
Podczas wywoływania protokołu dodawania modelu z pulpitu za pomocą Mixed Reality Portal jest już uruchomiony, upewnij się, że zestaw słuchawkowy jest "czujny". Jeśli nie, umieszczanie nie powiedzie się.

Udostępnij za pośrednictwem