La rimozione dei metodi della fotocamera è stata ritirata a novembre 2022 per l'SDK ARCore per Android NDK (C)

A novembre 2022, Google Play Services per AR rimuoverà i metodi ritirati relative a metadati e immagini delle fotocamere NDK.

App che utilizzano questi metodi nelle versioni interessate di l'SDK ARCore potrebbe iniziare a si comportano in modo diverso o si verificano arresti anomali quando gli utenti aggiornano Google Play Services per AR.

App interessate

A partire da novembre 2022, la tua app potrebbe non funzionare più o arrestarsi in modo anomalo quando gli utenti aggiornano all'ultima versione di Google Play Services per AR se:

La tua app è stata compilata con un SDK interessato
La tua app utilizza una delle seguenti API interessate:

Se la tua app è stata compilata con Versione SDK ARCore...	Inoltre utilizza le API interessate...	Comportamento infranto a partire da novembre 2022
1.22.0 o precedente	`ArImage_getNdkImage()` (rimosso nell'SDK ARCore 1.23.0)	Restituisce `NULL` nello struct `AImage` risultante.
1.22.0 o precedente	`ArImage_getNdkCameraMetadata()` (rimosso nell'SDK ARCore 1.23.0)	Restituisce `NULL` nello struct `ACameraMetadata` risultante.

Correggi le app interessate

Le app interessate potrebbero subire interruzioni a novembre 2022. Per mitigare questo problema, utilizza sostituzioni automatiche per i metodi interessati:

Metodi ArImage_getNdkImage() e AImage_*: utilizza i metodi corrispondenti da ArImage. Ad esempio:
- AImage_getNumberOfPlanes() diventa ArImage_getNumberOfPlanes()
- AImage_getPlaneData() diventa ArImage_getPlaneData()
ArImage_getNdkCameraMetadata(): usa ArImageMetadata_getConstEntry()

Verificare che l'app interessata sia stata corretta

Testa l'app simulando in anticipo le modifiche di novembre 2022 aggiungendo una voce meta-data speciale all'elemento AndroidManifest.xml della tua app:

Assicurati che sul dispositivo di destinazione sia installato Play Services per AR 1.29.0 o versioni successive.

Aggiungi un nuovo tag <meta-data> come elemento secondario dell'elemento <application> esistente nell'app File AndroidManifest.xml

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

Testa la tua app e verifica che tutte le funzionalità di ARCore funzionino come previsto.
Rimuovi il tag <meta-data> al termine del test. Uscita dal tag in corso... nella tua app pubblicata potrebbe causare comportamenti imprevisti nel per il futuro.

Se funziona normalmente, l'app è pronta per i cambiamenti previsti per novembre 2022.

Cronologia

Periodo	Eventi
Novembre 2020 (SDK ARCore versione 1.20.0)	Ritira le API interessate e introduci le alternative alle API drop-in.
Febbraio 2021 (SDK ARCore versione 1.23.0)	Rimuovi dall'SDK ARCore le firme delle API ritirate in precedenza.
Novembre 2021	Annuncia la futura modifica che provoca un errore a causa della rimozione dell'implementazione in sospeso delle API interessate di Google Play Services per AR nel novembre 2022.
Novembre 2022	Rimuovi l'implementazione delle API interessate da Google Play Services per AR. Introdurre una modifica che provoca un errore per le app che utilizzano versioni ARCore precedenti al 1.23.0.