允许在混合现实主页中放置 3D 模型

项目
03/21/2023

注意

此功能已随 Windows 10 的 2018 年 4 月更新添加。早期版本的 Windows 与此功能不兼容。

用户在启动应用程序之前，会先登陆到 Windows Mixed Reality 主页。在某些情况下，通过 2D 应用（例如全息影像应用）可直接将 3D 模型放置到混合现实主页作为修饰，或者便于在完全 3D 的环境中进一步检查。通过“添加模型协议”，可将网站或应用程序中的 3D 模型直接发送到 Windows Mixed Reality 主页，它将在此处永久保留 3D 应用启动器、2D 应用和全息影像等内容。

例如，如果要开发一个用于显示 3D 家具目录供空间设计使用的应用程序，请使用“添加模型协议”使用户能够放置来自此目录的这些 3D 家具模型。放置在世界中后，用户可移动、删除这些 3D 模型，也可重设其大小，就像在主页中操作其他全息影像一样。本文概述了如何实现“添加模型协议”，使用户能够使用你的应用或 Web 中的 3D 对象装饰他们的世界。

设备支持

功能	HoloLens	沉浸式头戴显示设备
添加模型协议	✔	✔

基础知识

需执行两个步骤才能在 Windows Mixed Reality 主页中放置 3D 模型：

确保 3D 模型与 Windows Mixed Reality 主页兼容。
在应用程序或网页（本文）中实现添加模型协议。

实现“添加模型协议”

拥有兼容的 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) 头戴显示设备，在调用“添加模型协议”之前，不必运行混合现实门户。在这种情况下，“添加模型协议”将启动混合现实门户，在你进入混合现实主页后，将对象直接放置在头戴显示设备看到的位置。
如果在混合现实门户已在运行的情况下从桌面调用“添加模型协议”，请确保头戴显示设备处于“已唤醒”状态。如果不处于已唤醒状态，放置就会失败。