Поддержка размещения трехмерных моделей в доме со смешанной реальностью

  • Статья

Примечание

Эта функция была добавлена в составе обновления Windows 10 за апрель 2018 г. Более старые версии Windows несовместимы с этой функцией.

Windows Mixed Reality дома является отправной точкой, где пользователи приземлились перед запуском приложений. В некоторых сценариях трехмерные приложения (например, голограммы) позволяют размещать трехмерные модели непосредственно в доме смешанной реальности в качестве украшений или для дальнейшей проверки в полном трехмерном режиме. Протокол добавления модели позволяет отправлять трехмерную модель с веб-сайта или приложения непосредственно в Windows Mixed Reality дома, где она будет сохраняться, как средства запуска трехмерных приложений, двухd-приложения и голограммы.

Например, если вы разрабатываете приложение, которое отображает каталог трехмерной мебели для проектирования пространства, используйте протокол добавления модели , чтобы пользователи могли размещать эти трехмерные модели мебели из каталога. После размещения в мире пользователи могут перемещать, изменять размер и удалять эти трехмерные модели так же, как и другие голограммы в доме. В этой статье представлен обзор реализации протокола добавления модели , чтобы пользователи могли украшать свой мир трехмерными объектами из вашего приложения или Интернета.

Поддержка устройств

Компонент HoloLens Иммерсивные гарнитуры
Добавление протокола модели ✔️ ✔️

Основные сведения

Существует два шага, чтобы включить размещение трехмерных моделей в Windows Mixed Reality домашней странице:

  1. Убедитесь, что трехмерная модель совместима с Windows Mixed Reality домашней странице.
  2. Реализуйте протокол добавления модели в приложении или на веб-странице (эта статья).

Реализация протокола добавления модели

Получив совместимую трехмерную модель, вы можете реализовать протокол добавления модели , активировав следующий универсальный код ресурса (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) не нужно запускать портал Смешанная реальность перед вызовом протокола добавления модели. В этом случае протокол добавления модели запустит портал Смешанная реальность и поместит объект непосредственно в то место, где будет искать гарнитура после того, как вы прибудете в домашнюю страницу смешанной реальности.
  • При вызове протокола добавления модели с рабочего стола с уже запущенным порталом Смешанная реальность убедитесь, что гарнитура находится в режиме "awake". В противном случае размещение не будет выполнено.

См. также раздел