لا تسري التغييرات الموضّحة في هذا المستند إلا على التطبيقات التي تم تجميعها باستخدام الإصدار 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 |
Unity (AR Foundation)
تعالج AR Foundation جميع التغييرات. عند الإنشاء باستخدام "إضافات ARCore" لإصدار AR Foundation 1.31 أو الإصدارات الأحدث، يعرض AROcclusionManager.TryAcquireEnvironmentDepthCpuImage الصور باستخدام الحد الأقصى الجديد للنطاق الذي يبلغ 65.535 مترًا.