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 da câmera do NDK.

Os apps que usam esses métodos nas versões afetadas do SDK 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, o app pode parar de funcionar ou falhar quando os usuários atualizam 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… Mudança de comportamento a partir de novembro de 2022
1.22.0 ou versões anteriores ArImage_getNdkImage()
(removido no SDK do ARCore 1.23.0)
Retorna NULL na estrutura AImage resultante.
1.22.0 ou versões anteriores ArImage_getNdkCameraMetadata()
(removido no SDK do ARCore 1.23.0)
Retorna NULL na estrutura ACameraMetadata resultante.

Corrigir os apps afetados

Os apps afetados podem apresentar problemas em novembro de 2022. Para mitigar isso, use substituições de substituição para os métodos afetados:

Verificar se o app afetado foi corrigido

Para testar o app, simule as mudanças de novembro de 2022 com antecedência adicionando uma entrada meta-data especial à AndroidManifest.xml do app:

  1. Verifique se a versão 1.29.0 ou mais recente do Google Play Services para RA está instalada no dispositivo de destino.
  2. Adicione uma nova tag <meta-data> como filho 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 o app e verifique se todos os recursos do ARCore estão funcionando conforme esperado.

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

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

Cronograma

Período Eventos
Novembro de 2020
(versão 1.20.0 do SDK do ARCore)
Descontinuar as APIs afetadas e introduzir alternativas de API.
Fevereiro de 2021
(versão 1.23.0 do SDK do ARCore)
As assinaturas de APIs descontinuadas foram removidas do SDK do ARCore.
Novembro de 2021 Anúncio de uma mudança importante futura devido à remoção pendente da implementação das APIs afetadas do Google Play Services para RA em novembro de 2022.
Novembro de 2022 A implementação das APIs afetadas foi removida do Google Play Services para RA.
Apresente uma mudança importante para apps que usam versões do ARCore anteriores à 1.23.0.