在混合實境首頁中啟用 3D 模型的放置

  • 發行項

注意

這項功能已新增為2018 年 4 月更新Windows 10的一部分。 舊版 Windows 與此功能不相容。

Windows Mixed Reality首頁是使用者啟動應用程式之前登陸的起點。 在某些情況下，像全像投影應用程式之類的 2D 應用程式 () 可讓您直接將 3D 模型放置到混合實境住家做為裝飾，或在完整 3D 中進一步檢查。 新增模型通訊協定可讓您直接從網站或應用程式將 3D 模型傳送至Windows Mixed Reality首頁，其會保存，例如3D 應用程式啟動器、2D 應用程式和全像投影。

例如，如果您要開發一個應用程式來呈現 3D 室內目錄來設計空間，請使用 新增模型通訊協定 ，讓使用者從類別目錄放置這些 3D 裝飾品。 一旦放置在世界中，使用者就可以移動、調整大小及移除這些 3D 模型，就像家庭中的其他全像投影一樣。 本文提供實作 新增模型通訊協定 的概觀，讓使用者能夠從您的應用程式或 Web 使用 3D 物件裝飾其世界。

裝置支援

功能 HoloLens 沉浸式頭戴裝置
新增模型通訊協定 ✔️ ✔️

基本概念

啟用Windows Mixed Reality首頁中 3D 模型的放置有兩個步驟：

  1. 請確定您的 3D 模型與Windows Mixed Reality首頁相容。
  2. 在您的應用程式或網頁中實作 新增模型通訊協定 ， (本文) 。

實作 新增模型通訊協定

一旦您擁有 相容的 3D 模型，您就可以從任何網頁或應用程式啟用下列 URI 來實作 新增模型通訊協定 ：

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

如果 URI 指向遠端資源，則會自動下載並放在首頁中。 本機資源會先複製到混合實境首頁的應用程式資料檔案夾，再放在住家。 建議您設計您的體驗，以考慮使用者可能執行舊版 Windows 但不支援此功能的案例，方法是隱藏按鈕或盡可能停用此功能。

從通用 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
   }
}

從網頁叫用 新增模型通訊協定 ：

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

沉浸式 (VR) 頭戴裝置的考慮

  • 針對沉浸式 (VR) 頭戴式裝置，Mixed Reality入口網站不需要在叫用新增模型通訊協定之前執行。 在此情況下，新增模型通訊協定會啟動Mixed Reality入口網站，並將頭戴式裝置直接放在您抵達混合實境首頁時所查看的物件。
  • 從桌面叫用已執行Mixed Reality入口網站的新增模型通訊協定時，請確定頭戴裝置是「喚醒」。 如果沒有，放置將不會成功。

另請參閱