Aktualisieren von 2D UWP-Apps für Windows Mixed Reality

Artikel
07/12/2023

Windows Mixed Reality können Ihre Benutzer Hologramme so sehen, als wären sie in der physischen und digitalen Welt direkt um sie herum. Im Kern sind sowohl HoloLens als auch die Desktop-PCs, an die Sie immersives Headset-Zubehör anschließen, Windows 10 Geräte. Sie können fast alle Universelle Windows-Plattform-Apps (UWP) im Store als 2D-Apps ausführen.

Erstellen einer 2D-UWP-App für Mixed Reality

Der erste Schritt zum Einbinden einer 2D-App für Mixed Reality-Headsets besteht darin, Ihre App als Standard-2D-App auf Ihrem Desktopmonitor auszuführen.

Erstellen einer neuen 2D-UWP-App

Um eine neue 2D-App für Mixed Reality zu erstellen, erstellen Sie eine Standard-2D-Universelle Windows-Plattform-App (UWP). Es sind keine weiteren App-Änderungen erforderlich, damit diese App dann als Slate in Mixed Reality ausgeführt werden kann.

Informationen zum Erstellen einer 2D-UWP-App finden Sie im Artikel Erstellen Ihrer ersten App .

Einbinden einer vorhandenen 2D Store-App in UWP

Wenn Sie bereits über eine 2D-Windows-App im Store verfügen, stellen Sie sicher, dass sie auf die Windows 10 Universelle Windows-Plattform (UWP) ausgerichtet ist. Hier sind alle möglichen Ausgangspunkte, die Sie mit Ihrer Store-App heute haben können:

Startpunkt	AppX-Manifestplattformziel	Wie macht man diese universell?
Windows Phone (Silverlight)	Silverlight-App-Manifest	Migrieren zu WinRT
Windows Phone 8.1 Universal	8.1 AppX-Manifest ohne Plattformziel	Migrieren Ihrer App zum Universelle Windows-Plattform
Windows Store 8	8 AppX-Manifest ohne Plattformziel	Migrieren Ihrer App zum Universelle Windows-Plattform
Windows Store 8.1 Universal	8.1 AppX-Manifest ohne Plattformziel	Migrieren Ihrer App zum Universelle Windows-Plattform

Wenn Sie heute eine 2D Unity-App als Win32-App auf dem PC, Mac & eigenständigen Linux-Buildziel haben, wechseln Sie zum Universelle Windows-Plattform Buildziel für Mixed Reality.

Wir erläutern, wie Sie Ihre App mithilfe der folgenden Windows.Holographic-Gerätefamilie speziell auf HoloLens beschränken können.

Ausführen Ihrer 2D-App in einem Windows Mixed Reality immersiven Headset

Wenn Sie Ihre 2D-App auf einem Desktopcomputer bereitgestellt und auf Ihrem Monitor ausprobiert haben, können Sie sie auf einem immersiven Desktop-Headset ausprobieren!

Wechseln Sie einfach zum Startmenü innerhalb des Mixed Reality-Headsets, und starten Sie die App von dort aus. Die Desktopshell und die holografische Shell verwenden denselben Satz von UWP-Apps, sodass die App bereits vorhanden sein sollte, nachdem Sie über Visual Studio bereitgestellt haben.

Ziel sowohl für immersive Headsets als auch für HoloLens

Herzlichen Glückwunsch! Ihre App verwendet jetzt die Windows 10 Universelle Windows-Plattform (UWP).

Ihre App kann jetzt auf heutigen Windows-Geräten wie Desktop, Mobile, Xbox, Windows Mixed Reality immersive Headsets, HoloLens und zukünftigen Windows-Geräten ausgeführt werden. Um jedoch alle diese Geräte als Ziel zu verwenden, müssen Sie sicherstellen, dass Ihre App auf Windows ausgerichtet ist. Universelle Gerätefamilie.

Ändern Ihrer Gerätefamilie in Windows.Universal

