Aktualisierung auf AR Foundation Version 5.x (Beta)

Die ARCore-Erweiterungen für die AR Foundation von Unity unterstützen sowohl die Versionen 4.x als auch die Version 5.x von AR Foundation. So aktualisieren Sie ein vorhandenes AR Foundation 5.x-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. Die ARCore-Erweiterungen für die AR Foundation von Unity verwenden das benutzerdefinierte Skriptsymbol ARCORE_USE_ARF_5, um die Versionskompatibilität zu bestimmen. Fügen Sie für die Kompatibilität mit AR Foundation 5.x das benutzerdefinierte Skriptsymbol ARCORE_USE_ARF_5 hinzu:

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

    Damit sowohl das Input System-Paket als auch der ältere Input Manager unterstützt werden, setzen Sie unter Projekteinstellungen > Player > Andere Einstellungen die Option Aktive Eingabeverarbeitung auf Beides.

  4. Folgen Sie den anderen Schritten in den Upgrade- und Migrationsleitfäden für AR Foundation von Unity.