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. Các ứng dụng được biên dịch bằng phiên bản ARCore cũ 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 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 tất cả 16 bit trên mỗi pixel để biểu thị độ sâu, trong khi trước đây chỉ sử dụng 13 bit cho các giá trị độ sâu. Mặc dù các ứng dụng sử dụng các phương thức sau trong SDK ARCore cũ vẫn sẽ hoạt động bằng cách sử dụng phạm vi độ 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 dành riêng cho nền tảng
| 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ả về ImageFormat.DEPTH16 |
Image.getFormat() trả về HardwareBuffer.D_16 |
| 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ả về AR_IMAGE_FORMAT_DEPTH16 |
ArImage_getFormat() trả về AR_IMAGE_FORMAT_D_16 |
Tất cả thay đổi đều do AR Foundation xử lý. Khi tạo 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 bằng phạm vi tối đa mới là 65.535 mét.