2022 年 11 月、AR 用 Google Play 開発者サービスは、NDK カメラの画像とメタデータに関連する非推奨のメソッドを削除します。
影響を受けるバージョンの AR Foundation でこれらのメソッドを使用しているアプリは、ユーザーが Google Play 開発者サービス(AR)を更新すると、動作が異なってしまうか、クラッシュする可能性があります。
影響を受けるアプリ
2022 年 11 月以降、以下の条件を満たすアプリは、ユーザーが Google Play 開発者サービス for AR の最新バージョンにアップデートしたときに、動作が停止またはクラッシュする可能性があります。
- 影響を受ける SDK でアプリがコンパイルされた
- お客様のアプリは、影響を受ける次のいずれかの 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 月の変更を事前にシミュレートし、アプリをテストします。
- ターゲット デバイスに Google Play 開発者サービス(AR)バージョン 1.29.0 以降がインストールされていることを確認します。
アプリのカスタム
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>
アプリをテストして、すべての ARCore 機能が想定どおりに機能することを確認します。
テストが完了したら、
<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 バージョンを使用しているアプリに破壊的変更を導入。 |