השינויים המפורטים במסמך זה חלים רק על אפליקציות שמקורן ב-ARCore SDK בגרסה 1.31 ואילך. לא תהיה לכך השפעה על אפליקציות שקדורו באמצעות גרסה ישנה יותר של ARCore.
כחלק מגרסה 1.31 של מאי 2022, הטווח המקסימלי של עומק העומק של ARCore שודרג מ-8.191 מטרים ל-65.535 מטרים. ב-Depth API נעשה עכשיו שימוש בכל 16 הביטים לפיקסל כדי לייצג עומק, ובעבר שימשו רק 13 ביטים לערכי עומק. למרות שאפליקציות שמשתמשות בשיטות הבאות בערכות SDK ישנות יותר של ARCore ימשיכו לפעול עם טווח העומק הקודם, מומלץ לעדכן אותן ב-codebase כדי ליהנות מפונקציונליות טובה יותר.
שינויים ספציפיים לפלטפורמה
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)
כל השינויים מטופלים על ידי AR Foundation. כשיוצרים באמצעות תוספי ARCore ל-AR Foundation גרסה 1.31 ואילך, הפקודה AROcclusionManager.TryAcquireEnvironmentDepthCpuImage מחזירה תמונות בטווח המקסימלי החדש של 65.535 מטרים.