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

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 des ARCore SDK 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:

Deine App wurde mit einem betroffenen SDK kompiliert
Ihre Anwendung verwendet eine der folgenden betroffenen APIs:

Wenn Ihre App mit der ARCore SDK-Version kompiliert wurde...	Und verwendet betroffene APIs...	Verhalten ab November 2022
1.22.0 oder niedriger	`ArImage_getNdkImage()` (in ARCore SDK 1.23.0 entfernt)	Gibt `NULL` in der resultierenden `AImage`-Struktur zurück.
1.22.0 oder niedriger	`ArImage_getNdkCameraMetadata()` (in ARCore SDK 1.23.0 entfernt)	Gibt `NULL` in der resultierenden `ACameraMetadata`-Struktur zurück.

Probleme mit betroffenen Apps beheben

Bei betroffenen Apps treten ab November 2022 Probleme auf. Um dies zu vermeiden, verwenden Sie Drop-in-Ersatz für die betroffenen Methoden:

ArImage_getNdkImage()- und AImage_*-Methoden: Verwenden Sie die entsprechenden Methoden aus ArImage. Beispiel:
- AImage_getNumberOfPlanes() wird zu ArImage_getNumberOfPlanes()
- AImage_getPlaneData() wird zu ArImage_getPlaneData()
ArImage_getNdkCameraMetadata(): Verwenden Sie stattdessen ArImageMetadata_getConstEntry().

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:

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

Fügen Sie in der Datei AndroidManifest.xml 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>

Teste deine App und prüfe, ob alle ARCore-Funktionen wie erwartet funktionieren.
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)	Betroffene APIs einstellen und Alternativen für Drop-in-APIs einführen
Februar 2021 (ARCore SDK-Version 1.23.0)	Zuvor eingestellte API-Signaturen aus dem ARCore SDK entfernen
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.