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

Im November 2022 werden in den Google Play-Diensten für AR eingestellte Methoden entfernt, die sich auf NDK-Kamerabilder und ‑Metadaten beziehen.

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

Betroffene Apps

Ab November 2022 funktioniert Ihre App möglicherweise nicht mehr oder stürzt ab, wenn Nutzer auf die neueste Version der Google Play-Dienste für AR aktualisieren. Das ist in folgenden Fällen möglich:

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

Wenn Ihre App mit der ARCore SDK-Version compiled wurde,…	und die betroffenen APIs verwendet…	Verhalten bei Unterbrechungen ab November 2022
1.22.0 oder niedriger	`ArImage_getNdkImage()` (im ARCore SDK 1.23.0 entfernt)	Gibt `NULL` in der resultierenden `AImage`-Struktur zurück.
1.22.0 oder niedriger	`ArImage_getNdkCameraMetadata()` (im ARCore SDK 1.23.0 entfernt)	Gibt `NULL` in der resultierenden `ACameraMetadata`-Struktur zurück.

Betroffene Apps korrigieren

Bei betroffenen Apps kann es im November 2022 zu Problemen kommen. Verwenden Sie Drop-in-Ersetzungen für die betroffenen Methoden, um dieses Problem zu vermeiden:

Methoden ArImage_getNdkImage() und AImage_*: 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 das Problem mit der betroffenen App behoben ist

Testen Sie die App, indem Sie die Änderungen vom November 2022 vorab simulieren. Fügen Sie dazu der AndroidManifest.xml Ihrer App einen speziellen meta-data-Eintrag hinzu:

Auf dem Zielgerät muss Play Services for AR Version 1.29.0 oder höher installiert sein.

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

<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>

Testen Sie Ihre App und prüfen Sie, ob alle ARCore-Funktionen wie erwartet funktionieren.
Entfernen Sie das <meta-data>-Tag, wenn der Test abgeschlossen ist. Wenn Sie dieses Tag in Ihrer veröffentlichten App beibehalten, kann es in Zukunft zu unerwartetem Verhalten kommen.

Wenn die App normal funktioniert, ist sie für die Änderungen im November 2022 bereit.

Zeitachse

Zeitraum	Ereignisse
November 2020 (ARCore SDK-Version 1.20.0)	Betroffene APIs einstellen und Drop-in-API-Alternativen einführen.
Februar 2021 (ARCore SDK-Version 1.23.0)	Entfernen Sie die Signaturen für zuvor eingestellte APIs aus dem ARCore SDK.
November 2021	Ankündigung einer bevorstehenden funktionsgefährdenden Änderung aufgrund der bevorstehenden Entfernung der Implementierung der betroffenen APIs aus den Google Play-Diensten für AR im November 2022.
November 2022	Entfernen Sie die Implementierung der betroffenen APIs aus den Google Play-Diensten für AR. Einführung einer nicht abwärtskompatiblen Änderung für Apps, die ARCore-Versionen vor 1.23.0 verwenden.