2022 年 11 月に、Google Play 開発者サービス(AR)で非推奨のメソッドが削除されます 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
の対応するメソッドを使用します。次に例を示します。 <ph type="x-smartling-placeholder">- </ph>
AImage_getNumberOfPlanes()
はArImage_getNumberOfPlanes()
になりますAImage_getPlaneData()
はArImage_getPlaneData()
になります
ArImage_getNdkCameraMetadata()
: 代わりにArImageMetadata_getConstEntry()
を使用してください
影響を受けるアプリが修正されたことを確認する
アプリの AndroidManifest.xml
に特別な meta-data
エントリを追加して、2022 年 11 月の変更を事前にシミュレートして、アプリをテストします。
- 対象デバイスに Play 開発者サービス(AR)バージョン 1.29.0 以降がインストールされていることを確認します。
新しい
<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>
アプリをテストして、すべての ARCore 機能が次のように機能していることを確認する あります。
テストが完了したら、
<meta-data>
タグを削除します。このタグを残しています 変更すると、アプリで予期しない動作が発生する可能性があります。 説明します。
アプリが正常に機能していれば、アプリは 2022 年 11 月の変更に対応できます。
タイムライン
期間 | イベント |
---|---|
2020 年 11 月 (ARCore SDK バージョン 1.20.0) |
影響を受ける API のサポートを終了し、ドロップイン API を導入します。 |
2021 年 2 月 (ARCore SDK バージョン 1.23.0) |
以前に非推奨になった API 署名を ARCore SDK から削除しました。 |
2021 年 11 月 | 保留中の実装の削除を理由とする互換性を破る変更を通知 の影響を受ける API が 2022 年 11 月に Google Play 開発者サービス(AR)でリリースされました。 |
2022 年 11 月 |
影響を受ける API の実装を次から削除:
(AR 用 Google Play 開発者サービス)。 以前の ARCore バージョンを使用するアプリに対して互換性を破る変更を導入 1.23.0. |