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 baru. Aplikasi yang dikompilasi dengan ARCore versi lama tidak akan terpengaruh.

Sebagai bagian dari rilis 1.31 Mei 2022, rentang maksimum kedalaman ARCore telah diupgrade dari 8.191 meter menjadi 65.535 meter. Depth API kini menggunakan semua 16 bit per piksel untuk merepresentasikan kedalaman, sedangkan sebelumnya hanya 13 bit yang digunakan untuk nilai kedalaman. Meskipun aplikasi yang menggunakan metode berikut di ARCore SDK lama akan tetap berfungsi menggunakan rentang kedalaman sebelumnya, sebaiknya update aplikasi tersebut di codebase Anda untuk fungsi yang lebih baik.

Perubahan khusus platform

Android (Kotlin/Java)

Nama dan fungsi metode sebelumnya Nama dan fungsi metode baru
Jarak tempuh maksimum 8,191 meter Rentang 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 dan fungsi metode baru
Jarak tempuh maksimum 8,191 meter Rentang 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 (Dasar-Dasar AR)

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