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

W listopadzie 2022 r. w Usługach Google Play dla AR zostaną usunięte wycofane metody dotyczące obrazów i metadanych z kamery 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:

  1. Twoja aplikacja została skompilowana z pakietem SDK, którego dotyczy problem
  2. Twoja aplikacja używa dowolnego z tych interfejsów API, których to dotyczy:
Jeśli aplikacja została skompilowana z poziomu
wersja AR Foundation… 		Korzysta z interfejsów API, których dotyczy problem... Zmiana zachowania w listopadzie 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 aplikacja, której dotyczy problem, została naprawiona

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

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

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

  3. przetestuj aplikację i upewnij się, że wszystkie funkcje ARCore działają prawidłowo;

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