Zmiany opisane w tym dokumencie dotyczą tylko aplikacji skompilowanych z pakietem ARCore SDK w wersji 1.31 lub nowszej. Nie będzie to miało wpływu na aplikacje skompilowane ze starszą wersją ARCore.
W wersji 1.31 z maja 2022 r. maksymalny zasięg głębokości ARCore został zmieniony z 8,191 m na 65,535 metra. Depth API używa teraz wszystkich 16 bitów na piksel do reprezentowania głębi, podczas gdy wcześniej do określania głębi używano tylko 13 bitów. Chociaż aplikacje korzystające z podanych niżej metod w starszych pakietach SDK ARCore nadal będą działać z poprzednim zakresem szczegółowości, zalecamy zaktualizowanie ich w bazie kodu, aby zapewnić lepsze działanie.
Zmiany na poszczególnych platformach
Android (Kotlin/Java)
| Poprzednie nazwy metod i funkcje | Nowe nazwy metod i funkcje |
|---|---|
| Maksymalny zasięg: 8,191 m | Maksymalny zasięg: 65,535 metra |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() zwraca ImageFormat.DEPTH16 |
Image.getFormat() zwraca HardwareBuffer.D_16 |
Pakiet NDK z Androidem (C)
| Poprzednie nazwy metod i funkcje | Nowe nazwy metod i funkcje |
|---|---|
| Maksymalny zasięg: 8,191 m | Maksymalny zasięg: 65,535 metra |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() zwraca AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() zwraca AR_IMAGE_FORMAT_D_16 |
Unity (Fundacja AR)
Wszystkimi zmianami zajmuje się AR Foundation. Jeśli tworzysz komponenty ARCore Extensions for AR Foundation w wersji 1.31 lub nowszej, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage zwraca obrazy z nowym maksymalnym zasięgiem 65,535 metrów.