Bu dokümanda belirtilen değişiklikler yalnızca ARCore SDK'sının 1.31 veya sonraki bir sürümüyle derlenmiş uygulamalar için geçerlidir. ARCore'un eski bir sürümüyle derlenen uygulamalar bu durumdan etkilenmeyecek.
Mayıs 2022'de yayınlanan 1.31 sürümü kapsamında ARCore'un derinlik 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'larında 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 özel değişiklikler
Android (Kotlin/Java)
| Önceki yöntem adları ve işlevleri | Yeni yöntem adları ve işlevleri |
|---|---|
| Maksimum 8.191 metre menzil | Maksimum 65.535 metre menzil |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() returns ImageFormat.DEPTH16 |
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 8.191 metre menzil | Maksimum 65.535 metre menzil |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() returns AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() returns AR_IMAGE_FORMAT_D_16 |
Unity (AR Foundation)
Tüm değişiklikler AR Foundation tarafından yönetilir. AR Foundation 1.31 veya sonraki sürümler için ARCore Extensions ile geliştirirken AROcclusionManager.TryAcquireEnvironmentDepthCpuImage, 65.535 metrelik yeni maksimum menzili kullanarak resim döndürür.