พฤศจิกายน 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 ของแอป ดังนี้

ตรวจสอบว่าได้ติดตั้งบริการ Google Play สำหรับ 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.