ในเดือนพฤศจิกายน 2022 Google Play Services สำหรับ AR จะนําวิธีการที่เลิกใช้งานแล้วออก ซึ่งเกี่ยวข้องกับรูปภาพและข้อมูลเมตาของกล้อง NDK
แอปที่ใช้เมธอดเหล่านี้ใน ARCore SDK เวอร์ชันที่ได้รับผลกระทบอาจเริ่มทำงานต่างจากเดิมหรือขัดข้องเมื่อผู้ใช้อัปเดตบริการ Google Play สำหรับ AR
แอปที่ได้รับผลกระทบ
ตั้งแต่เดือนพฤศจิกายน 2022 เป็นต้นไป แอปของคุณอาจหยุดทำงานหรือขัดข้องเมื่อผู้ใช้อัปเดต บริการ Google Play สำหรับ AR เป็นเวอร์ชันล่าสุดในกรณีต่อไปนี้
- แอปของคุณได้รับการคอมไพล์ด้วย SDK ที่ได้รับผลกระทบ
- แอปของคุณใช้ API ที่ได้รับผลกระทบต่อไปนี้
|
หากแอปของคุณคอมไพล์ด้วย เวอร์ชัน ARCore SDK… |
และใช้ API ที่ได้รับผลกระทบ… | ลักษณะการทํางานที่จะหยุดทํางานตั้งแต่เดือนพฤศจิกายน 2022 |
|---|---|---|
| 1.19.0 หรือต่ำกว่า | Frame.getImageMetadata() |
ผ้าคลุม IllegalArgumentException |
| 1.10.0 หรือต่ำกว่า | Frame.acquireCameraImage() |
แสดงผลรูปภาพขนาด 0x0 |
แก้ไขแอปที่ได้รับผลกระทบ
แอปที่ได้รับผลกระทบอาจหยุดทำงานในเดือนพฤศจิกายน 2022 หากต้องการลดปัญหานี้ ให้สร้างแอปอีกครั้งโดยใช้ ARCore SDK เวอร์ชันล่าสุด คุณต้องอัปเกรดเป็น ARCore SDK เวอร์ชัน 1.20.0 ขึ้นไปเป็นอย่างน้อย
ยืนยันว่าแอปที่ได้รับผลกระทบได้รับการแก้ไขแล้ว
ทดสอบแอปโดยจำลองการเปลี่ยนแปลงในเดือนพฤศจิกายน 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.20.0 |