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

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

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

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

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

האפליקציה שלכם נוצרה באמצעות SDK מושפע
האפליקציה שלכם משתמשת באחד מממשקי ה-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. כדי למזער את הבעיה, אפשר להשתמש בהחלפות 'drop-in' לשיטות המושפעות:

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

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

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