Những thay đổi được nêu trong tài liệu này chỉ áp dụng cho các ứng dụng được biên dịch bằng SDK ARCore phiên bản 1.31 trở lên. Những ứng dụng được biên dịch bằng phiên bản ARCore cũ hơn sẽ không bị ảnh hưởng.
Trong bản phát hành 1.31 tháng 5 năm 2022, phạm vi độ sâu tối đa của ARCore đã được nâng cấp từ 8,191 mét lên 65,535 mét. API Độ sâu hiện sử dụng tất cả 16 bit trên mỗi pixel để thể hiện độ sâu, trong khi trước đây chỉ 13 bit được sử dụng cho giá trị độ sâu. Mặc dù ứng dụng dùng những phương thức sau trong các SDK ARCore cũ hơn sẽ vẫn hoạt động khi sử dụng phạm vi chiều sâu trước đó, nhưng bạn nên cập nhật các phương thức đó trong cơ sở mã để có chức năng tốt hơn.
Các thay đổi theo nền tảng cụ thể
Android (Kotlin/Java)
| Tên phương thức và chức năng trước đây | Tên và chức năng mới của phương thức |
|---|---|
| Phạm vi tối đa là 8,191 mét | Phạm vi tối đa là 65,535 mét |
Frame.acquireDepthImage() |
Frame.acquireDepthImage16Bits() |
Frame.acquireRawDepthImage() |
Frame.acquireRawDepthImage16Bits() |
Image.getFormat() trả về ImageFormat.DEPTH16 |
Image.getFormat() trả về HardwareBuffer.D_16 |
Android NDK (C)
| Tên phương thức và chức năng trước đây | Tên và chức năng mới của phương thức |
|---|---|
| Phạm vi tối đa là 8,191 mét | Phạm vi tối đa là 65,535 mét |
ArFrame_acquireDepthImage() |
ArFrame_acquireDepthImage16Bits() |
ArFrame_acquireRawDepthImage() |
ArFrame_acquireRawDepthImage16Bits() |
ArImage_getFormat() trả về AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() trả về AR_IMAGE_FORMAT_D_16 |
Unity (Nền tảng AR)
Mọi thay đổi đều do AR Foundation xử lý. Khi xây dựng bằng Tiện ích ARCore cho AR Foundation phiên bản 1.31 trở lên, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage sẽ trả về hình ảnh sử dụng phạm vi tối đa mới là 65,535 mét.