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

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:

Twoja aplikacja została skompilowana z pakietem SDK, którego dotyczy problem
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.22.0 lub starsza	`ArImage_getNdkImage()` (usunięto w ARCore SDK w wersji 1.23.0)	Zwraca `NULL` w wynikowej strukturze `AImage`.
1.22.0 lub starsza	`ArImage_getNdkCameraMetadata()` (usunięto w ARCore SDK w wersji 1.23.0)	Zwraca `NULL` w wynikowej strukturze `ACameraMetadata`.

Naprawianie aplikacji, których to dotyczy

W listopadzie 2022 roku aplikacje, których to dotyczy, mogą ulec awarii. Aby temu zaradzić, skorzystaj z zamienników bezpośrednich w przypadku tych metod:

Metody ArImage_getNdkImage() i AImage_*: użyj odpowiednich metod z ArImage. Na przykład:
- AImage_getNumberOfPlanes() zmieni się na ArImage_getNumberOfPlanes()
- AImage_getPlaneData() zmieni się na ArImage_getPlaneData()
ArImage_getNdkCameraMetadata(): użyj ArImageMetadata_getConstEntry()

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:

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

Przetestuj aplikację i sprawdź, czy wszystkie funkcje ARCore działają nie jest oczekiwany.
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ć interfejsy API, których dotyczy problem, i wprowadzić alternatywne interfejsy API.
Luty 2021 r. (ARCore SDK w wersji 1.23.0)	Usuń wycofane podpisy interfejsów API z pakietu ARCore SDK.
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.