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

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

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

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

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

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

หากแอปของคุณคอมไพล์ด้วย เวอร์ชัน AR Foundation…	และใช้ API ที่ได้รับผลกระทบ…	ลักษณะการทํางานที่จะหยุดทํางานตั้งแต่เดือนพฤศจิกายน 2022
AR Foundation 2.1 (Unity 2019 LTS)	`XRCameraSubsystem.TryGetLatestImage(out XRCameraImage)`	คืนสินค้า `false`

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

แอปที่ได้รับผลกระทบอาจหยุดทำงานในเดือนพฤศจิกายน 2022 หากต้องการลดปัญหานี้ ให้อัปเดต AR Foundation เป็นเวอร์ชันล่าสุดที่ Unity เวอร์ชันของคุณรองรับ อัปเดตเป็น AR Foundation เวอร์ชัน 4.x ขึ้นไปเป็นอย่างน้อย

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

ทดสอบแอปโดยจำลองการเปลี่ยนแปลงในเดือนพฤศจิกายน 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.23.0