自 2022 年 11 月起,AR 適用的 Google Play 服務將移除與 NDK 相機映像檔和中繼資料相關的已淘汰方法。
在受影響的 ARCore SDK 版本中,使用這些方法的應用程式,在使用者更新 Google Play 服務 - AR 適用時,可能出現異常行為或異常終止的情形。
受影響的應用程式
自 2022 年 11 月起,當使用者更新至最新版的 Google Play 服務 - AR 適用時,應用程式可能會停止運作或當機:
- 您的應用程式使用受影響的 SDK 編譯而成
- 您的應用程式使用了下列任一受影響的 API:
如果您的應用程式是以 ARCore SDK 版本編譯... |
並會使用受影響的 API... | 2022 年 11 月開始的破壞行為 |
---|---|---|
1.22.0 以下版本 | ArImage_getNdkImage() (已在 ARCore SDK 1.23.0 中移除) |
在產生的 AImage 結構中傳回 NULL 。 |
1.22.0 以下版本 | ArImage_getNdkCameraMetadata() (已在 ARCore SDK 1.23.0 中移除) |
在產生的 ACameraMetadata 結構中傳回 NULL 。 |
修正受影響的應用程式
受影響的應用程式可能會在 2022 年 11 月出現服務中斷情形。為解決此問題,請針對受影響的方法使用導入替換功能:
ArImage_getNdkImage()
和AImage_*
方法:使用ArImage
的對應方法。例如:ArImage_getNdkCameraMetadata()
:請改用ArImageMetadata_getConstEntry()
確認受影響的應用程式已解決
在應用程式的 AndroidManifest.xml
中加入特殊的 meta-data
項目,事先模擬 2022 年 11 月的變更,以便測試應用程式:
- 確認目標裝置已安裝 Play 服務 - AR 1.29.0 以上版本。
新增
<meta-data>
標記,做為應用程式AndroidManifest.xml
檔案中現有<application>
元素的子項:<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 年 11 月因應相關異動。
時間表
時間範圍 | 活動 |
---|---|
2020 年 11 月 (ARCore SDK 1.20.0 版) |
淘汰受影響的 API,導入導入 API 替代方案。 |
2021 年 2 月 (ARCore SDK 1.23.0 版) |
從 ARCore SDK 中移除先前淘汰的 API 簽名。 |
2021 年 11 月 | 由於 2022 年 11 月,Google Play 服務中受影響的 API 實作項目即將從 2022 年 11 月移除,因此我們宣布將進行破壞性變更。 |
2022 年 11 月 |
從 Google Play 服務 - AR 適用中移除受影響 API 的實作。 針對使用 ARCore 1.23.0 以下版本的應用程式,導入破壞性變更。 |