2022 年 11 月已淘汰為 Android 適用的 ARCore SDK (Kotlin/Java) 移除相機方法

2022 年 11 月，Google Play 服務 - AR 適用將移除與 NDK 相機圖像和中繼資料相關的已淘汰方法。

應用程式在受影響的 ARCore SDK 可能會開始 在使用者更新「Google Play 服務 - AR 適用」時的運作方式不同或當機。

受影響的應用程式

自 2022 年 11 月起，當使用者更新應用程式，應用程式可能會停止運作或異常終止 升級至最新版本的 Google Play 服務 - AR 適用中，前提是：

  1. 透過受影響的 SDK 編譯應用程式
  2. 您的應用程式會使用下列任一受影響的 API：
如果您的應用程式是使用
編譯的 ARCore SDK 版本… 		並使用受影響的 API... 自 2022 年 11 月起的異動行為
1.19.0 以下版本 Frame.getImageMetadata() 擲回 IllegalArgumentException。
1.10.0 以下版本 Frame.acquireCameraImage() 傳回 0x0 大小的圖片。

修正受影響的應用程式

受影響的應用程式可能會在 2022 年 11 月發生中斷情形。為了避免這種情況 使用最新版的 ARCore SDK 重新建構應用程式。您至少必須升級至 ARCore SDK 1.20.0 以上版本。

確認受影響的應用程式已修正

請先模擬 2022 年 11 月的變更，為應用程式的 AndroidManifest.xml 新增特殊 meta-data 項目，以便測試應用程式：

  1. 確認目標裝置已安裝 1.29.0 以上版本的 Play 服務 - AR 適用。

  2. 在應用程式的 AndroidManifest.xml 檔案中，將新的 <meta-data> 標記新增為現有 <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>

  3. 測試應用程式，確認所有 ARCore 功能都能正常運作。

  4. 測試完成後，請移除 <meta-data> 標記。正在離開這個代碼 在您發布的應用程式中，可能會導致

如果應用程式正常運作，表示應用程式已準備好因應 2022 年 11 月的異動。

時間軸

期間 活動
2020 年 11 月
(ARCore SDK 1.20.0 版)		 淘汰原生 API。
更新實作方式以使用替代的原生 API。
2021 年 11 月 由於 Google Play 服務 - AR 適用版本將於 2022 年 11 月移除受影響的 API 實作，因此將另行宣布日後的重大異動。
2022 年 11 月 從 Google Play 服務 - AR 適用中移除受影響 API 的實作項目。
針對使用 1.20.0 以下版本 ARCore 的應用程式，引入破壞性變更。