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

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

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

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

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

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

אם האפליקציה שלכם נוצרה באמצעות גרסת ARCore SDK…	ונעשה בה שימוש בממשקי ה-API המושפעים…	שינוי התנהגות שעלול לגרום לשיבושים שייכנס לתוקף בנובמבר 2022
1.19.0 ומטה	`Frame.getImageMetadata()`	גורם לזריקה של `IllegalArgumentException`.
1.10.0 ומטה	`Frame.acquireCameraImage()`	הפונקציה מחזירה תמונה בגודל 0x0.

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

יכול להיות שבאפליקציות שהושפעו מהשינוי יהיו בעיות בנובמבר 2022. כדי לצמצם את הבעיה, צריך ליצור מחדש את האפליקציה באמצעות גרסת ה-SDK העדכנית ביותר של ARCore. עליכם לשדרג ל-ARCore SDK בגרסה 1.20.0 ואילך.

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

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