נובמבר 2022: הסרת שיטות המצלמה של ARCore SDK ל-Android NDK (AR Foundation)

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

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

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

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

  1. האפליקציה שלך נוצרה עם SDK שהושפע
  2. האפליקציה שלך משתמשת באחד מממשקי ה-API הבאים שהושפעו:
אם האפליקציה נוצרה באמצעות
גרסת הבסיס של AR... 		ומשתמשת בממשקי ה-API המושפעים... הפרות של המדיניות החל מנובמבר 2022
AR Foundation 2.1 (Unity 2019 LTS) XRCameraSubsystem.TryGetLatestImage(out XRCameraImage) הפונקציה מחזירה את הערך false.

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

באפליקציות המושפעות ייתכן שיהיו תקלות בנובמבר 2022. כדי לצמצם את הסיכון, מעדכנים לגרסה האחרונה של AR Foundation, שנתמכת בגרסה של Unity. לכל הפחות, צריך לעדכן לגרסה 4.x ואילך של AR Foundation.

צריך לוודא שהאפליקציה שהושפעה נפתרה

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

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

  2. הוספה של תג <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>

  3. בודקים את האפליקציה ומוודאים שכל תכונות ARCore פועלות מה מצופה.

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

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

ציר הזמן

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