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

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:

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

Napraw aplikacje, których dotyczy problem

W listopadzie 2022 roku w aplikacjach, których to dotyczy, mogą występować błędy. Aby temu zapobiec, użyj zamienników, których dotyczy problem:

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

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:

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

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>

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