Aktualisierung auf AR Foundation Version 5.x (Beta)

ARCore Extensions für die AR Foundation von Unity unterstützen sowohl Version 4.x als auch Version 5.x der AR Foundation. So aktualisieren Sie Ihr vorhandenes AR-Projekt von AR Foundation 4.x auf AR Foundation 5.x:

  1. Nur in Unity 2021.x oder älter:
    Einige Unity-Pakete sind an bestimmte Unity-Editor-Versionen gebunden. Möglicherweise müssen Sie das Paketmanifest in Ihrem Unity-Projekt bearbeiten, um in bestimmten Unity Editor-Versionen auf AR Foundation 5.x zu aktualisieren. Weitere Informationen finden Sie unter Auf AR Foundation 5.0 in Unity 2021 zugreifen.

    Die Datei Packages/manifest.json muss diese Versionen für die folgenden Pakete enthalten:

    "dependencies": {
      -- other dependencies --
      "com.unity.xr.arcore": "5.0.5",
      "com.unity.xr.arfoundation": "5.0.5",
      "com.unity.xr.arkit": "5.0.5",
      -- other dependencies --
    }
    
  2. ARCore Extensions for Unity's AR Foundation nutzt das benutzerdefinierte Skriptsymbol ARCORE_USE_ARF_5, um die Versionskompatibilität zu ermitteln. Fügen Sie das benutzerdefinierte Skriptsymbol ARCORE_USE_ARF_5 hinzu, um die Kompatibilität mit AR Foundation 5.x zu gewährleisten:

    1. Scrollen Sie unter Bearbeiten > Projekteinstellungen > Player > Andere Einstellungen nach unten zu Skriptkompilierung.
    2. Verwenden Sie die Schaltfläche +, um ARCORE_USE_ARF_5 hinzuzufügen.
    3. Klicken Sie auf Anwenden.
  3. AR Foundation 5.x erfordert aufgrund einer Abhängigkeit von TrackedPoseDriver das Input System-Paket. Die Beispielszenen für ARCore-Erweiterungen erfordern das alte Eingabemodul.

    Um sowohl das Input System-Paket als auch den älteren Input Manager zu unterstützen, setzen Sie unter Projekteinstellungen > Player > Andere Einstellungen die Option Active Input Handling auf Beide.

  4. Führen Sie die anderen Schritte in den Upgrade- und Migrationsleitfäden für AR Foundation von Unity aus.