Povolení umístění 3D modelů na domovské stránce hybridní reality

Článek
07/12/2023

Poznámka

Tato funkce byla přidána jako součást aktualizace Windows 10 z dubna 2018. Starší verze Windows nejsou s touto funkcí kompatibilní.

Domovská Windows Mixed Reality je výchozím bodem, kam uživatelé přistanou před spuštěním aplikací. V některých scénářích umožňují 2D aplikace (například hologramy) umísťovat 3D modely přímo do domovského prostředí hybridní reality jako dekorace nebo pro další kontrolu v plném 3D. Protokol add model umožňuje odeslat 3D model z vašeho webu nebo aplikace přímo do Windows Mixed Reality domovské stránky, kde se zachová, jako jsou spouštěče 3D aplikací, 2D aplikace a hologramy.

Pokud například vyvíjíte aplikaci, která pro návrh prostoru poskytuje katalog 3D nábytku, použijte protokol add model , který uživatelům umožní umístit tyto modely 3D nábytku z katalogu. Po umístění na světě můžou uživatelé tyto 3D modely přesouvat, měnit jejich velikost a odebírat je stejně jako ostatní hologramy v domácnosti. Tento článek obsahuje přehled implementace protokolu pro přidání modelu , který uživatelům umožní zdobit jejich svět 3D objekty z vaší aplikace nebo webu.

Podpora zařízení

Funkce	HoloLens	Imerzivní náhlavní soupravy
Přidání protokolu modelu	✔️	✔️

Základy

Umístění 3D modelů na domovské Windows Mixed Reality je potřeba provést ve dvou krocích:

Ujistěte se, že je váš 3D model kompatibilní s domovskou Windows Mixed Reality.
Implementujte do aplikace nebo webové stránky protokol pro přidání modelu (tento článek).

Implementace protokolu pro přidání modelu

Jakmile budete mít kompatibilní 3D model, můžete implementovat protokol add model aktivací následujícího identifikátoru URI z libovolné webové stránky nebo aplikace:

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

Pokud identifikátor URI odkazuje na vzdálený prostředek, automaticky se stáhne a umístí do domovské stránky. Místní prostředky se před umístěním do domovské stránky zkopírují do složky dat aplikací domovské stránky hybridní reality. Doporučujeme navrhnout prostředí tak, aby zohlednilo scénáře, kdy uživatel používá starší verzi Windows, která tuto funkci nepodporuje, skrytím tlačítka nebo zakázáním, pokud je to možné.

Vyvolání protokolu přidání modelu z aplikace Univerzální platforma 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
   }
}

Vyvolání protokolu přidání modelu z webové stránky:

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

Důležité informace o imerzivních náhlavních soupravách (VR)

U imerzivních náhlavních souprav (VR) nemusí být portál Mixed Reality před vyvoláním protokolu přidání modelu spuštěný. V takovém případě protokol přidání modelu spustí Mixed Reality Portal a umístí objekt přímo tam, kde se náhlavní souprava hledá, jakmile dorazíte na domovskou stránku hybridní reality.
Při vyvolání protokolu přidání modelu z plochy s již spuštěným portálem Mixed Reality zkontrolujte, že je náhlavní souprava "probuzená". Pokud ne, umístění nebude úspěšné.

Sdílet prostřednictvím