لا تسري التغييرات الموضّحة في هذا المستند إلا على التطبيقات التي تم تجميعها باستخدام الإصدار 1.31 من حزمة تطوير البرامج (SDK) من ARCore أو الإصدارات الأحدث. ولن تتأثر التطبيقات التي تم إعدادها باستخدام إصدار قديم من ARCore.
كجزء من الإصدار 1.31 لشهر أيار (مايو) 2022، تمت ترقية الحد الأقصى لنطاق ARCore من 8.191 متر إلى 65.535 متر. تستخدم واجهة برمجة التطبيقات Depth API الآن جميع وحدات بت لكل وحدة بكسل تبلغ 16 بت لتمثيل العمق، حيث كانت تُستخدم سابقًا 13 بت فقط لقيم العمق. ومع أنّ التطبيقات التي تستخدم الطُرق التالية في حِزم تطوير البرامج (SDK) القديمة من ARCore ستظل تعمل باستخدام النطاق المفصَّل السابق، ننصحك بتحديثها في قاعدة الرموز الخاصة بك للحصول على وظائف أفضل.
التغييرات الخاصة بالنظام الأساسي
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. |
الانسجام (AR Foundation)
تعالج AR Foundation جميع التغييرات. عند الإنشاء باستخدام الإصدار 1.31 من ARCore الإضافات أو إصدار أحدث، تعرض AROcclusionManager.TryAcquireEnvironmentDepthCpuImage الصور باستخدام الحد الأقصى الجديد الذي يبلغ 65.535 متر.