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

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

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

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

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

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

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

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

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

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