Lassen Sie uns nun in Ihr AppX-Manifest springen, um sicherzustellen, dass Ihre Windows 10 UWP-App auf HoloLens ausgeführt werden kann:

Öffnen Sie die Lösungsdatei Ihrer App mit Visual Studio , und navigieren Sie zum App-Paketmanifest.
Klicken Sie mit der rechten Maustaste auf die Datei Package.appxmanifest in Ihrer Projektmappe, und wechseln Sie zu Code anzeigen.

Stellen Sie sicher, dass Ihre Zielplattform Windows ist. Universell im Abschnitt "Abhängigkeiten"

<Dependencies>
  <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.10240.0" MaxVersionTested="10.0.10586.0" />
</Dependencies>

Speichern!

Wenn Sie Visual Studio nicht für Ihre Entwicklungsumgebung verwenden, können Sie AppXManifest.xml im Text-Editor Ihrer Wahl öffnen, um sicherzustellen, dass Sie windows.UniversalTargetDeviceFamily als Ziel verwenden.

Ausführen im HoloLens-Emulator

Nachdem Ihre UWP-App nun auf "Windows.Universal" ausgerichtet ist, erstellen wir Ihre App und führen sie im HoloLens-Emulator aus.

Stellen Sie sicher, dass Sie den HoloLens-Emulator installiert haben.
Wählen Sie in Visual Studio die x86-Buildkonfiguration für Ihre App aus.
Wählen Sie im Dropdownmenü für das Bereitstellungsziel HoloLens-Emulator aus.
Wählen Sie Debuggen > Debuggen starten aus, um Ihre App bereitzustellen und mit dem Debuggen zu beginnen.
Der Emulator startet und führt Ihre App aus.
Platzieren Sie Ihre App mit einer Tastatur, Maus und einem Xbox-Controller in der Welt, um sie zu starten.

Nächste Schritte

An diesem Punkt kann eine von zwei Dingen passieren:

Ihre App zeigt ihren Begrüßungsvorgang an und beginnt mit der Ausführung, nachdem sie im Emulator platziert wurde! Prima.
Oder nachdem Sie eine Ladeanimation für ein 2D-Hologramm angezeigt haben, wird das Laden beendet, und Ihre App wird nur auf dem Begrüßungsbildschirm angezeigt. Dies bedeutet, dass etwas schief gegangen ist und es mehr Untersuchungen erfordert, um zu verstehen, wie Sie Ihre App in Mixed Reality zum Leben erwecken können.

Sie müssen debuggen, um zum Stamm möglicher Probleme zu gelangen, die verhindern, dass Ihre UWP-App auf HoloLens gestartet wird.

Ausführen Ihrer UWP-App im Debugger

Diese Schritte führen Sie durch das Debuggen Ihrer UWP-App mithilfe des Visual Studio-Debuggers.

Wenn Sie dies noch nicht getan haben, öffnen Sie Ihre Projektmappe in Visual Studio. Ändern Sie das Ziel in den HoloLens-Emulator und die Buildkonfiguration in x86.
Wählen Sie Debuggen > Debuggen starten aus, um Ihre App bereitzustellen und mit dem Debuggen zu beginnen.
Platzieren Sie die App in der Welt mit Ihrer Maus, Tastatur oder Ihrem Xbox-Controller.
Visual Studio sollte nun irgendwo in Ihrem App-Code unterbrochen werden.
- Wenn Ihre App aufgrund eines nicht behandelten Fehlers nicht sofort abstürzt oder in den Debugger einbricht, durchlaufen Sie einen Testdurchlauf der Kernfeatures Ihrer App, um sicherzustellen, dass alles ausgeführt und funktioniert. Möglicherweise sehen Sie Fehler wie unten dargestellt (interne Ausnahmen, die behandelt werden). Führen Sie Ihre automatisierten Tests und Komponententests durch, um sicherzustellen, dass sie keine internen Fehler verpassen, die sich auf die App auswirken.

HoloLens-Emulator, geladen mit einem UWP-Beispiel mit einer Systemausnahmeregelung

Aktualisieren Der Benutzeroberfläche

