Migrieren eines Unity 2019-Projekts zu Unity 2020 + OpenXR

Artikel
07/12/2023

Für eine möglichst reibungslose Migration wird empfohlen, dass Sie alle Schritte in diesem Artikel in der angegebenen Reihenfolge ausführen. Im Folgenden finden Sie eine Übersicht über die wichtigsten Schritte:

Aktualisieren Sie MRTK auf die neueste stabile Version.
Verschieben Sie Ihr Projekt zur XR-Plug-In-Verwaltung von Unity 2019.
Wählen Sie "Windows Mixed Reality" aus.
Upgrade auf Unity 2020.3 LTS.
Verwenden Sie das Mixed Reality-Featuretool, um weitere Pakete zu installieren.
Konfigurieren Sie die XR-Plug-In-Verwaltung für OpenXR.

1. Aktualisieren Von MRTK auf die neueste stabile Version

Wenn Sie MRTK bereits verwenden, sollten Sie zunächst das Mixed Reality Feature Tool ausführen und auf die neueste stabile Version von MRTK aktualisieren.

Wählen Sie die gewünschten Features aus.

Hinweis

Die Beschreibungen und Bilder in diesem Abschnitt basieren auf der neuesten Version des Tools. Wenn die Anweisungen nicht mit dem Angezeigten übereinstimmen, überprüfen Sie, ob Sie keine ältere Version des Tools verwenden.

Öffnen Sie das Microsoft Mixed Reality Feature Tool, und klicken Sie dann auf die Schaltfläche Start.
Wählen Sie die Schaltfläche „Durchsuchen“ aus (in der folgenden Abbildung ist dies die Schaltfläche mit den drei Punkten), navigieren Sie zu Ihrem Projekt, und öffnen Sie es.
Wählen Sie Features ermitteln aus.

Hinweis: Möglicherweise müssen Sie einige Sekunden warten, während das Tool die Pakete aus den Feeds aktualisiert.
Beachten Sie, dass auf der Seite Features entdecken eine Liste von sechs Paketgruppen angezeigt wird.
Klicken Sie links neben Mixed Reality Toolkit auf die Schaltfläche "+", und wählen Sie dann die neueste Version von Mixed Reality Toolkit Foundation aus.

Importieren der Features

Nachdem Sie Ihre Auswahl getroffen haben, klicken Sie auf Features abrufen.
Auf der Seite Features importieren werden in der linken Spalte Features die Pakete angezeigt, die Sie gerade ausgewählt haben. In der rechten Spalte Erforderliche Abhängigkeiten werden alle Abhängigkeiten angezeigt. Sie können für jedes dieser Elemente auf den Link Details klicken, um mehr darüber zu erfahren.
Wenn Sie bereit sind fortzufahren, wählen Sie Importieren aus. Auf der Seite Überprüfen und genehmigen können Sie die Informationen zu den Paketen überprüfen.
Wählen Sie Genehmigen aus. Das Featuretool zeigt eine Meldung an, die besagt, dass Ihr Projekt aktualisiert wurde.
Kehren Sie zum Unity-Editor zurück, und klicken Sie auf der Benutzeroberfläche auf einen leeren Bereich. Es wird eine Meldung angezeigt, die Sie darüber informiert, dass Ihre Pakete importiert werden.

Wenn Sie dieses Upgrade durchführen, während Sie Unity 2019 verwenden, können Sie den MRTK-Projektkonfigurator anzeigen und alle Warnungen der "veralteten API" anzeigen, wie Sie auf dem neuesten Stand sind. In den Warnungen erfahren Sie, was Sie ändern müssen. Wenn Sie dieses MRTK-Upgrade nicht zuerst durchführen, ist die alte API möglicherweise nicht mehr vorhanden, und Diese Warnungen werden nicht angezeigt.

Erfahren Sie mehr über das Mixed Reality-Featuretool.

2. Verschieben Ihres Projekts zur XR-Plug-In-Verwaltung von Unity 2019

Nachdem Sie MRTK aktualisiert haben, können Sie Unity 2019 anweisen, die XR-Plug-In-Verwaltung zu verwenden.

