Các thay đổi được nêu trong tài liệu này chỉ áp dụng cho những ứng dụng được biên dịch bằng ARCore SDK phiên bản 1.31 trở lên. Các ứng dụng được biên dịch bằng một phiên bản cũ của ARCore sẽ không bị ảnh hưởng.
Trong bản phát hành 1.31 vào tháng 5 năm 2022, phạm vi tối đa của độ sâu ARCore đã được nâng cấp từ 8.191 mét lên 65.535 mét. Depth API hiện sử dụng cả 16 bit cho mỗi pixel để biểu thị độ sâu, trong khi trước đây chỉ có 13 bit được dùng cho các giá trị độ sâu. Mặc dù các ứng dụng sử dụng những phương thức sau trong các SDK ARCore cũ vẫn hoạt động bằng cách 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 này trong cơ sở mã để có chức năng tốt hơn.
Các thay đổi dành riêng cho nền tảng
Android (Kotlin/Java)
| Tên và chức năng của phương thức trước đó | Tên và chức năng của phương thức mới |
|---|---|
| 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ả lại hàng ImageFormat.DEPTH16 |
Image.getFormat() trả lại hàng HardwareBuffer.D_16 |
Android NDK (C)
| Tên và chức năng của phương thức trước đó | Tên và chức năng của phương thức mới |
|---|---|
| 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ả lại hàng AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() trả lại hàng AR_IMAGE_FORMAT_D_16 |
Unity (AR Foundation)
AR Foundation sẽ xử lý mọi thay đổi. Khi bạn tạo bằng ARCore Extensions cho AR Foundation phiên bản 1.31 trở lên, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage sẽ trả về hình ảnh bằng phạm vi tối đa mới là 65.535 mét.