พฤษภาคม 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() ส่งคืน ImageFormat.DEPTH16 Image.getFormat() ส่งคืน HardwareBuffer.D_16

Android NDK (C)

ชื่อวิธีการและฟังก์ชันก่อนหน้า ชื่อเมธอดและฟังก์ชันใหม่
ระยะทางสูงสุด 8.191 เมตร ระยะทางสูงสุด 65.535 เมตร
ArFrame_acquireDepthImage() ArFrame_acquireDepthImage16Bits()
ArFrame_acquireRawDepthImage() ArFrame_acquireRawDepthImage16Bits()
ArImage_getFormat() ส่งคืน 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 เมตร