Aktivieren der Platzierung von 3D-Modellen in der Mixed Reality Startumgebung

Hinweis

Dieses Feature wurde im Rahmen des Updates vom April 2018 Windows 10 hinzugefügt. Ältere Versionen von Windows sind mit diesem Feature nicht kompatibel.

Das Windows Mixed Reality ist der Ausgangspunkt, an dem Benutzer landen, bevor sie Anwendungen starten. In einigen Szenarien ermöglichen 2D-Apps (z. B. die Hologramme-App) die direkte Platzierung von 3D-Modellen im Mixed Reality Startumgebung als Dekorationen oder zur weiteren Überprüfung in vollständigem 3D. Mit dem Add Model-Protokoll können Sie ein 3D-Modell von Ihrer Website oder Anwendung direkt an die Windows Mixed Reality-Startseite senden, wo es wie 3D-App-Startprogramm, 2D-Apps und Hologramme beibehalten wird.

Wenn Sie z. B. eine Anwendung entwickeln, die einen Katalog von 3D-Modellen zum Entwerfen eines Raumes zeigt, verwenden Sie das Add Model-Protokoll , um Benutzern zu ermöglichen, diese 3D-Modellmodelle aus dem Katalog zu platzieren. Sobald sie auf der Welt platziert sind, können Benutzer diese 3D-Modelle wie andere Hologramme zu Hause verschieben, deren Größe ändern und entfernen. Dieser Artikel bietet eine Übersicht über die Implementierung des Add Model-Protokolls , mit dem Benutzer ihre Welt mit 3D-Objekten aus Ihrer App oder dem Web ergänzen können.

Geräteunterstützung

Feature HoloLens Immersive Headsets
Hinzufügen des Modellprotokolls ✔️ ✔️

Grundlagen

Es gibt zwei Schritte, um die Platzierung von 3D-Modellen im Windows Mixed Reality zu ermöglichen:

  1. Stellen Sie sicher, dass Ihr 3D-Modell mit dem Windows Mixed Reality kompatibel ist.
  2. Implementieren Sie das Add Model-Protokoll in Ihrer Anwendung oder Webseite (dieser Artikel).

Implementieren des Add Model-Protokolls

Sobald Sie über ein kompatibles 3D-Modell verfügen, können Sie das Add Model-Protokoll implementieren, indem Sie den folgenden URI von einer beliebigen Webseite oder Anwendung aktivieren:

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

Wenn der URI auf eine Remoteressource verweist, wird er automatisch heruntergeladen und in der Startseite platziert. Lokale Ressourcen werden in den App-Datenordner des Mixed Reality Startumgebung kopiert, bevor sie in der Startseite abgelegt werden. Es wird empfohlen, Ihre Benutzeroberfläche so zu entwerfen, dass Szenarien berücksichtigt werden, in denen der Benutzer eine ältere Version von Windows ausführen kann, die dieses Feature nicht unterstützt, indem die Schaltfläche verborgen oder nach Möglichkeit deaktiviert wird.

Aufrufen des Add Model-Protokolls aus einer Universelle Windows-Plattform App:

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

Aufrufen des Add Model-Protokolls von einer Webseite:

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

Überlegungen zu immersiven Headsets (VR)

  • Bei immersiven Headsets (VR) muss das Mixed Reality-Portal nicht ausgeführt werden, bevor das Add Model-Protokoll aufruft. In diesem Fall startet das Add Model-Protokoll das Mixed Reality-Portal und platzieren das Objekt direkt an der Stelle, an der das Headset nach der Ankunft im Mixed Reality Startumgebung.
  • Wenn Sie das Add Model-Protokoll über den Desktop aufrufen, während das Mixed Reality-Portal bereits ausgeführt wird, stellen Sie sicher, dass das Headset "weck" ist. Ander denn, die Platzierung ist nicht erfolgreich.

Siehe auch