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

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

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

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

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

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

หากแอปมีคอมไพล์ด้วย เวอร์ชัน ARCore SDK...	และใช้ API ที่ได้รับผลกระทบ...	ลักษณะการทํางานชั่วคราวเริ่มตั้งแต่เดือนพฤศจิกายน 2022
1.22.0 หรือต่ำกว่า	`ArImage_getNdkImage()` (นำออกจาก ARCore SDK 1.23.0)	แสดงผล `NULL` ในโครงสร้าง `AImage` ที่ได้
1.22.0 หรือต่ำกว่า	`ArImage_getNdkCameraMetadata()` (นำออกจาก ARCore SDK 1.23.0)	แสดงผล `NULL` ในโครงสร้าง `ACameraMetadata` ที่ได้

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

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

เมธอด ArImage_getNdkImage() และ AImage_*: ใช้วิธีการที่สอดคล้องกันจาก ArImage เช่น
- AImage_getNumberOfPlanes() เปลี่ยนเป็น ArImage_getNumberOfPlanes()
- AImage_getPlaneData() เปลี่ยนเป็น ArImage_getPlaneData()
ArImage_getNdkCameraMetadata(): ใช้ ArImageMetadata_getConstEntry() แทน

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

ทดสอบแอปโดยการจำลองการเปลี่ยนแปลงเดือนพฤศจิกายน 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 (ARCore SDK เวอร์ชัน 1.23.0)	นําลายเซ็น API ที่เลิกใช้งานแล้วออกจาก ARCore SDK
พฤศจิกายน 2021	ประกาศการเปลี่ยนแปลงที่ส่งผลในอนาคตเนื่องจากรอการนำ API ที่ได้รับผลกระทบออกจากบริการ Google Play สำหรับ AR ในเดือนพฤศจิกายน 2022
พฤศจิกายน 2022	นำการใช้ API ที่ได้รับผลกระทบออกจากบริการ Google Play สำหรับ AR เปิดตัวการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบสำหรับแอปที่ใช้ ARCore เวอร์ชันก่อน 1.23.0