Xoá các phương thức máy ảnh không dùng nữa đối với SDK ARCore dành cho Android NDK (AR Foundation) vào tháng 11 năm 2022

Vào tháng 11 năm 2022, Dịch vụ Google Play cho AR sẽ xoá các phương thức không dùng nữa liên quan đến hình ảnh và siêu dữ liệu của máy ảnh NDK.

Các ứng dụng sử dụng các phương thức này trong các phiên bản bị ảnh hưởng của AR Foundation có thể bắt đầu hành xử khác đi hoặc gặp sự cố khi người dùng cập nhật Dịch vụ Google Play cho Thực tế tăng cường.

Các ứng dụng bị ảnh hưởng

Kể từ tháng 11 năm 2022, ứng dụng của bạn có thể ngừng hoạt động hoặc gặp sự cố khi người dùng cập nhật lên phiên bản mới nhất của Dịch vụ Google Play cho AR nếu:

  1. Ứng dụng của bạn được biên dịch bằng một SDK bị ảnh hưởng
  2. Ứng dụng của bạn sử dụng bất kỳ API nào sau đây bị ảnh hưởng:
Nếu ứng dụng của bạn được biên dịch bằng
phiên bản AR Foundation… 		Và sử dụng các API bị ảnh hưởng… Hành vi gây lỗi bắt đầu từ tháng 11 năm 2022
AR Foundation 2.1 (Unity 2019 LTS) XRCameraSubsystem.TryGetLatestImage(out XRCameraImage) Trả về false.

Khắc phục các ứng dụng bị ảnh hưởng

Các ứng dụng bị ảnh hưởng có thể gặp sự cố vào tháng 11 năm 2022. Để giảm thiểu vấn đề này, hãy cập nhật lên phiên bản AR Foundation mới nhất mà phiên bản Unity của bạn hỗ trợ. Tối thiểu, hãy cập nhật lên AR Foundation phiên bản 4.x trở lên.

Xác minh rằng ứng dụng bị ảnh hưởng đã được khắc phục

Kiểm thử ứng dụng bằng cách mô phỏng trước các thay đổi vào tháng 11 năm 2022 bằng cách thêm một mục meta-data đặc biệt vào AndroidManifest.xml của ứng dụng:

  1. Đảm bảo Dịch vụ Play cho AR phiên bản 1.29.0 trở lên được cài đặt trên thiết bị mục tiêu.

  2. Thêm thẻ <meta-data> mới làm thành phần con của phần tử <application> hiện có trong tệp AndroidManifest.xml tuỳ chỉnh của ứng dụng:

    <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>

  3. Kiểm thử ứng dụng và xác minh rằng tất cả tính năng ARCore đều hoạt động như dự kiến.

  4. Xoá thẻ <meta-data> khi kiểm thử hoàn tất. Việc giữ lại thẻ này trong ứng dụng đã phát hành có thể dẫn đến hành vi không mong muốn trong tương lai.

Nếu ứng dụng hoạt động bình thường, thì ứng dụng đó đã sẵn sàng cho những thay đổi vào tháng 11 năm 2022.

Dòng thời gian

Khoảng thời gian Sự kiện
Tháng 11 năm 2020
(ARCore SDK phiên bản 1.20.0)		 Ngừng sử dụng API gốc.
Cập nhật cách triển khai để sử dụng các API gốc thay thế.
Tháng 11 năm 2021 Thông báo về thay đổi có thể gây lỗi trong tương lai do việc xoá đang chờ xử lý của việc triển khai các API bị ảnh hưởng khỏi Dịch vụ Google Play cho AR vào tháng 11 năm 2022.
Tháng 11 năm 2022 Xoá việc triển khai các API bị ảnh hưởng khỏi Dịch vụ Google Play cho Thực tế tăng cường.
Giới thiệu thay đổi có thể gây lỗi cho các ứng dụng sử dụng phiên bản ARCore trước phiên bản 1.23.0.