พฤศจิกายน 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