تغییرات ذکر شده در این سند فقط برای برنامه‌های کامپایل‌شده با ARCore SDK نسخه ۱.۳۱ یا بالاتر قابل اعمال است. برنامه های کامپایل شده با نسخه قدیمی ARCore تحت تأثیر قرار نخواهند گرفت.
به عنوان بخشی از نسخه 1.31 می 2022، حداکثر دامنه عمق ARCore از 8.191 متر به 65.535 متر ارتقا یافته است. Depth API اکنون از تمام 16 بیت در هر پیکسل برای نشان دادن عمق استفاده می کند، جایی که قبلا فقط 13 بیت برای مقادیر عمق استفاده می شد. اگرچه برنامه‌هایی که از روش‌های زیر در کیت‌های توسعه نرم‌افزار قدیمی 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)
تمام تغییرات توسط بنیاد AR انجام می شود. هنگام ساخت با برنامه های افزودنی ARCore برای AR Foundation نسخه 1.31 یا بالاتر، AROcclusionManager.TryAcquireEnvironmentDepthCpuImage تصاویر را با استفاده از حداکثر برد جدید 65.535 متر برمی گرداند.