2022 年 11 月、ARCore SDK for Android(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 以降にアップグレードしてください。

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

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

  1. 対象デバイスに Play 開発者サービス(AR)バージョン 1.29.0 以降がインストールされていることを確認します。
  2. 新しい <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>
    
  3. アプリをテストして、すべての ARCore 機能が次のように機能していることを確認する あります。

  4. テストが完了したら、<meta-data> タグを削除します。このタグを残しています 変更すると、アプリで予期しない動作が発生する可能性があります。 説明します。

アプリが正常に機能していれば、アプリは 2022 年 11 月の変更に対応できます。

タイムライン

期間 イベント
2020 年 11 月
(ARCore SDK バージョン 1.20.0)
ネイティブ API のサポートを終了する。
別のネイティブ API を使用するように実装を更新してください。
2021 年 11 月 保留中の実装の削除を理由とする互換性を破る変更を通知 の影響を受ける API が 2022 年 11 月に Google Play 開発者サービス(AR)でリリースされました。
2022 年 11 月 影響を受ける API の実装を次から削除: (AR 用 Google Play 開発者サービス)。
以前の ARCore バージョンを使用するアプリに対して互換性を破る変更を導入 1.20.0.