השינויים שמפורטים במסמך הזה רלוונטיים רק לאפליקציות שעברן הידור באמצעות ARCore SDK בגרסה 1.31 ואילך. אפליקציות שעברן הידור עם גרסה ישנה יותר של ARCore לא יושפעו.
במסגרת הגרסה 1.31 שפורסמה במאי 2022, הטווח המקסימלי של עומק העצמים ב-ARCore שודרג מ-8.191 מטרים ל-65.535 מטרים. Depth API משתמש עכשיו בכל 16 הביטים לכל פיקסל כדי לייצג עומק, במקום 13 ביט בלבד שהיו בשימוש בעבר לערכים של עומק. אפליקציות שמשתמשות בשיטות הבאות ב-SDKs ישנים יותר של ARCore ימשיכו לפעול באמצעות טווח העומק הקודם, אבל מומלץ לעדכן אותן בקוד הבסיסי כדי לשפר את הפונקציונליות.
שינויים ספציפיים לפלטפורמה
| שמות פונקציות קודמות ופונקציונליות קודמת | שמות פונקציות חדשים ופונקציונליות חדשה |
|---|---|
| טווח מקסימלי של 8.191 מטרים | טווח מקסימלי של 65.535 מטרים |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() מחזיר את הערך ImageFormat.DEPTH16 |
Image.getFormat() מחזיר את הערך HardwareBuffer.D_16 |
| שמות פונקציות קודמות ופונקציונליות קודמת | שמות פונקציות חדשים ופונקציונליות חדשה |
|---|---|
| טווח מקסימלי של 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 Foundation. כשמפתחים באמצעות ARCore Extensions ל-AR Foundation בגרסה 1.31 ואילך, הפונקציה AROcclusionManager.TryAcquireEnvironmentDepthCpuImage מחזירה תמונות לפי הטווח המקסימלי החדש של 65.535 מטרים.