Bu belgede belirtilen değişiklikler yalnızca ARCore SDK'nın 1.31 veya sonraki sürümleriyle derlenen uygulamalar için geçerlidir. ARCore'un eski bir sürümüyle derlenen uygulamalar etkilenmez.
Mayıs 2022'deki 1.31 sürümü kapsamında ARCore'un derinlik için maksimum aralığı 8,191 metreden 65,535 metreye yükseltildi. Derinlik API'si artık derinliği temsil etmek için piksel başına 16 bitin tamamını kullanıyor. Daha önce derinlik değerleri için yalnızca 13 bit kullanılıyordu. Eski ARCore SDK'lerinde aşağıdaki yöntemleri kullanan uygulamalar önceki derinlik aralığını kullanarak çalışmaya devam edecek olsa da daha iyi işlevsellik için bunları kod tabanınızda güncellemenizi öneririz.
Platforma özgü değişiklikler
Android (Kotlin/Java)
| Önceki yöntem adları ve işlevler | Yeni yöntem adları ve işlevler |
|---|---|
| Maksimum 8.191 metre menzil | Maksimum 65.535 metre menzil |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() karşılığında iade ImageFormat.DEPTH16 |
Image.getFormat() karşılığında iade HardwareBuffer.D_16 |
Android NDK (C)
| Önceki yöntem adları ve işlevler | Yeni yöntem adları ve işlevler |
|---|---|
| Maksimum 8.191 metre menzil | Maksimum 65.535 metre menzil |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() karşılığında iade AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() karşılığında iade AR_IMAGE_FORMAT_D_16 |
Unity (AR Foundation)
Tüm değişiklikler AR Foundation tarafından işlenir. AR Foundation 1.31 veya sonraki sürümler için ARCore Uzantıları ile geliştirme yaparken AROcclusionManager.TryAcquireEnvironmentDepthCpuImage, 65.535 metrelik yeni maksimum aralığı kullanarak resimler döndürür.