Tháng 5 năm 2022 (SDK ARCore phiên bản 1.31) thay đổi thành Chiều sâu

Những thay đổi 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 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.

Là một phần của 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. API Chiều sâu hiện sử dụng toàn bộ 16 bit mỗi pixel để biểu thị độ sâu, trong khi trước đây chỉ 13 bit được dùng cho giá trị độ sâu. Mặc dù các ứng dụng dùng các phương thức sau trong SDK ARCore cũ sẽ vẫn 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.

Thay đổi theo nền tảng cụ thể

Android (Kotlin/Java)

Tên và chức năng trước đó của phương thức Tên và chức năng mới của phương thức
Phạm vi tối đa 8,191 mét Phạm vi 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 trước đó của phương thức Tên và chức năng mới của phương thức
Phạm vi tối đa 8,191 mét Phạm vi tối đa 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)

Tất cả các thay đổi đều do AR Foundation xử lý. Khi xây dựng bằng các tiện ích ARCore Extensions dành cho AR Foundation phiên bản 1.31 trở lên, AROcclusionManager.TryAcquireEnvironmentDepthCpuImage sẽ trả về hình ảnh bằng cách sử dụng phạm vi tối đa mới là 65,535 mét.