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