Các 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 độ sâu tối đa của 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
Android (Kotlin/Java)
| Tên phương thức và chức năng trước đây | 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 | Tầm bắn tối đa 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 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 |
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.