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

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