تغییرات ذکر شده در این سند فقط برای برنامههای کامپایل شده با ARCore SDK نسخه ۱.۳۱ یا بالاتر قابل اجرا است. برنامههای کامپایل شده با نسخه قدیمیتر ARCore تحت تأثیر قرار نخواهند گرفت.
به عنوان بخشی از نسخه ۱.۳۱ مه ۲۰۲۲، حداکثر محدوده عمق ARCore از ۸.۱۹۱ متر به ۶۵.۵۳۵ متر ارتقا یافته است. API عمق اکنون از تمام ۱۶ بیت در هر پیکسل برای نمایش عمق استفاده میکند، در حالی که قبلاً فقط ۱۳ بیت برای مقادیر عمق استفاده میشد. اگرچه برنامههایی که از روشهای زیر در SDK های قدیمی ARCore استفاده میکنند، همچنان با استفاده از محدوده عمق قبلی کار میکنند، اما توصیه میکنیم برای عملکرد بهتر، آنها را در پایگاه کد خود بهروزرسانی کنید.
تغییرات مختص پلتفرم
اندروید (کاتلین/جاوا)
| نامها و قابلیتهای متدهای قبلی | نامها و قابلیتهای جدید متدها |
|---|---|
| حداکثر برد ۸.۱۹۱ متر | حداکثر برد ۶۵.۵۳۵ متر |
Frame.acquireDepthImage() | Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() | Frame.acquireRawDepthImage16Bits() |
Image.getFormat() ImageFormat.DEPTH16 را برمی گرداند | Image.getFormat() HardwareBuffer.D_16 را برمیگرداند. |
اندروید NDK (سی)
| نامها و قابلیتهای متدهای قبلی | نامها و قابلیتهای جدید متدها |
|---|---|
| حداکثر برد ۸.۱۹۱ متر | حداکثر برد ۶۵.۵۳۵ متر |
ArFrame_acquireDepthImage() | ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() | ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() AR_IMAGE_FORMAT_DEPTH16 را برمیگرداند. | ArImage_getFormat() AR_IMAGE_FORMAT_D_16 را برمیگرداند. |
یونیتی (بنیاد واقعیت افزوده)
تمام تغییرات توسط بنیاد AR مدیریت میشوند. هنگام ساخت با افزونههای ARCore برای بنیاد AR نسخه ۱.۳۱ یا بالاتر، AROcclusionManager.TryAcquireEnvironmentDepthCpuImage تصاویر را با استفاده از حداکثر برد جدید ۶۵.۵۳۵ متر برمیگرداند.