Vào tháng 11 năm 2022, Dịch vụ Google Play cho Thực tế tăng cường 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 dùng các phương thức này trong các phiên bản SDK ARCore bị ảnh hưởng có thể bắt đầu hoạt động theo cách khác 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 Dịch vụ Google Play cho Thực tế tăng cường mới nhất nếu:
- Ứng dụng của bạn được biên dịch bằng một SDK bị ảnh hưởng
- Ứng dụng của bạn có sử dụng những API bị ảnh hưởng sau đây:
Nếu ứng dụng được biên dịch bằng phiên bản SDK ARCore... |
Và sử dụng các API bị ảnh hưởng... | Hành vi có thể gây lỗi bắt đầu từ tháng 11 năm 2022 |
---|---|---|
1.22.0 trở xuống | ArImage_getNdkImage() (đã bị xoá trong SDK ARCore 1.23.0) |
Trả về NULL trong cấu trúc AImage thu được. |
1.22.0 trở xuống | ArImage_getNdkCameraMetadata() (đã bị xoá trong SDK ARCore 1.23.0) |
Trả về NULL trong cấu trúc ACameraMetadata thu được. |
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 điều này, hãy sử dụng các phương thức thay thế thả xuống cho các phương thức bị ảnh hưởng:
- Phương thức
ArImage_getNdkImage()
vàAImage_*
: Sử dụng các phương thức tương ứng trongArImage
. Ví dụ: ArImage_getNdkCameraMetadata()
: Sử dụngArImageMetadata_getConstEntry()
Kiểm tra để đảm bảo 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:
- Đảm bảo Dịch vụ Play cho Thực tế tăng cường phiên bản 1.29.0 trở lên được cài đặt trên thiết bị mục tiêu.
Thêm một thẻ
<meta-data>
mới làm phần tử con của phần tử<application>
hiện có trong tệpAndroidManifest.xml
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>
Kiểm thử ứng dụng và xác minh rằng tất cả tính năng ARCore đang hoạt động như dự kiến.
Hãy xoá thẻ
<meta-data>
khi quá trình kiểm thử hoàn tất. Việc để thẻ này vào đúng vị trí 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 các thay đổi vào tháng 11 năm 2022.
Lịch trình
Khoảng thời gian | Sự kiện |
---|---|
Tháng 11 năm 2020 (SDK ARCore phiên bản 1.20.0) |
Ngừng sử dụng các API bị ảnh hưởng, giới thiệu các lựa chọn thay thế API thả xuống. |
Tháng 2 năm 2021 (SDK ARCore phiên bản 1.23.0) |
Xoá các chữ ký API không dùng nữa khỏi SDK ARCore. |
Tháng 11 năm 2021 | Thông báo về thay đổi có thể gây lỗi trong tương lai do yêu cầu xoá hoạt động triển khai API bị ảnh hưởng khỏi Dịch vụ Google Play cho Thực tế tăng cường vào tháng 11 năm 2022. |
Tháng 11 năm 2022 |
Xoá hoạt động 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 các phiên bản ARCore trước phiên bản 1.23.0. |