พฤษภาคม 2022 (ARCore SDK เวอร์ชัน 1.31) จะเปลี่ยนเป็นความลึก

การเปลี่ยนแปลงที่ระบุไว้ในเอกสารนี้มีผลกับแอปที่คอมไพล์ด้วย ARCore SDK เวอร์ชัน 1.31 ขึ้นไปเท่านั้น แอปที่คอมไพล์ด้วย ARCore เวอร์ชันเก่าจะไม่ได้รับผลกระทบ

ในการเปิดตัวเวอร์ชัน 1.31 ของเดือนพฤษภาคม 2022 เราได้อัปเกรดระยะความลึกสูงสุดของ ARCore จาก 8.191 เมตรเป็น 65.535 เมตร ตอนนี้ Depth API ใช้ 16 บิตทั้งหมดต่อพิกเซลเพื่อแสดงระดับความลึก ซึ่งก่อนหน้านี้ใช้เพียง 13 บิตสำหรับค่าความลึก แม้ว่าแอปที่ใช้วิธีการต่อไปนี้ใน ARCore SDK เวอร์ชันเก่าจะยังคงทำงานโดยใช้ช่วงความลึกก่อนหน้าได้ แต่เราขอแนะนำให้อัปเดตแอปเหล่านั้นในโค้ดเบสเพื่อให้ฟังก์ชันการทำงานดีขึ้น

การเปลี่ยนแปลงเฉพาะแพลตฟอร์ม

Android (Kotlin/Java)

ชื่อและฟังก์ชันการทำงานของเมธอดก่อนหน้า ชื่อและฟังก์ชันการทำงานของเมธอดใหม่
ระยะทางสูงสุด 8.191 เมตร ระยะสัญญาณสูงสุด 65.535 เมตร
Frame.acquireDepthImage() Frame.acquireDepthImage16Bits()
Frame.acquireRawDepthImage() Frame.acquireRawDepthImage16Bits()
Image.getFormat() returns ImageFormat.DEPTH16 Image.getFormat() returns HardwareBuffer.D_16

Android NDK (C)

ชื่อวิธีการและฟังก์ชันการทำงานก่อนหน้า ชื่อและฟังก์ชันการทำงานของเมธอดใหม่
ระยะทางสูงสุด 8.191 เมตร ระยะทางสูงสุด 65.535 เมตร
ArFrame_acquireDepthImage() ArFrame_acquireDepthImage16Bits()
ArFrame_acquireRawDepthImage() ArFrame_acquireRawDepthImage16Bits()
ArImage_getFormat() returns AR_IMAGE_FORMAT_DEPTH16 ArImage_getFormat() ส่งคืน AR_IMAGE_FORMAT_D_16

Unity (AR Foundation)

AR Foundation จะจัดการการเปลี่ยนแปลงทั้งหมด เมื่อสร้างด้วยส่วนขยาย ARCore สำหรับ AR Foundation เวอร์ชัน 1.31 ขึ้นไป AROcclusionManager.TryAcquireEnvironmentDepthCpuImage จะแสดงผลรูปภาพโดยใช้ระยะทางสูงสุดใหม่ 65.535 เมตร