Listopad 2022 r. wycofanych metod korzystania z aparatu w pakiecie ARCore SDK for Android NDK (AR Foundation)

W listopadzie 2022 r. Usługi Google Play dla AR usuną wycofane metody związane z obrazami i metadanymi aparatu NDK.

Aplikacje korzystające z tych metod w dotkniętych wersjach AR Foundation mogą zacząć zachowywać się inaczej lub ulec awarii, gdy użytkownicy zaktualizują Usługi Google Play dla AR.

Aplikacje, których dotyczy problem

Od listopada 2022 r. Twoja aplikacja może przestać działać lub ulec awarii, gdy użytkownicy zaktualizują Usługi Google Play dla AR do najnowszej wersji, jeśli:

Twoja aplikacja została skompilowana z dotkniętym problemem pakietem SDK
Twoja aplikacja używa któregoś z tych interfejsów API:

Jeśli aplikacja została skompilowana z poziomu wersja AR Foundation…	Używa też tych interfejsów API:	Zmiana zachowania od listopada 2022 r.
AR Foundation 2.1 (Unity 2019 LTS)	`XRCameraSubsystem.TryGetLatestImage(out XRCameraImage)`	Zwraca `false`.

Naprawianie aplikacji, których dotyczy problem

W listopadzie 2022 r. aplikacje, których dotyczy problem, mogą przestać działać. Aby temu zapobiec, zaktualizuj AR Foundation do najnowszej wersji obsługiwanej przez Twoją wersję Unity. Zaktualizuj AR Foundation co najmniej do wersji 4.x lub nowszej.

Sprawdź, czy problem został rozwiązany w aplikacji

Przetestuj aplikację, symulując zmiany z listopada 2022 r., dodając do niej specjalny wpis meta-data do AndroidManifest.xml:

Upewnij się, że na urządzeniu docelowym są zainstalowane Usługi Play dla AR w wersji 1.29.0 lub nowszej.

Dodaj nowy tag <meta-data> jako element podrzędny dotychczasowego elementu <application> w pliku AndroidManifest.xml niestandardowym aplikacji:

<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>

przetestuj aplikację i sprawdź, czy wszystkie funkcje ARCore działają zgodnie z oczekiwaniami;
Po zakończeniu testowania usuń tag <meta-data>. Pozostawienie tego tagu w opublikowanej aplikacji może spowodować nieoczekiwane zachowanie w przyszłości.

Jeśli aplikacja działa normalnie, jest gotowa na zmiany, które wprowadzimy w listopadzie 2022 r.

Oś czasu

Okres	Wydarzenia
listopad 2020 r. (ARCore SDK w wersji 1.20.0)	wycofać natywne interfejsy API; Zaktualizuj implementację, aby używać alternatywnych natywnych interfejsów API.
Listopad 2021 r.	ogłosić przyszłą zmianę ze względu na planowane usunięcie implementacji odpowiednich interfejsów API z Usług Google Play dla AR w listopadzie 2022 r.
Listopad 2022 r.	Usuń implementację interfejsów API, których dotyczy problem, z Usług Google Play dla AR. Wprowadzamy istotną zmianę w przypadku aplikacji korzystających z wersji ARCore starszych niż 1.23.0.