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