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

Im November 2022 werden eingestellte Methoden aus den Google Play-Diensten für AR entfernt zu Bildern und Metadaten von NDK-Kameras.

Apps, die diese Methoden in den betroffenen Versionen von das ARCore SDK kann beginnen, sich anders verhalten oder abstürzen, wenn Nutzer die Google Play-Dienste für AR aktualisieren.

Betroffene Apps

Ab November 2022 funktioniert deine App möglicherweise nicht mehr oder stürzt ab, wenn Nutzer eine Aktualisierung vornehmen auf die neueste Version der Google Play-Dienste für AR, wenn:

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

Wenn deine App mit kompiliert wurde ARCore SDK-Version...	Und verwendet betroffene APIs...	Fehlerhaftes 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

Betroffene Apps werden möglicherweise ab November 2022 nicht mehr funktionieren. Um dies zu vermeiden, Verwenden Sie Ersatz-Drop-in-Ersatzmethoden für betroffene Methoden:

ArImage_getNdkImage()- und AImage_*-Methoden: Verwenden Sie entsprechende Methoden aus ArImage. Hier einige Beispiele: <ph type="x-smartling-placeholder">
- 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 wurde

Testen Sie die App, indem Sie die Änderungen von November 2022 im Voraus simulieren. Fügen Sie dazu dem AndroidManifest.xml Ihrer App einen speziellen meta-data-Eintrag hinzu:

Sorgen Sie dafür, dass auf dem Zielgerät mindestens Version 1.29.0 von Play Services for AR installiert ist.

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

<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 zu erwarten war.
Entfernen Sie das <meta-data>-Tag, wenn der Test abgeschlossen ist. Dieses Tag wird verlassen die in Ihrer veröffentlichten App vorhanden sind, zu unerwartetem Verhalten im in der Zukunft.

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

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 zuvor eingestellte API-Signaturen aus dem ARCore SDK.
November 2021	Zukünftige funktionsgefährdende Änderung ankündigen, da die Implementierung aussteht der betroffenen APIs aus den Google Play-Diensten für AR im November 2022.
November 2022	Entfernen Sie die Implementierung der betroffenen APIs aus Google Play-Dienste für AR Führen Sie funktionsgefährdende Änderungen für Apps mit ARCore-Versionen vor dem 1.23.0.