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

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

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

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

חשוב: אפליקציות שקודור עם ARCore SDK בגרסה 1.23.0 ואילך לא יושפעו.

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

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

אם האפליקציה שלך הודרכה באמצעות גרסת ARCore SDK...	ומשתמשת בממשקי API שהושפעו...	הפרות חמורות של המדיניות החל מנובמבר 2022
1.22.0 ומטה	ArImage_getNdkImage() (הוסר ב-ARCore SDK 1.23.0)	מחזירה את NULL במבנה AImage שמתקבל.
1.22.0 ומטה	ArImage_getNdkCameraMetadata() (הוסר ב-ARCore SDK 1.23.0)	מחזירה את NULL במבנה ACameraMetadata שמתקבל.

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

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

• ArImage_getNdkImage() ו-AImage_*: שימוש בשיטות תואמות מ-ArImage. לדוגמה:
  • AImage_getNumberOfPlanes() הופך ל-ArImage_getNumberOfPlanes()
  • AImage_getPlaneData() הופך ל-ArImage_getPlaneData()
• ArImage_getNdkCameraMetadata(): שימוש ב-ArImageMetadata_getConstEntry() במקום זאת

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

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

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