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

ในเดือนพฤศจิกายน 2022 Google Play Services สำหรับ 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