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 di AR Foundation 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 la tua app è stata compilata con la versione di AR Foundation... |
E utilizza le API interessate... | Comportamento in violazione a partire da novembre 2022 |
---|---|---|
AR Foundation 2.1 (Unity 2019 LTS) |
XRCameraSubsystem.TryGetLatestImage(out XRCameraImage)
|
Restituisce false . |
Correggere le app interessate
Le app interessate potrebbero non funzionare correttamente a novembre 2022. Per mitigare il problema, esegui l'aggiornamento all'ultima versione di AR Foundation supportata dalla tua versione di Unity. Esegui almeno l'aggiornamento alla versione 4.x o successiva di AR Foundation.
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 fileAndroidManifest.xml
personalizzato 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) |
Ritirare le API native. Aggiorna l'implementazione per utilizzare API native alternative. |
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. |