Nachdem Ihre UWP-App nun auf immersiven Headsets und HoloLens als 2D-Hologramm ausgeführt wird, stellen wir als Nächstes sicher, dass sie schön aussieht. Folgende Punkte sollten berücksichtigt werden:

Windows Mixed Reality führt alle 2D-Apps mit einer festen Auflösung und DPI aus, die 853 x 480 effektive Pixel entspricht. Überlegen Sie, ob Ihr Design in dieser Größenordnung verfeinern muss, und lesen Sie die unten stehende Entwurfsanleitung, um Ihre Erfahrung mit HoloLens und immersiven Headsets zu verbessern.
Windows Mixed Reality unterstützt keine 2D-Livekacheln. Wenn Ihre Kernfunktionalität Informationen auf einer Livekachel anzeigt, sollten Sie diese Informationen wieder in Ihre App verschieben oder 3D-App-Startprogramme erkunden.

Auflösung und Skalierungsfaktor der 2D-App-Ansicht

Von responsivem Design

Windows 10 das gesamte visuelle Design von echten Bildschirmpixeln zu effektiven Pixeln verschiebt. Das bedeutet, dass Entwickler ihre Benutzeroberfläche gemäß den Richtlinien für die Windows 10 Human Interface für effektive Pixel entwerfen, und die Windows-Skalierung stellt sicher, dass diese effektiven Pixel die richtige Größe für die Geräte- und Auflösungen, DPI usw. haben. Weitere Informationen finden Sie in diesem artikel auf MSDN und in dieser BUILD-Präsentation .

Selbst mit der einzigartigen Möglichkeit, Apps in Ihrer Welt in einer Reihe von Entfernungen zu platzieren, werden TV-ähnliche Entfernungen empfohlen, um die beste Lesbarkeit und Interaktion mit Blick/Geste zu erzielen. Aus diesem Gründen zeigt eine virtuelle Seite im Mixed Reality Home Ihre flache UWP-Ansicht an:

1280x720, 150%DPI (853x480 effektive Pixel)

Diese Auflösung hat mehrere Vorteile:

Dieses effektive Pixellayout weist etwa die gleiche Informationsdichte wie ein Tablet oder einen kleinen Desktop auf.
Es entspricht den festen DPI-Werten und effektiven Pixeln für UWP-Apps, die auf Xbox One ausgeführt werden, und ermöglicht eine nahtlose Geräteumgebung.
Diese Größe sieht gut aus, wenn sie über unser Spektrum an Betriebsdistanzen für Apps in der Welt skaliert wird.

Bewährte Methoden für den Entwurf der 2D-App-Ansichtsschnittstelle

Gehen Sie wie folgt vor:

Befolgen Sie die Windows 10 Human Interface Guidelines (HIG) für Stile, Schriftgrößen und Schaltflächengrößen. HoloLens übernimmt die Arbeit, um sicherzustellen, dass Ihre App über kompatible App-Muster, lesbare Textgrößen und eine geeignete Trefferzielgröße verfügt.
Stellen Sie sicher, dass Ihre Benutzeroberfläche den bewährten Methoden für reaktionsfähiges Design entspricht, um die eindeutige Auflösung und DPI von HoloLens optimal zu betrachten.
Verwenden Sie die Empfehlungen für das "helle" Farbdesign von Windows.

Vermeiden Sie Folgendes:

Ändern Sie Ihre Benutzeroberfläche in Mixed Reality zu drastisch, um sicherzustellen, dass Benutzer eine vertraute Erfahrung mit und aus dem Headset haben.

Grundlegendes zum App-Modell

Das App-Modell für Mixed Reality ist für die Verwendung des Mixed Reality Home konzipiert, in dem viele Apps zusammen leben. Stellen Sie sich dies als Mixed Reality-Äquivalent des Desktops vor, auf dem Sie viele 2D-Apps gleichzeitig ausführen. Dies hat Auswirkungen auf den App-Lebenszyklus, Kacheln und andere wichtige Features Ihrer App.

