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

W listopadzie 2022 roku z Usług Google Play dla AR zostaną usunięte wycofane metody związane ze zdjęciami i metadanymi aparatu NDK.

Gdy użytkownicy zaktualizują Usługi Google Play dla AR, aplikacje korzystające z tych metod w odpowiednich wersjach pakietu ARCore SDK mogą zacząć działać inaczej lub ulegać awarii.

Aplikacje, których to dotyczy

Od listopada 2022 roku aplikacja może przestać działać lub ulec awarii, gdy użytkownicy zaktualizują Usługi 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 dotyczy ten problem:
Jeśli Twoja aplikacja została skompilowana z
pakietem SDK ARCore w wersji... 		I używa interfejsów API, których dotyczy problem... Zmiany mające miejsce od listopada 2022 roku
1.19.0 lub wcześniej Frame.getImageMetadata() Rzuca IllegalArgumentException.
1.10.0 lub wcześniej Frame.acquireCameraImage() Zwraca obraz o wymiarach 0 x 0.

Napraw aplikacje, których dotyczy problem

W listopadzie 2022 roku w aplikacjach, których to dotyczy, mogą występować błędy. Aby temu zaradzić, przebuduj aplikację za pomocą najnowszego pakietu SDK ARCore. Musisz uaktualnić pakiet SDK ARCore do wersji 1.20.0 lub nowszej.

Sprawdzanie, czy aplikacja, której dotyczy problem, została naprawiona

Przetestuj aplikację, symulując z wyprzedzeniem zmiany z listopada 2022 roku, dodając specjalny wpis meta-data do parametru AndroidManifest.xml Twojej aplikacji:

  1. Upewnij się, że na urządzeniu docelowym jest zainstalowana aplikacja Play Services for AR w wersji 1.29.0 lub nowszej.

  2. Dodaj nowy tag <meta-data> jako element podrzędny istniejącego elementu <application> w pliku AndroidManifest.xml 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 sprawdź, czy wszystkie funkcje ARCore działają zgodnie z oczekiwaniami.

  4. Po zakończeniu testowania usuń tag <meta-data>. Pozostawienie tego tagu w opublikowanej aplikacji może w przyszłości spowodować nieoczekiwane zachowanie.

Jeśli aplikacja działa normalnie, oznacza to, że jest gotowa na zmiany 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 używać alternatywnych interfejsów API natywnych.
Listopad 2021 r. Ogłoszenie o przyszłych zmianach powodujących niezgodność ze względu na oczekiwanie na 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.
Wprowadź zmiany powodujące niezgodność w przypadku aplikacji używających ARCore w wersji wcześniejszej niż 1.20.0.