Migrieren eines Unity 2019-Projekts zu Unity 2020 + OpenXR

Artikel
01/11/2025

Für die reibungsloseste Migration empfehlen wir, alle Schritte in diesem Artikel in der dargestellten Reihenfolge auszuführen. Hier ist eine Übersicht über die wichtigsten Schritte:

Aktualisieren Sie MRTK auf die neueste stabile Version.
Verschieben Sie Ihr Projekt zu Unity 2019 XR Plug-In Management.
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, empfehlen wir, dass der erste Schritt in Ihrer Migration darin bestehen sollte, das Mixed Reality Feature Tool auszuführen und auf die neueste stabile Version von MRTK zu 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 Element übereinstimmen, stellen Sie sicher, dass Sie keine ältere Version des Tools verwenden.

Öffnen Sie das Microsoft Mixed Reality-Featuretool, 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 entdecken 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 dem 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, 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 Besagt, dass Ihre Pakete importiert werden.

Durch dieses Upgrade während der Verwendung von Unity 2019 können Sie den MRTK-Projektkonfigurator anzeigen und alle Warnungen "veraltete API" anzeigen, wie Sie auf dem aktuellen Stand sind. Die Warnungen informieren Sie, was sie ändern müssen. Wenn Sie dieses MRTK-Upgrade nicht zuerst ausführen, ist die alte API möglicherweise nicht mehr vorhanden, und Sie haben diese Warnungen nicht.

Erfahren Sie mehr über das Mixed Reality-Featuretool.

2. Verschieben Ihres Projekts in unity 2019 XR Plug-In Management

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üleiste "Projekteinstellungen bearbeiten"> aus.
Wählen Sie in der linken Spalte des Fensters "Projekteinstellungen" die Option "XR-Plug-In-Verwaltung" aus.

An diesem Punkt wird möglicherweise eine Schaltfläche mit der Bezeichnung "XR-Plug-In-Verwaltung installieren" angezeigt. Wenn ja, fahren Sie mit den nachstehenden 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" aus.

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

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

Wir sind noch nicht bereit, OpenXR zu installieren, aber dieser nächste Schritt hilft Ihnen, alle APIs zu bereinigen, die nur verfügbar und auf dem "Integrierten XR"-Pfad unterstützt wurden. (Wenn Sie MRTK verwenden, werden die meisten 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 auf holoLens 2 abzielen:
  Stellen Sie sicher, dass Sie sich auf der Registerkarte Universelle Windows-Plattform befinden (die zweite Registerkarte und zeigt das Windows-Logo an), und wählen Sie dann unter Plug-In-Anbieter Windows Mixed Reality aus.
- Wenn Sie auf Desktop VR abzielen:
  Stellen Sie sicher, dass Sie sich auf der Registerkarte "Desktop" befinden (die erste Registerkarte und zeigt ein Bild eines Monitors an), und wählen Sie dann unter Plug-In-Anbieter Windows Mixed Reality aus.
Das MRTK-Projektkonfiguratorfenster wird erneut angezeigt. Klicken Sie auf die Schaltfläche "Weiter ", und klicken Sie dann erneut auf "Weiter" . (Sie können sich einen Moment Zeit nehmen, um die Erklärungen auf diesen Seiten zu lesen, bevor Sie fortfahren.)
Wählen Sie "TMP Essentials importieren" aus.
Wählen Sie Fertig aus. Damit wird der Konfigurator geschlossen.
Schließen Sie das Fenster "Projekteinstellungen" , speichern Sie Ihr Projekt, und beenden Sie dann Unity.

4. Upgrade auf Unity 2020.3 LTS

Installieren Sie die neueste LTS-Patchversion 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 an AR Foundation 4.0 weitergeleitet.

5. Verwenden Sie das Mixed Reality-Featuretool, um weitere Pakete zu installieren.

Verwenden Sie das Mixed Reality-Featuretool, um die folgenden Pakete zu importieren.

Öffnen Sie die Dropdownliste "Plattformsupport ", und wählen Sie die neueste Version des Mixed Reality OpenXR-Plug-Ins 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 "Übernehmen" aus.
Es wird ein Dialogfeld angezeigt, in dem angegeben wird, 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 Laufzeit festlegen:

Wählen Sie in der Menüleiste Bearbeiten>Projekteinstellungen 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 der Plug-In-Anbieter "OpenXR" aus.
Wählen Sie im selben Abschnitt die Featuregruppe "Microsoft HoloLens" 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, 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-Featuregruppen" Microsoft HoloLens aus, und wählen Sie dann "Hand tracking" und "Motion Controller Model" aus, wenn 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.