W listopadzie 2022 r. wycofaliśmy metody działania aparatu w pakiecie ARCore SDK na Androida (Kotlin/Java)

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 pakiet ARCore SDK 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 pakietu ARCore SDK... 		Korzysta z interfejsów API, których dotyczy problem... Działanie powodujące awarie od listopada 2022 r.
1.19.0 lub starsza Frame.getImageMetadata() Wyrzuca IllegalArgumentException.
1.10.0 lub starsza Frame.acquireCameraImage() Zwraca obraz o wymiarach 0 x 0.

Naprawianie aplikacji, których to dotyczy

W listopadzie 2022 roku aplikacje, których to dotyczy, mogą ulec awarii. Aby temu zaradzić, ponownie skompiluj aplikację, używając najnowszego pakietu SDK ARCore. Wymagane minimum uaktualnij pakiet SDK ARCore do wersji 1.20.0 lub nowszej.

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 AndroidManifest.xml plik 

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