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 deprecati relativi ai metadati e alle immagini delle fotocamere NDK.

Le app che utilizzano questi metodi nelle versioni interessate dell'SDK ARCore potrebbero iniziare a comportarsi in modo diverso o arrestarsi in modo anomalo quando gli utenti aggiornano Google Play Services per AR.

App interessate

A partire da novembre 2022, la tua app potrebbe non funzionare più o avere un arresto anomalo quando gli utenti eseguono l'aggiornamento alla versione più recente 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 l'app è stata compilata con versione dell'SDK ARCore...	E utilizza le API interessate...	Comportamento in violazione a partire da novembre 2022
1.22.0 o precedente	`ArImage_getNdkImage()` (rimossa nell'SDK ARCore 1.23.0)	Restituisce `NULL` nello struct `AImage` risultante.
1.22.0 o precedente	`ArImage_getNdkCameraMetadata()` (rimossa nell'SDK ARCore 1.23.0)	Restituisce `NULL` nello struct `ACameraMetadata` risultante.

Correggere le app interessate

Le app interessate potrebbero non funzionare correttamente a novembre 2022. Per mitigare questo problema, utilizza sostituzioni dirette per i metodi interessati:

Metodi ArImage_getNdkImage() e AImage_*: utilizza i metodi corrispondenti indicati da ArImage. Ad esempio:
- AImage_getNumberOfPlanes() diventa ArImage_getNumberOfPlanes()
- AImage_getPlaneData() diventa ArImage_getPlaneData()
ArImage_getNdkCameraMetadata(): utilizza 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 alla AndroidManifest.xml della tua app:

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

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

<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 l'app e verifica che tutte le funzionalità ARCore funzionino come previsto.
Rimuovi il tag <meta-data> al termine del test. Se lasci attivo questo tag nell'app pubblicata, in futuro potrebbero verificarsi comportamenti imprevisti.

Se funziona normalmente, significa che è pronta per le modifiche a novembre 2022.

Sequenza

Periodo	Eventi
Novembre 2020 (SDK ARCore 1.20.0)	Ritira le API interessate, introduci alternative di API drop-in.
Febbraio 2021 (SDK ARCore versione 1.23.0)	Rimuovi le firme delle API deprecate in precedenza dall'SDK ARCore.
Novembre 2021	Annuncia una futura modifica che provoca un errore dovuto alla rimozione dell'implementazione delle API interessate da Google Play Services per AR a novembre 2022.
Novembre 2022	Rimuovi l'implementazione delle API interessate da Google Play Services per AR. Introduci modifiche che provocano errori per le app che utilizzano versioni di ARCore precedenti alla 1.23.0.