Изменения, описанные в этом документе, применимы только к приложениям, скомпилированным с использованием ARCore SDK версии 1.31 или выше. Приложения, скомпилированные с использованием более старой версии ARCore, не будут затронуты.
В рамках выпуска 1.31 от мая 2022 года максимальный диапазон глубины ARCore был увеличен с 8,191 метра до 65,535 метра. API глубины теперь использует все 16 бит на пиксель для представления глубины, тогда как ранее для значений глубины использовались только 13 бит. Хотя приложения, использующие следующие методы в более старых версиях ARCore SDK, по-прежнему будут работать с предыдущим диапазоном глубины, мы рекомендуем обновить их в вашем коде для повышения функциональности.
Изменения, специфичные для платформы
Android (Kotlin/Java)
| Предыдущие названия методов и их функциональность | Новые названия методов и функциональность. |
|---|---|
| Максимальная дальность 8,191 метра. | Максимальная дальность 65,535 метров. |
Frame.acquireDepthImage() | Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() | Frame.acquireRawDepthImage16Bits() |
Image.getFormat() возвращает ImageFormat.DEPTH16 | Image.getFormat() возвращает HardwareBuffer.D_16 |
Android NDK (C)
| Предыдущие названия методов и их функциональность | Новые названия методов и функциональность. |
|---|---|
| Максимальная дальность 8,191 метра. | Максимальная дальность 65,535 метров. |
ArFrame_acquireDepthImage() | ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() | ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() возвращает AR_IMAGE_FORMAT_DEPTH16 | ArImage_getFormat() возвращает AR_IMAGE_FORMAT_D_16 |
Unity (AR Foundation)
Все изменения обрабатываются AR Foundation. При сборке с использованием расширений ARCore для AR Foundation версии 1.31 или более поздней, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage возвращает изображения, используя новый максимальный диапазон 65,535 метров.