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

W listopadzie 2022 roku w Usługach Google Play dla AR zostaną usunięte wycofane metody związane ze zdjęciami i metadanymi pochodzącymi z kamery NDK.

Aplikacje używające tych metod w wersjach systemu, których dotyczy problem Podstawy AR może zacząć zachowanie może się zmienić lub ulegać awarii, gdy użytkownicy zaktualizują Usługi Google Play dla AR.

Aplikacje, których to dotyczy

Od listopada 2022 roku Twoja aplikacja może przestać działać lub ulegać awarii po zaktualizowaniu przez użytkowników do najnowszej wersji Usług Google Play dla AR, 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 Twoja aplikacja została skompilowana z pakietem
Wersja podstawowych funkcji AR... 		Korzysta z interfejsów API, których dotyczy problem... Działanie powodujące awarie od listopada 2022 r.
AR Foundation 2.1 (Unity 2019 LTS) XRCameraSubsystem.TryGetLatestImage(out XRCameraImage) Zwraca false.

Naprawianie aplikacji, których to dotyczy

W listopadzie 2022 roku aplikacje, których to dotyczy, mogą ulec awarii. Aby temu zaradzić, zaktualizuj Unity do najnowszej wersji AR Foundation. Zaktualizuj AR Foundation co najmniej do wersji 4.x.

Sprawdź, czy problem z aplikacją został rozwiązany

Przetestuj aplikację, symulując zmiany z listopada 2022 roku przez dodanie specjalnego wpisu meta-data do pola AndroidManifest.xml dotyczącego Twojej aplikacji:

  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 istniejącego elementu <application> w kodzie aplikacji niestandardowy plik AndroidManifest.xml 

    <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 sprawdź, czy wszystkie funkcje ARCore działają nie jest oczekiwany.

  4. Po zakończeniu testów usuń tag <meta-data>. Opuszczasz ten tag w opublikowanej aplikacji mogą spowodować nieoczekiwane działanie w przyszłości.

Jeśli aplikacja działa normalnie, jest gotowa do wprowadzenia zmian w listopadzie 2022 roku.

Oś czasu

Okres Wydarzenia
Listopad 2020 r.
(ARCore SDK w wersji 1.20.0)		 Wycofać natywne interfejsy API.
Zaktualizuj implementację, aby korzystać z alternatywnych natywnych interfejsów API.
Listopad 2021 r. Ogłaszaj przyszłą zmianę powodującą niezgodność z powodu oczekującego usunięcia implementacji interfejsów API Usług Google Play dla AR, których dotyczy problem, w listopadzie 2022 r.
Listopad 2022 r. Usuń implementację interfejsów API, których dotyczy problem, z: Usługi Google Play dla AR.
Wprowadź zmianę powodującą niezgodność w przypadku aplikacji korzystających z wersji ARCore sprzed 1.23.0.