2022 年 11 月、ARCore SDK for Android NDK(AR Foundation)のカメラメソッドのサポートを終了

2022 年 11 月、AR 用 Google Play 開発者サービスは、NDK カメラの画像とメタデータに関連する非推奨のメソッドを削除します。

影響を受けるバージョンの AR Foundation でこれらのメソッドを使用しているアプリは、ユーザーが Google Play 開発者サービス(AR)を更新すると、動作が異なってしまうか、クラッシュする可能性があります。

影響を受けるアプリ

2022 年 11 月以降、以下の条件を満たすアプリは、ユーザーが Google Play 開発者サービス for AR の最新バージョンにアップデートしたときに、動作が停止またはクラッシュする可能性があります。

  1. 影響を受ける SDK でアプリがコンパイルされた
  2. お客様のアプリは、影響を受ける次のいずれかの API を使用しています。
アプリが
AR Foundation バージョンでコンパイルされている場合…
影響を受ける API を使用している 2022 年 11 月以降の動作の変更
AR Foundation 2.1(Unity 2019 LTS) XRCameraSubsystem.TryGetLatestImage(out XRCameraImage) false を返します。

影響を受けるアプリを修正する

影響を受けるアプリは、2022 年 11 月に動作しなくなる可能性があります。この問題を軽減するには、Unity のバージョンでサポートされている最新バージョンの AR Foundation にアップデートします。少なくとも AR Foundation バージョン 4.x 以降に更新してください。

影響を受けるアプリが修正されていることを確認する

アプリの AndroidManifest.xml に特別な meta-data エントリを追加して、2022 年 11 月の変更を事前にシミュレートし、アプリをテストします。

  1. ターゲット デバイスに Google Play 開発者サービス(AR)バージョン 1.29.0 以降がインストールされていることを確認します。
  2. アプリのカスタム AndroidManifest.xml ファイルで、既存の <application> 要素の子要素として新しい <meta-data> タグを追加します。

    <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 月 2022 年 11 月に Google Play 開発者サービス(AR)から影響を受ける API の実装が削除される予定であるため、今後の破壊的変更を発表します。
2022 年 11 月 Google Play 開発者サービス(AR)から影響を受ける API の実装を削除します。
1.23.0 より前の ARCore バージョンを使用しているアプリに破壊的変更を導入。