Em novembro de 2022, os métodos de câmera foram descontinuados no SDK do ARCore para Android NDK (C).

Em novembro de 2022, o Google Play Services para RA vai remover métodos descontinuados relacionados a imagens e metadados de câmera do NDK.

Os apps que usam esses métodos nas versões afetadas do SDK do ARCore podem começar a se comportar de maneira diferente ou falhar quando os usuários atualizam o Google Play Services para RA.

Apps afetados

A partir de novembro de 2022, seu app poderá parar de funcionar ou apresentar falhas quando os usuários atualizarem para a versão mais recente do Google Play Services para RA se:

  1. O app foi compilado com um SDK afetado
  2. Seu app usa uma das seguintes APIs afetadas:
Se o app foi compilado com a
versão do SDK do ARCore...
E usa APIs afetadas... Alteração de comportamento a partir de novembro de 2022
1.22.0 ou anterior ArImage_getNdkImage()
(removido no SDK do ARCore 1.23.0)
Retorna NULL no struct AImage resultante.
1.22.0 ou anterior ArImage_getNdkCameraMetadata()
(removido no SDK do ARCore 1.23.0)
Retorna NULL no struct ACameraMetadata resultante.

Corrigir apps afetados

Os apps afetados podem apresentar falhas em novembro de 2022. Para atenuar isso, use substituições simples para os métodos afetados:

Verifique se o app afetado foi corrigido

Teste o app simulando as mudanças de novembro de 2022 com antecedência adicionando uma entrada meta-data especial ao AndroidManifest.xml:

  1. Confira se o Play Services para RA versão 1.29.0 ou mais recente está instalado no dispositivo de destino.
  2. Adicione uma nova tag <meta-data> como filha do elemento <application> existente no arquivo AndroidManifest.xml do 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. Teste seu app e verifique se todos os recursos do ARCore estão funcionando conforme o esperado.

  4. Remova a tag <meta-data> quando o teste for concluído. Manter essa tag no seu app publicado pode resultar em um comportamento inesperado no futuro.

Se ele funcionar normalmente, ele estará pronto para as mudanças de novembro de 2022.

Cronograma

Período Eventos
Novembro de 2020
(SDK do ARCore versão 1.20.0)
Descontinuar as APIs afetadas e introduzir alternativas de API drop-in.
Fevereiro de 2021
(SDK do ARCore versão 1.23.0)
As assinaturas de APIs descontinuadas foram removidas do SDK do ARCore
Novembro de 2021 Anunciamos mudanças futuras devido à remoção pendente da implementação de APIs afetadas do Google Play Services para RA em novembro de 2022.
Novembro de 2022 Removemos a implementação de APIs afetadas do Google Play Services para RA.
Introdução de alterações interruptivas para apps que usam versões do ARCore anteriores à 1.23.0.