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

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

แอปที่ใช้วิธีการเหล่านี้ในเวอร์ชันที่ได้รับผลกระทบของ พื้นฐาน AR อาจเริ่ม ลักษณะการทำงานต่างออกไปหรือเกิดข้อขัดข้องเมื่อผู้ใช้อัปเดตบริการ 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 ของแอป ดังนี้

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