Изменения, описанные в этом документе, применимы только к приложениям, скомпилированным с помощью ARCore SDK версии 1.31 или выше. Приложения, скомпилированные с использованием более старой версии ARCore, не будут затронуты.
В рамках выпуска версии 1.31 от мая 2022 года максимальный диапазон глубины ARCore был увеличен с 8,191 метра до 65,535 метра. Depth API теперь использует все 16 бит на пиксель для представления глубины, тогда как раньше для значений глубины использовались только 13 бит. Хотя приложения, использующие следующие методы в старых ARCore SDK, по-прежнему будут работать с использованием предыдущего диапазона глубины, мы рекомендуем обновить их в своей кодовой базе для улучшения функциональности.
Изменения, специфичные для платформы
Android (Котлин/Java)
| Предыдущие имена и функции методов | Новые имена и функциональность методов. |
|---|---|
| Максимальная дальность 8,191 метра | Максимальная дальность 65,535 метров. |
Frame.acquireDepthImage() | Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() | Frame.acquireRawDepthImage16Bits() |
Image.getFormat() возвращает ImageFormat.DEPTH16 | Image.getFormat() возвращает HardwareBuffer.D_16 |
Android НДК (С)
| Предыдущие имена и функции методов | Новые имена и функциональность методов. |
|---|---|
| Максимальная дальность 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 . |
Единство (Фонд АР)
Все изменения обрабатываются AR Foundation. При сборке с использованием расширений ARCore для AR Foundation версии 1.31 или более поздней AROcclusionManager.TryAcquireEnvironmentDepthCpuImage возвращает изображения, используя новый максимальный диапазон 65,535 метров.