App-Leiste und Schaltfläche "Zurück"

2D-Ansichten werden mit einer App-Leiste über ihrem Inhalt ergänzt. Die App-Leiste weist zwei Punkte der app-spezifischen Personalisierung auf:

Titel: Zeigt den Anzeigenamen der Kachel an, die der App-instance

Zurück-Schaltfläche: Löst beim Drücken das BackRequested-Ereignis aus. Die Sichtbarkeit der Schaltfläche "Zurück" wird von SystemNavigationManager.AppViewBackButtonVisibility gesteuert.

Benutzeroberfläche der App-Leiste in der 2D-App-Ansicht

Testen des Designs Ihrer 2D-App

Es ist wichtig, ihre App zu testen, um sicherzustellen, dass der Text lesbar ist, die Schaltflächen zielfähig sind und die App insgesamt korrekt aussieht. Sie können tests auf einem Desktop-Headset, einer HoloLens, einem Emulator oder einem Touchgerät mit einer Auflösung von 1280 x 720 @150 % durchführen.

Neue Eingabemöglichkeiten

HoloLens verwendet erweiterte Tiefensensoren, um die Welt zu sehen und Benutzer zu sehen. Dies ermöglicht erweiterte Handgesten wie Bloom und Air-Tap. Leistungsstarke Mikrofone ermöglichen auch Spracherlebnisse.

Mit Desktop-Headsets können Benutzer Motion-Controller verwenden, um auf Apps zu zeigen und Maßnahmen zu ergreifen. Sie können auch ein Gamepad verwenden, das Objekte mit ihrem Blick anvisieren soll.

Windows übernimmt all diese Komplexität für UWP-Apps und übersetzt Ihre Blick-, Gesten-, Sprach- und Bewegungscontrollereingaben in Zeigerereignisse , die den Eingabemechanismus abstrahieren. Beispielsweise kann ein Benutzer mit der Hand einen Luftklick ausgeführt oder den Select-Trigger auf einen Motion Controller gezogen haben, aber 2D-Anwendungen müssen nicht wissen, woher die Eingabe stammt – sie sehen einfach einen 2D-Touch-Druck, wie auf einem Touchscreen.

Im Folgenden finden Sie die allgemeinen Konzepte/Szenarien, die Sie für die Eingabe verstehen sollten, wenn Sie Ihre UWP-App auf HoloLens übertragen:

Das Anvisieren wird zu Hoverereignissen, die unerwartet Menüs, Flyouts oder andere Benutzeroberflächenelemente auslösen können, indem Sie einfach ihre App betrachten.
Das Anvisieren ist nicht so präzise wie die Mauseingabe. Verwenden Sie Trefferziele mit angemessener Größe für HoloLens, ähnlich wie touchfreundliche mobile Anwendungen. Kleine Elemente in der Nähe der Ränder der App sind besonders schwer zu interagieren.
Benutzer müssen die Eingabemodi wechseln, um vom Scrollen zum Ziehen auf zwei Finger zu wechseln. Wenn Ihre App für Toucheingaben entwickelt wurde, sollten Sie sicherstellen, dass keine wichtigen Funktionen hinter dem Schwenken mit zwei Fingern gesperrt sind. Wenn ja, sollten Sie alternative Eingabemechanismen wie Schaltflächen verwenden, die das Schwenken mit zwei Fingern starten können. Die Karten-App kann z. B. mit zwei Fingern zoomen, verfügt aber über eine Plus-, Minus- und Drehschaltfläche, um die gleichen Zoominteraktionen mit nur einem Klick zu simulieren.

Die Spracheingabe ist ein wichtiger Bestandteil der Mixed Reality-Erfahrung. Wir haben alle Sprach-APIs aktiviert, die sich in Windows 10 Cortana bei Verwendung eines Headsets befinden.

Veröffentlichen und Verwalten Ihrer universellen App

Sobald Ihre App aktiv ist und ausgeführt wird, packen Sie Ihre App , um sie an den Microsoft Store zu übermitteln.