November 2022: Entfernung der Kameramethoden für das ARCore SDK for Android NDK (AR Foundation)

Im November 2022 entfernen die Google Play-Dienste für AR eingestellte Methoden im Zusammenhang mit NDK-Kamerabildern und -Metadaten.

Apps, die diese Methoden in betroffenen Versionen der AR Foundation verwenden, können sich anders verhalten oder abstürzen, wenn Nutzer Google Play-Dienste für AR aktualisieren.

Betroffene Apps

Ab November 2022 funktioniert Ihre App unter Umständen nicht mehr oder stürzt ab, wenn Nutzer ein Update auf die neueste Version der Google Play-Dienste für AR durchführen:

  1. Deine App wurde mit einem betroffenen SDK kompiliert
  2. Ihre Anwendung verwendet eine der folgenden betroffenen APIs:
Wenn Ihre App mit der
AR Foundation Version kompiliert wurde... 		Und verwendet betroffene APIs... Verhalten ab November 2022
AR Foundation 2.1 (Unity 2019 LTS) XRCameraSubsystem.TryGetLatestImage(out XRCameraImage) Gibt false zurück.

Probleme mit betroffenen Apps beheben

Bei betroffenen Apps treten ab November 2022 Probleme auf. Um dies zu vermeiden, aktualisieren Sie auf die neueste Version von AR Foundation, die Ihre Version von Unity unterstützt. Du musst mindestens auf AR Foundation Version 4.x oder höher aktualisieren.

Prüfen, ob die betroffene App behoben ist

Teste die App, indem du vorab die Änderungen von November 2022 simulieren, indem du der AndroidManifest.xml deiner App einen speziellen meta-data-Eintrag hinzufügst:

  1. Achten Sie darauf, dass Play Services for AR Version 1.29.0 oder höher auf dem Zielgerät installiert ist.

  2. Fügen Sie in der benutzerdefinierten AndroidManifest.xml-Datei der App ein neues <meta-data>-Tag als untergeordnetes Element des vorhandenen <application>-Elements hinzu:

    <application …>
  …

  <!--
       Simulate the November 2022 changes in advance.
       IMPORTANT: Remove this tag when testing is completed.
       Do not include this tag in published versions of your app.
  -->
  <meta-data android:name="com.google.ar.core.session_settings"
             android:value="camera_stack_option,unified_mono" />
</application>

  3. Teste deine App und prüfe, ob alle ARCore-Funktionen wie erwartet funktionieren.

  4. Entferne das <meta-data>-Tag, wenn der Test abgeschlossen ist. Wenn Sie dieses Tag in Ihrer veröffentlichten App belassen, kann dies in Zukunft zu unerwartetem Verhalten führen.

Wenn die App normal funktioniert, kann sie ab November 2022 auf die Änderungen umgestellt werden.

Zeitplan

Zeitraum Veranstaltungen
November 2020
(ARCore SDK-Version 1.20.0)		 Native APIs werden eingestellt.
Aktualisieren Sie die Implementierung, um alternative native APIs zu verwenden.
November 2021 Kündigen Sie zukünftige funktionsgefährdende Änderungen an, da die Implementierung der betroffenen APIs im November 2022 aus den Google Play-Diensten für AR entfernt wird.
November 2022 Entfernen Sie die Implementierung der betroffenen APIs aus den Google Play-Diensten für AR.
Für Apps, die ältere ARCore-Versionen als 1.23.0 verwenden, wurden eine funktionsgefährdende Änderung eingeführt.