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