このドキュメントに記載されている変更は、ARCore SDK バージョン 1.31 以降でコンパイルされたアプリにのみ適用されます。古いバージョンの ARCore でコンパイルされたアプリは影響を受けません。
2022 年 5 月の 1.31 リリースの一環として、ARCore の深度の最大範囲が 8.191 メートルから 65.535 メートルにアップグレードされました。Depth API で、ピクセルあたり 16 ビットすべてを使用して深度を表すようになりました。以前は、深度値に 13 ビットのみを使用していました。以前の ARCore SDK で次のメソッドを使用しているアプリは、以前の深度範囲を使用して引き続き動作しますが、機能性を向上させるため、コードベースで更新することをおすすめします。
プラットフォーム固有の変更
Android（Kotlin/Java）
| 以前のメソッド名と機能 | 新しいメソッド名と機能 |
|---|---|
| 最大範囲 8.191 メートル | 最大範囲 65,535 m |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() は ImageFormat.DEPTH16 を返します。 |
Image.getFormat() は HardwareBuffer.D_16 を返します。 |
Android NDK（C）
| 以前のメソッド名と機能 | 新しいメソッド名と機能 |
|---|---|
| 最大範囲 8.191 メートル | 最大航続距離: 65.535 m |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() は AR_IMAGE_FORMAT_DEPTH16 を返します。 |
ArImage_getFormat() は AR_IMAGE_FORMAT_D_16 を返します。 |
Unity（AR Foundation）
すべての変更は AR Foundation によって処理されます。AR Foundation バージョン 1.31 以降の ARCore Extensions を使用してビルドする場合、AROcclusionManager.TryAcquireEnvironmentDepthCpuImage は新しい最大範囲 65.535 メートルを使用して画像を返します。