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

A novembre 2022, Google Play Services per AR rimuoverà i metodi ritirati relativi alle immagini e ai metadati della fotocamera 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 arrestarsi in modo anomalo quando gli utenti eseguono l'aggiornamento all'ultima versione di Google Play Services per AR se:

  1. La tua app è stata compilata con un SDK interessato
  2. La tua app utilizza una delle seguenti API interessate:
Se la tua app è stata compilata con la versione dell'SDK ARCore
… 		E utilizza le API interessate… Modifica del comportamento a partire da novembre 2022
1.19.0 o versioni precedenti Frame.getImageMetadata() Lancia IllegalArgumentException.
1.10.0 o versioni precedenti Frame.acquireCameraImage() Restituisce un'immagine di dimensioni 0 x 0.

Correggere le app interessate

Le app interessate potrebbero subire interruzioni a novembre 2022. Per ovviare al problema, ricostruisci l'app utilizzando l'SDK ARCore più recente. Devi almeno eseguire l'upgrade all'SDK ARCore 1.20.0 o versioni successive.

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 a AndroidManifest.xml della tua app:

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

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

  3. Testa la tua app e verifica che tutte le funzionalità ARCore funzionino come previsto.

  4. Rimuovi il tag <meta-data> al termine del test. Se mantieni questo tag attivo nell'app pubblicata, in futuro potresti riscontrare comportamenti imprevisti.

Se l'app funziona normalmente, è pronta per le modifiche di novembre 2022.

Cronologia

Periodo Eventi
Novembre 2020
(versione dell'SDK ARCore 1.20.0)		 Le API native vengono ritirate.
Aggiorna l'implementazione per utilizzare API native alternative.
Novembre 2021 Annunciare una futura modifica che comporta una interruzione del servizio a causa della rimozione in attesa 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.
Viene introdotta una modifica che comporta una interruzione del servizio per le app che utilizzano versioni di ARCore precedenti alla 1.20.0.