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

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

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

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

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

האפליקציה שלך נוצרה עם 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 למציאות רבודה בנובמבר 2022.
נובמבר 2022	הסרת ההטמעה של ממשקי ה-API המושפעים מ- Google Play Services למציאות רבודה. הוספת שינוי תוכנה שעלול לגרום לכשל באפליקציות שמשתמשות בגרסאות ARCore לפני 1.20.0.