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