พฤศจิกายน 2022 เลิกใช้งานการนำเมธอดกล้องออกจาก ARCore SDK สำหรับ Android (Kotlin/Java)

ในเดือนพฤศจิกายน 2022 บริการ Google Play สำหรับ AR จะนำวิธีการที่เลิกใช้งานซึ่งเกี่ยวข้องกับรูปภาพและข้อมูลเมตาของกล้อง NDK ออก

แอปที่ใช้วิธีการเหล่านี้ใน ARCore SDK เวอร์ชันที่ได้รับผลกระทบอาจเริ่มทำงานแตกต่างออกไปหรือขัดข้องเมื่อผู้ใช้อัปเดตบริการ Google Play สำหรับ AR

แอปที่ได้รับผลกระทบ

ตั้งแต่เดือนพฤศจิกายน 2022 เป็นต้นไป แอปของคุณอาจหยุดทำงานหรือขัดข้องเมื่อผู้ใช้อัปเดต บริการ Google Play สำหรับ AR เป็นเวอร์ชันล่าสุดในกรณีต่อไปนี้

แอปของคุณได้รับการคอมไพล์ด้วย SDK ที่ได้รับผลกระทบ
แอปของคุณใช้ API ที่ได้รับผลกระทบต่อไปนี้

หากแอปได้รับการคอมไพล์ด้วย เวอร์ชัน ARCore SDK...	และใช้ API ที่ได้รับผลกระทบ...	ลักษณะการทํางานที่จะหยุดทํางานตั้งแต่เดือนพฤศจิกายน 2022
1.19.0 หรือต่ำกว่า	`Frame.getImageMetadata()`	ผ้าคลุม `IllegalArgumentException`
1.10.0 หรือต่ำกว่า	`Frame.acquireCameraImage()`	แสดงผลรูปภาพขนาด 0x0

แก้ไขแอปที่ได้รับผลกระทบ

แอปที่ได้รับผลกระทบอาจหยุดทำงานในเดือนพฤศจิกายน 2022 หากต้องการลดปัญหานี้ ให้สร้างแอปอีกครั้งโดยใช้ ARCore SDK เวอร์ชันล่าสุด คุณต้องอัปเกรดเป็น ARCore SDK เวอร์ชัน 1.20.0 ขึ้นไปเป็นอย่างน้อย

ยืนยันว่าแอปที่ได้รับผลกระทบได้รับการแก้ไขแล้ว

ทดสอบแอปโดยจำลองการเปลี่ยนแปลงในเดือนพฤศจิกายน 2022 ล่วงหน้าด้วยการเพิ่มรายการ meta-data พิเศษลงใน AndroidManifest.xml ของแอป โดยทำดังนี้

ตรวจสอบว่าได้ติดตั้ง Play Services สำหรับ AR เวอร์ชัน 1.29.0 ขึ้นไปในอุปกรณ์เป้าหมาย

เพิ่มแท็ก <meta-data> ใหม่เป็นองค์ประกอบย่อยขององค์ประกอบ <application> ที่มีอยู่ในไฟล์ AndroidManifest.xml ของแอป

<application …>
  …

  <!--
       Simulate the November 2022 changes in advance.
       IMPORTANT: Remove this tag when testing is completed.
       Do not include this tag in published versions of your app.
  -->
  <meta-data android:name="com.google.ar.core.session_settings"
             android:value="camera_stack_option,unified_mono" />
</application>

ทดสอบแอปและยืนยันว่าฟีเจอร์ ARCore ทั้งหมดทำงานได้ตามที่คาดไว้
นำแท็ก <meta-data> ออกเมื่อการทดสอบเสร็จสิ้น การวางแท็กนี้ไว้ในแอปที่เผยแพร่แล้วอาจส่งผลให้เกิดลักษณะการทำงานที่ไม่คาดคิดในอนาคต

หากแอปทำงานได้ตามปกติ แสดงว่าแอปพร้อมสำหรับการเปลี่ยนแปลงในเดือนพฤศจิกายน 2022

ไทม์ไลน์

ระยะเวลา	กิจกรรม
พฤศจิกายน 2020 (ARCore SDK เวอร์ชัน 1.20.0)	เลิกใช้งาน API แบบเนทีฟ อัปเดตการใช้งานเพื่อใช้ API เดิมทางเลือก
พฤศจิกายน 2021	ประกาศการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบในอนาคตเนื่องจากรอการนำ API ที่ได้รับผลกระทบออกจากบริการ Google Play สำหรับ AR ในเดือนพฤศจิกายน 2022
พฤศจิกายน 2022	นำการใช้งาน API ที่ได้รับผลกระทบออกจากบริการ Google Play สำหรับ AR เปิดตัวการเปลี่ยนแปลงที่ส่งผลต่อแอปที่ใช้ ARCore เวอร์ชันก่อน 1.20.0