Wählen Sie im Unity-Editor auf der MenüleisteProjekteinstellungenbearbeiten> aus.
Wählen Sie in der linken Spalte des Fensters Projekteinstellungendie Option XR-Plug-In-Verwaltung aus.

An diesem Punkt wird möglicherweise eine Schaltfläche mit der Schaltfläche XR-Plug-In-Verwaltung installieren angezeigt. Wenn ja, fahren Sie mit den folgenden Schritten fort. Wenn Sie das XR-Verwaltungssystem bereits installiert haben, können Sie die restlichen Schritte in diesem Abschnitt überspringen und mit dem nächsten Abschnitt fortfahren, "Wählen Sie 'Windows Mixed Reality'".

Klicken Sie auf die Schaltfläche Install XR Plugin Management (XR-Plug-In-Verwaltung installieren).
Es wird ein Dialogfeld mit dem Namen In VR erkannt erstellt angezeigt, in dem Sie gefragt werden, ob Sie das integrierte VR-Paket entfernen möchten. Klicken Sie auf OK.
Das Dialogfeld Integrierte VR aktiviert wird angezeigt. Klicken Sie auf OK. Dadurch wird die integrierte VR deaktiviert.
Das Fenster MRTK-Projektkonfigurator wird angezeigt und fordert Sie auf, eine XR-Pipeline zu aktivieren. Wählen Sie die zweite Option XR SDK/SR-Verwaltung aus.
Klicken Sie auf der nächsten Seite im Konfigurator auf Einstellungen anzeigen.

3. Wählen Sie "Windows Mixed Reality" aus.

Wir sind noch nicht ganz bereit, OpenXR zu installieren, aber diese nächsten Schritte helfen Ihnen, sauber für alle APIs zu erhalten, die nur im Pfad "Integrierte XR" verfügbar und unterstützt wurden. (Wenn Sie MRTK verwenden, ist der Großteil davon für Sie abstrahiert.)

Stellen Sie im Fenster Projekteinstellungen des Unity-Editors sicher, dass Sie sich auf der Seite XR-Plug-In-Verwaltung befinden.
Führen Sie eines der folgenden Verfahren aus:
- Wenn Sie die HoloLens 2 als Ziel verwenden:
  Stellen Sie sicher, dass Sie sich auf der Registerkarte Universelle Windows-Plattform befinden (dies ist die zweite Registerkarte mit dem Windows-Logo), und wählen Sie dann unter Plug-in-Providersdie Option Windows Mixed Reality aus.
- Wenn Sie Desktop VR als Ziel verwenden:
  Stellen Sie sicher, dass Sie sich auf der Registerkarte Desktop befinden (dies ist die erste Registerkarte, auf der ein Bild eines Monitors angezeigt wird), und wählen Sie dann unter Plug-in-Providersdie Option Windows Mixed Reality aus.
Das MRTK-Projektkonfigurator-Fenster wird erneut angezeigt. Klicken Sie auf die Schaltfläche Weiter , und klicken Sie dann erneut auf Weiter . (Sie sollten sich einen Moment Zeit nehmen, um die Erläuterungen auf diesen Seiten zu lesen, bevor Sie weiterarbeiten.)
Wählen Sie TMP Essentials importieren aus.
Wählen Sie Fertigaus. Dadurch wird der Configurator geschlossen.
Schließen Sie das Fenster Projekteinstellungen , speichern Sie Ihr Projekt, und beenden Sie Unity.

Hinweis

Wenn Sie die XR-Plug-In-Verwaltung in Unity 2019 verwenden, wird Azure Spatial Anchors (ASA) nicht unterstützt. Wenn Ihr Projekt ÜBER ASA-Code verfügt, können Sie es erst testen, nachdem Sie Unity 2020 installiert haben. Andernfalls sollten Sie in dieser Phase in der Lage sein, Ihre App zu überprüfen.

4. Upgrade auf Unity 2020.3 LTS

Installieren Sie das neueste LTS-Patchrelease von Unity 2020.3.
Öffnen Sie Ihr Unity 2019-Projekt in Unity 2020.3.

