Maj 2022 r. (ARCore SDK w wersji 1.31) zmienia się na Depth

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 do starszej wersji ARCore.

W maju 2022 r. w wersji 1.31 maksymalny zasięg ARCore został zwiększony z 8,191 metra do 65,535 metra. Interfejs Depth API używa teraz wszystkich 16 bitów na piksel do określania głębi. Wcześniej do określania głębi używano tylko 13 bitów. Chociaż aplikacje korzystające z poniższych metod w starszych pakietach SDK ARCore nadal będą działać na podstawie poprzedniego zakresu, zalecamy zaktualizowanie ich w bazie kodu, aby zwiększyć ich funkcjonalność.

Zmiany na poszczególnych platformach

Android (Kotlin/Java)

Poprzednie nazwy i funkcje metod Nowe nazwy i funkcje metod
Maksymalny zasięg: 8,191 metra 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

Android NDK (C)

Poprzednie nazwy i funkcje metod Nowe nazwy i funkcje metod
Maksymalny zasięg: 8,191 metra 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. Podczas tworzenia przy użyciu ARCore Extensions for AR Foundation w wersji 1.31 lub nowszej AROcclusionManager.TryAcquireEnvironmentDepthCpuImage zwraca obrazy z wykorzystaniem nowego maksymalnego zasięgu 65, 535 metra.