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

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

Os aplicativos que usam esses métodos em versões afetadas do Base de RA pode começar a se comportam de maneira diferente ou apresentam falhas 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 forem atualizados 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
Versão do AR Foundation...
E usa as APIs afetadas... Mudanças no comportamento a partir de novembro de 2022
AR Foundation 2.1 (Unity 2019 LTS) XRCameraSubsystem.TryGetLatestImage(out XRCameraImage) Retorna false.

Corrigir apps afetados

Os apps afetados talvez tenham falhas em novembro de 2022. Para minimizar isso, Atualize para a versão mais recente da AR Foundation compatível com sua versão do Unity. No mínimo, atualize para a versão 4.x ou mais recente do AR Foundation.

Verifique 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 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 personalizado :

    <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 como o esperado.

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

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

Cronograma

Período Eventos
Novembro de 2020
(SDK do ARCore versão 1.20.0)
Suspensão do uso das APIs nativas.
Atualização da implementação para usar APIs nativas alternativas.
Novembro de 2021 Anunciar futuras mudanças interruptivas devido à remoção pendente da implementação das APIs afetadas do Google Play Services para RA em novembro de 2022.
Novembro de 2022 Remova a implementação das APIs afetadas do Google Play Services para RA.
Introduzir alterações interruptivas para apps que usam versões do ARCore anteriores à 1.23.0.