Mei 2022 (ARCore SDK versi 1.31) berubah menjadi Depth

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 ARCore versi lama tidak akan terpengaruh.

Sebagai bagian dari rilis 1.31 Mei 2022, kisaran kedalaman maksimum ARCore telah ditingkatkan dari 8,191 meter menjadi 65,535 meter. Depth API kini menggunakan seluruh 16 bit per piksel untuk mewakili kedalaman, yang sebelumnya hanya 13 bit yang digunakan untuk nilai kedalaman. Meskipun aplikasi yang menggunakan metode berikut dalam ARCore SDK lama masih akan berfungsi menggunakan rentang kedalaman sebelumnya, sebaiknya update aplikasi di codebase Anda untuk mendapatkan fungsi yang lebih baik.

Perubahan khusus platform

Android (Kotlin/Java)

Nama dan fungsi metode sebelumnya Nama metode dan fungsi baru
Jarak maksimum 8,191 meter Jangkauan maksimum 65,535 meter
Frame.acquireDepthImage() Frame.acquireDepthImage16Bits()
Frame.acquireRawDepthImage() Frame.acquireRawDepthImage16Bits()
Image.getFormat() akan menampilkan ImageFormat.DEPTH16 Image.getFormat() akan menampilkan HardwareBuffer.D_16

Android NDK (C)

Nama dan fungsi metode sebelumnya Nama metode dan fungsi baru
Jarak maksimum 8,191 meter Jangkauan maksimum 65,535 meter
ArFrame_acquireDepthImage() ArFrame_acquireDepthImage16Bits()
ArFrame_acquireRawDepthImage() ArFrame_acquireRawDepthImage16Bits()
ArImage_getFormat() akan menampilkan AR_IMAGE_FORMAT_DEPTH16 ArImage_getFormat() akan menampilkan AR_IMAGE_FORMAT_D_16

Unity (AR Foundation)

Semua perubahan ditangani oleh AR Foundation. Saat mem-build dengan Ekstensi ARCore untuk AR Foundation versi 1.31 atau yang lebih baru, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage akan menampilkan gambar menggunakan rentang maksimum yang baru, yaitu 65,535 meter.