لا تنطبق التغييرات الموضّحة في هذا المستند إلا على التطبيقات التي تم تجميعها باستخدام الإصدار 1.31 من حزمة ARCore SDK أو إصدار أحدث. ولن تتأثر التطبيقات التي تم تجميعها باستخدام إصدار أقدم من ARCore.
في إطار الإصدار 1.31 الذي تم طرحه في مايو 2022، تمّت ترقية الحد الأقصى لنطاق عمق ARCore من 8.191 مترًا إلى 65.535 مترًا. تستخدم واجهة برمجة التطبيقات Depth API الآن جميع وحدات البت الـ 16 لكل بكسل لتمثيل العمق، بينما كانت تستخدم سابقًا 13 وحدة بت فقط لقيم العمق. على الرغم من أنّ التطبيقات التي تستخدم الطرق التالية في حزم ARCore SDK الأقدم ستظل تعمل باستخدام نطاق العمق السابق، ننصحك بتحديثها في قاعدة الرموز البرمجية لتحسين أدائها.
التغييرات الخاصة بالمنصات
Android (Kotlin/Java)
| أسماء الطرق السابقة ووظائفها | أسماء الطرق الجديدة ووظائفها |
|---|---|
| الحد الأقصى للنطاق هو 8.191 مترًا | الحد الأقصى للنطاق هو 65.535 مترًا |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
تعرض الدالة Image.getFormat() القيمة ImageFormat.DEPTH16 |
تعرض الدالة Image.getFormat() القيمة HardwareBuffer.D_16 |
Android NDK (C)
| أسماء الطرق السابقة ووظائفها | أسماء الطرق الجديدة ووظائفها |
|---|---|
| الحد الأقصى للنطاق هو 8.191 مترًا | الحد الأقصى للنطاق هو 65.535 مترًا |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
تعرض الدالة ArImage_getFormat() القيمة AR_IMAGE_FORMAT_DEPTH16 |
تعرض الدالة ArImage_getFormat() القيمة AR_IMAGE_FORMAT_D_16 |
Unity (AR Foundation)
تتولى AR Foundation معالجة جميع التغييرات. عند الإنشاء باستخدام الإصدار 1.31 من ARCore Extensions for AR Foundation أو إصدار أحدث، AROcclusionManager.TryAcquireEnvironmentDepthCpuImage تعرض صورًا باستخدام الحد الأقصى الجديد للنطاق البالغ 65.535 مترًا.