בנובמבר 2022 הסרת שיטות המצלמה מ-ARCore SDK ל-Android (Kotlin/Java)

בנובמבר 2022, Google Play Services למציאות רבודה תסיר שיטות שהוצאו משימוש שקשורות לתמונות ולמטא-נתונים של מצלמת NDK.

יכול להיות שאפליקציות שמשתמשות בשיטות האלה בגרסאות הרלוונטיות של ARCore SDK יתחילו לפעול בצורה שונה או יקרסו כשמשתמשים יעדכנו את שירותי Google Play ל-AR.

אפליקציות שהושפעו

החל מנובמבר 2022, יכול להיות שהאפליקציה שלכם תפסיק לפעול או תאבד את יציבותה כשמשתמשים יעדכנו לגרסה האחרונה של Google Play Services for AR אם:

האפליקציה שלכם נוצרה באמצעות SDK מושפע
האפליקציה שלכם משתמשת באחד מממשקי ה-API המושפעים הבאים:

אם האפליקציה שלכם קומפלילה עם גרסת ARCore SDK…	והוא משתמש בממשקי ה-API שהושפעו…	הפרות של המדיניות החל מנובמבר 2022
1.19.0 ומטה	`Frame.getImageMetadata()`	גורם לזריקה של `IllegalArgumentException`.
1.10.0 ומטה	`Frame.acquireCameraImage()`	הפונקציה מחזירה תמונה בגודל 0x0.

תיקון האפליקציות המושפעות

באפליקציות המושפעות ייתכן שיהיו תקלות בנובמבר 2022. כדי להפחית את הסיכון, צריך לבנות מחדש את האפליקציה באמצעות הגרסה העדכנית ביותר של ARCore SDK. עליכם לשדרג ל-ARCore SDK בגרסה 1.20.0 ואילך.

מוודאים שהבעיה באפליקציה הרלוונטית נפתרה

כדי לבדוק את האפליקציה, אפשר לדמות מראש את השינויים שיחולו בנובמבר 2022 על ידי הוספת רשומה מיוחדת של meta-data לקובץ AndroidManifest.xml של האפליקציה:

מוודאים שPlay Services למציאות רבודה בגרסה 1.29.0 ואילך מותקנת במכשיר היעד.

מוסיפים תג <meta-data> חדש כצאצא של אלמנט <application> הקיים בקובץ AndroidManifest.xml של האפליקציה:

<application …>
  …

  <!--
       Simulate the November 2022 changes in advance.
       IMPORTANT: Remove this tag when testing is completed.
       Do not include this tag in published versions of your app.
  -->
  <meta-data android:name="com.google.ar.core.session_settings"
             android:value="camera_stack_option,unified_mono" />
</application>

בודקים את האפליקציה ומוודאים שכל התכונות של ARCore פועלות כצפוי.
מסירים את התג <meta-data> בסיום הבדיקה. אם התג הזה יישאר באפליקציה שפורסמה, יכול להיות שתהיה התנהגות לא צפויה בעתיד.

אם האפליקציה פועלת באופן תקין, היא מוכנה לשינויים שיחולו בנובמבר 2022.

ציר הזמן

נקודה	אירועים
נובמבר 2020 (ARCore SDK גרסה 1.20.0)	להוציא משימוש את ממשקי ה-API המקוריים. צריך לעדכן את ההטמעה כדי להשתמש בממשקי API מקוריים חלופיים.
נובמבר 2021	להודיע על שינוי קריטי עתידי עקב הסרת ההטמעה של ממשקי ה-API הרלוונטיים מ-Google Play Services למציאות רבודה בנובמבר 2022.
נובמבר 2022	מסירים את ההטמעה של ממשקי ה-API המושפעים מ-Google Play Services למציאות רבודה. שינוי מהותי באפליקציות שמשתמשות בגרסאות ARCore שקדמו ל-1.20.0.