พฤศจิกายน 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