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 (C) vào tháng 11 năm 2022

Kể từ 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 siêu dữ liệu và hình ảnh của camera NDK.

Các ứng dụng dùng các phương pháp này trong những phiên bản bị ảnh hưởng của SDK ARCore có thể bắt đầu hoạt động 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

Lưu ý quan trọng: Ứng dụng được biên dịch bằng SDK ARCore phiên bản 1.23.0 trở lên sẽ không bị ảnh hưởng.

Kể từ tháng 11 năm 2022, có thể ứng dụng của bạn sẽ 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 Thực tế tăng cường nếu:

1. Ứng dụng của bạn đã được biên dịch với một SDK bị ảnh hưởng
2. Ứng dụng của bạn sử dụng bất kỳ API nào bị ảnh hưởng sau đây:

Nếu ứng dụng được biên dịch bằng Phiên bản SDK ARCore...	Đồng thời 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, sử dụng lựa chọn 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 từ ArImage. Ví dụ:
  • AImage_getNumberOfPlanes() trở thành ArImage_getNumberOfPlanes()
  • AImage_getPlaneData() trở thành ArImage_getPlaneData()
• ArImage_getNdkCameraMetadata(): Sử dụng ArImageMetadata_getConstEntry()

Kiểm tra để đảm bảo ứ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 những thay đổi trong 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. Hãy đảm bảo bạn đã cài đặt Dịch vụ Play cho Thực tế tăng cường phiên bản 1.29.0 trở lên trên thiết bị mục tiêu.

2. 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 ứng dụng Tệp 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>
   

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

4. Xoá thẻ <meta-data> khi quá trình kiểm thử hoàn tất. Thoát khỏi thẻ này trong ứng dụng đã xuất bản của bạn 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 này đã sẵn sàng cho các 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 (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ề sự thay đổi có thể gây lỗi trong tương lai do đang chờ xoá nội dung triển khai về các API bị ảnh hưởng qua 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á phương thứ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. Ra mắt thay đổi có thể gây lỗi cho những ứng dụng sử dụng các phiên bản ARCore trước 1.23.0.