Perubahan yang diuraikan dalam dokumen ini hanya berlaku untuk aplikasi yang dikompilasi dengan ARCore SDK versi 1.31 atau yang lebih tinggi. Aplikasi yang dikompilasi dengan versi ARCore yang lebih lama tidak akan terpengaruh.
Sebagai bagian dari rilis 1.31 Mei 2022, rentang maksimum kedalaman ARCore telah ditingkatkan dari 8.191 meter menjadi 65.535 meter. Depth API kini menggunakan semua 16 bit per piksel untuk mewakili kedalaman, yang sebelumnya hanya menggunakan 13 bit untuk nilai kedalaman. Meskipun aplikasi yang menggunakan metode berikut di ARCore SDK yang lebih lama akan tetap berfungsi menggunakan rentang kedalaman sebelumnya, sebaiknya perbarui metode tersebut dalam codebase Anda untuk mendapatkan fungsi yang lebih baik.
Perubahan khusus platform
Android (Kotlin/Java)
| Nama dan fungsi metode sebelumnya | Nama dan fungsi metode baru |
|---|---|
| Rentang maks 8.191 meter | Rentang maks 65.535 meter |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() menampilkan ImageFormat.DEPTH16 |
Image.getFormat() menampilkan HardwareBuffer.D_16 |
Android NDK (C)
| Nama dan fungsi metode sebelumnya | Nama dan fungsi metode baru |
|---|---|
| Rentang maks 8.191 meter | Rentang maks 65.535 meter |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() menampilkan AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() menampilkan AR_IMAGE_FORMAT_D_16 |
Unity (AR Foundation)
Semua perubahan ditangani oleh AR Foundation. Saat mem-build dengan ARCore Extensions untuk AR Foundation versi 1.31 atau yang lebih baru, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage akan menampilkan gambar menggunakan rentang maksimum baru, yaitu 65.535 meter.