Bu belgede açıklanan değişiklikler yalnızca ARCore SDK'sının 1.31 veya sonraki bir sürümü ile derlenen uygulamalar için geçerlidir. ARCore'un eski bir sürümüyle derlenen uygulamalar bu değişiklikten etkilenmeyecektir.
Mayıs 2022 1.31 sürümü kapsamında, ARCore'un maksimum derinlik aralığı 8,191 metreden 65,535 metreye yükseltildi. Depth API, derinliği göstermek için artık piksel başına 16 bitin tümünü kullanıyor. Daha önce derinlik değerleri için yalnızca 13 bit kullanılıyordu. Eski ARCore SDK'larında aşağıdaki yöntemleri kullanan uygulamalar önceki derinlik aralığı kullanılarak çalışmaya devam edecek olsa da daha iyi işlevler için bu uygulamaları kod tabanınızda güncellemenizi öneririz.
Platforma özel değişiklikler
Android (Kotlin/Java)
| Önceki yöntem adları ve işlevleri | Yeni yöntem adları ve işlevleri |
|---|---|
| Maksimum menzil 8,191 metre | Maksimum menzil 65,535 metre |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat(), ImageFormat.DEPTH16 tarihinde iade ediyor |
Image.getFormat(), HardwareBuffer.D_16 tarihinde iade ediyor |
Android NDK (C)
| Önceki yöntem adları ve işlevleri | Yeni yöntem adları ve işlevleri |
|---|---|
| Maksimum menzil 8,191 metre | Maksimum menzil 65,535 metre |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat(), AR_IMAGE_FORMAT_DEPTH16 tarihinde iade ediyor |
ArImage_getFormat(), AR_IMAGE_FORMAT_D_16 tarihinde iade ediyor |
Unity (AR Foundation)
Tüm değişiklikler AR Foundation tarafından yönetilir. AR Foundation için 1.31 veya sonraki bir sürüm için ARCore Uzantıları ile derleme yaparken AROcclusionManager.TryAcquireEnvironmentDepthCpuImage, resimleri yeni maksimum 65,535 metre aralığını kullanarak döndürür.