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

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

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

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

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