Es wird ein Dialogfeld angezeigt, in dem Sie gefragt werden, ob Sie Ihr Projekt auf eine neuere Version von Unity aktualisieren möchten. Klicken Sie auf BESTÄTIGEN.

Wenn Sie zuvor AR Foundation 2.0 verwendet haben, werden Sie automatisch zu AR Foundation 4.0 weitergeleitet.

5. Verwenden Sie das Mixed Reality Feature Tool, um weitere Pakete zu installieren.

Verwenden Sie das Mixed Reality Feature Tool, um die folgenden Pakete zu importieren.

Wenn Sie ASA verwenden, öffnen Sie die Dropdownliste Azure Mixed Reality Services, und wählen Sie die neueste Version von Azure Spatial Anchors SDK Core und Azure Spatial Anchors SDK für Windows aus.
Öffnen Sie die Dropdownliste Plattformunterstützung, und wählen Sie die neueste Version von Mixed Reality OpenXR-Plug-In aus.
Nach dem Laden der Pakete wird ein Warndialogfeld angezeigt, in dem Sie gefragt werden, ob Sie den Unity-Editor neu starten möchten, um Back-Ends zu aktivieren. Wählen Sie Ja aus.
Wenn Unity erneut geöffnet wird, wird der MRTK-Projektkonfigurator angezeigt. Nehmen Sie sich einen Moment Zeit, um die Erläuterungen im Fenster zu lesen, und wählen Sie dann Anwenden aus.
Es wird ein Dialogfeld mit dem Hinweis angezeigt, dass Unity neu gestartet werden muss, damit das Eingabesystem wirksam wird. Wählen Sie Übernehmen.

6. Konfigurieren der XR-Plug-In-Verwaltung für OpenXR

Nachdem Unity erneut geöffnet wurde, können Sie OpenXR als Runtime festlegen:

Wählen Sie auf der MenüleisteProjekteinstellungenbearbeiten> aus.

Suchen Sie in der linken Spalte, und stellen Sie sicher, dass Sie sich auf der Seite XR-Plug-In-Verwaltung und auf der Registerkarte Universelle Windows-Plattform befinden (auf der Registerkarte befindet sich ein Bild des Windows-Logos).
Wählen Sie in der Liste Plug-In-Anbieterdie Option OpenXR aus.
Wählen Sie im gleichen Abschnitt Microsoft HoloLens Featuregruppe aus.
Beachten Sie, dass nun ein gelbes Warndreieck neben OpenXR angezeigt wird. Bewegen Sie den Cursor auf das Dreieck, lesen Sie die Meldung im Popupfenster, und wählen Sie dann das Dreieck aus.
Im Fenster OpenXR-Projektüberprüfung sind mehrere Probleme aufgeführt. Wählen Sie die Schaltfläche Alle korrigieren aus.
Ein Problem bleibt bestehen und weist Sie darauf hin, dass Sie mindestens ein Interaktionsprofil hinzufügen müssen. Klicken Sie dazu auf Bearbeiten. Dadurch gelangen Sie zu den Einstellungen für das OpenXR-Plug-In im Fenster Projekteinstellungen .
Wählen Sie dreimal die Pluszeichenschaltfläche (+) aus, jedes Mal, wenn Sie ein anderes Profil auswählen:

Profil „Interaktionen per Eyetracking“

Profil „Interaktionen per Hand“

Profil „Microsoft Motion-Controller“

Wenn das Profil „Interaktionen per Eyetracking“ oder ein anderes Profil mit einem gelben Dreieck daneben angezeigt wird, wählen Sie das Dreieck aus, und klicken Sie dann im Fenster OpenXR-Projektüberprüfung auf die Schaltfläche Korrigieren.
Wählen Sie im Abschnitt OpenXR-Featuregruppendie Option Microsoft HoloLens und dann Handverfolgungs- und Bewegungscontrollermodell aus, falls sie noch nicht ausgewählt sind.
Klicken Sie auf die Dropdownliste Depth Submission Mode (Übermittlungsmodus Tiefe), und wählen Sie dann Depth 16 Bit (Tiefe 16 Bit) aus.
Schließen Sie das Fenster Projekteinstellungen und alle anderen Fenster, die noch geöffnet sind.