En noviembre de 2022, se dejan de usar los métodos de cámara para el SDK de ARCore para el NDK de Android (C)

En noviembre de 2022, los Servicios de Google Play para RA quitarán los métodos obsoletos relacionadas con las imágenes y los metadatos de la cámara del NDK.

Las apps que usan estos métodos en versiones afectadas de el SDK de ARCore podría empezar a se comportan de manera diferente o fallan cuando los usuarios actualizan los Servicios de Google Play para RA.

Apps afectadas

A partir de noviembre de 2022, es posible que tu app deje de funcionar o falle cuando los usuarios la actualicen a la versión más reciente de los Servicios de Google Play para RA en los siguientes casos:

  1. Tu app se compiló con un SDK afectado
  2. Tu app usa cualquiera de las siguientes APIs afectadas:
Si tu app se compiló con
Versión del SDK de ARCore...
Y usa las APIs afectadas... Comportamiento rotundo a partir de noviembre de 2022
1.22.0 o anterior ArImage_getNdkImage()
(se quitó del SDK de ARCore 1.23.0)
Muestra NULL en el struct AImage resultante.
1.22.0 o anterior ArImage_getNdkCameraMetadata()
(se quitó del SDK de ARCore 1.23.0)
Muestra NULL en el struct ACameraMetadata resultante.

Corrige las apps afectadas

Es posible que las apps afectadas experimenten fallas en noviembre de 2022. Para mitigar esto, use reemplazos directos para los métodos afectados:

Verifica que se haya solucionado el problema de la app afectada

Para probar la app, simula los cambios de noviembre de 2022 con anticipación. Para ello, agrega una entrada meta-data especial al archivo AndroidManifest.xml de tu app:

  1. Asegúrate de que los Servicios de Play para RA versión 1.29.0 o posteriores estén instalados en el dispositivo de destino.
  2. Agrega una etiqueta <meta-data> nueva como elemento secundario del elemento <application> existente en el AndroidManifest.xml archivo :

    <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. Prueba tu app y verifica que todas las funciones de ARCore se ejecuten correctamente lo esperado.

  4. Quita la etiqueta <meta-data> cuando finalice la prueba. Abandonando esta etiqueta en tu aplicación publicada podría provocar un comportamiento inesperado en la en el futuro.

Si la app funciona con normalidad, está lista para los cambios que se realicen en noviembre de 2022.

Cronograma

Período Eventos
Noviembre de 2020
(SDK de ARCore versión 1.20.0)
Da de baja las APIs afectadas; introduce alternativas de APIs directas.
Febrero de 2021
(SDK de ARCore versión 1.23.0)
Se quitaron las firmas de APIs que dejaron de estar disponibles anteriormente del SDK de ARCore.
Noviembre de 2021 Anunciar un cambio rotundo futuro debido a la eliminación pendiente de la implementación de las APIs afectadas de los Servicios de Google Play para RA en noviembre de 2022.
Noviembre de 2022 Quitar la implementación de las APIs afectadas de Servicios de Google Play para RA.
Ingresar un cambio rotundo para las apps que usan versiones de ARCore anteriores a 1.23.0.