Bật tính năng thực tế tăng cường (AR) trong ứng dụng Nền tảng thực tế tăng cường (AR) (chỉ dành cho Android)

Bật thực tế tăng cường để sử dụng các tính năng thực tế tăng cường trong ứng dụng mới hoặc ứng dụng hiện có.

Định cấu hình ứng dụng của bạn thành Yêu cầu thực tế tăng cường (AR) hoặc Thực tế tăng cường (AR) không bắt buộc

Để tiết kiệm dung lượng trên từng thiết bị, tất cả tính năng thực tế tăng cường được lưu trữ trong một ứng dụng có tên là Dịch vụ Google Play cho thực tế tăng cường. Ứng dụng này được Cửa hàng Play cập nhật riêng. Ứng dụng Android dùng tính năng AR kết nối với Dịch vụ Google Play cho Thực tế tăng cường bằng cách dùng SDK ARCore. Bạn có thể định cấu hình một ứng dụng hỗ trợ các tính năng thực tế tăng cường theo hai cách: Bắt buộc đối với AR và Không bắt buộc đối với công nghệ thực tế tăng cường. Chỉ định này xác định cách ứng dụng tương tác với Dịch vụ Google Play cho ứng dụng thực tế tăng cường.

Ứng dụng Yêu cầu AR không thể hoạt động nếu không có ARCore. Tính năng này yêu cầu thiết bị được hỗ trợ ARCore đã cài đặt Dịch vụ Google Play cho Thực tế tăng cường.

  • Cửa hàng Google Play sẽ chỉ cung cấp các ứng dụng Bắt buộc thực tế tăng cường trên các thiết bị hỗ trợ ARCore.
  • Khi người dùng cài đặt một ứng dụng Bắt buộc thực tế tăng cường, Cửa hàng Google Play sẽ tự động cài đặt Dịch vụ Google Play cho Thực tế tăng cường trên thiết bị của họ. Tuy nhiên, ứng dụng của bạn vẫn phải thực hiện bước kiểm tra bổ sung trong thời gian chạy trong trường hợp Dịch vụ Google Play cho Thực tế tăng cường (AR) đã lỗi thời hoặc bị gỡ cài đặt theo cách thủ công.

Ứng dụng Không bắt buộc thực tế tăng cường sử dụng ARCore để nâng cao chức năng hiện có. Phiên bản này có các tính năng thực tế tăng cường (không bắt buộc) chỉ kích hoạt trên các thiết bị hỗ trợ ARCore và đã cài đặt Dịch vụ Google Play cho Thực tế tăng cường.

  • Bạn có thể cài đặt và chạy các ứng dụng AR không bắt buộc trên những thiết bị không hỗ trợ ARCore.
  • Khi người dùng cài đặt ứng dụng Thực tế tăng cường (AR), Cửa hàng Google Play sẽ không tự động cài đặt Dịch vụ Google Play cho Thực tế tăng cường trên thiết bị.
Bắt buộc phải bật ARThực tế tăng cường (AR) không bắt buộc
Mức sử dụng Tính năng thực tế tăng cường Ứng dụng của bạn cần ARCore cho chức năng cơ bản. ARCore tăng cường chức năng của ứng dụng. Ứng dụng của bạn có thể chạy mà không cần hỗ trợ ARCore.
Chế độ hiển thị trên Cửa hàng Play Ứng dụng của bạn chỉ xuất hiện trong Cửa hàng Play trên các thiết bị hỗ trợ ARCore. Ứng dụng của bạn tuân theo quy trình đăng thông tin thông thường.
Phương thức cài đặt Thực tế tăng cường của Dịch vụ Google Play Cửa hàng Play sẽ cài đặt Dịch vụ Google Play cho Thực tế tăng cường cùng với ứng dụng của bạn. Ứng dụng của bạn dùng coroutine ARSession.Install() để tải xuống và cài đặt ARCore.
Yêu cầu đối với Android minSdkVersion Android 7.0 (API cấp 24) Android 4.4 (API cấp 19), mặc dù để chạy bất kỳ chức năng AR nào yêu cầu tối thiểu là Android 7.0 (API cấp 24)
Phải dùng ARSession.state để kiểm tra trạng thái cài đặt và hỗ trợ ARCore
Phải dùng coroutine ARSession.Install() để cài đặt Dịch vụ Google Play cho Thực tế tăng cường

Bắt buộc bật tính năng Thực tế tăng cường cho ứng dụng của bạn

Android

  1. Chuyển đến Edit > Project Settings > XR Plug-in Management > ARCore. Theo mặc định, Requirement được đặt thành Required.

  2. Nhấp vào Edit > Project Settings > Player, chọn thẻ có biểu tượng Android.

  3. Trong Other Settings > Identification, hãy chỉ định Minimum API Level từ 24 trở lên.

iOS

  1. Chuyển đến Edit > Project Settings > XR Plug-in Management > ARKit. Theo mặc định, Requirement được đặt thành Required.

  2. Nhấp vào Edit > Project Settings > Player, chọn thẻ có biểu tượng iOS.

  3. Trong phần Other Settings > Configuration, hãy chỉ định Target minimum iOS Version cho ứng dụng.

Cài đặt ứng dụng thực tế tăng cường (AR) là không bắt buộc

Android

  1. Chuyển đến Edit > Project Settings > XR Plug-in Management > ARCore.

  2. Từ trình đơn thả xuống Requirement, hãy chọn Optional để đặt ứng dụng của bạn thành AR (không bắt buộc).

  3. Nhấp vào Edit > Project Settings > Player, chọn thẻ có biểu tượng Android.

  4. Trong Other Settings > Identification, hãy chỉ định Minimum API Level từ 24 trở lên.

iOS

  1. Chuyển đến Edit > Project Settings > XR Plug-in Management > ARKit.

  2. Từ trình đơn thả xuống Requirement, hãy chọn Optional để đặt ứng dụng của bạn thành AR (không bắt buộc).

  3. Nhấp vào Edit > Project Settings > Player, chọn thẻ có biểu tượng iOS.

  4. Trong phần Other Settings > Configuration, hãy chỉ định Target minimum iOS Version cho ứng dụng.

Thực hiện kiểm tra thời gian chạy

Kiểm tra xem bạn đã cài đặt Dịch vụ Google Play cho Thực tế tăng cường hay chưa

Cả ứng dụng Bắt buộc thực tế tăng cường (AR) và Thực tế tăng cường (AR) không bắt buộc đều phải sử dụng coroutine ARSession.Install() trước khi tạo phiên ARCore để kiểm tra xem phiên bản Dịch vụ Google Play cho Thực tế tăng cường (AR) tương thích đã được cài đặt (vẫn) hay chưa, cũng như để đảm bảo rằng tất cả dữ liệu hồ sơ thiết bị ARCore cần thiết đều đã được tải xuống.

Trong thời gian chạy, các ứng dụng bắt buộc về AR sẽ tự động thực hiện quy trình kiểm tra thời gian chạy để đảm bảo rằng thiết bị mục tiêu:

  • Hỗ trợ ARCore
  • Đã cài đặt Google Play Services for AR – nếu ứng dụng này chưa được cài đặt (có thể do người dùng đã xoá) hoặc phiên bản quá cũ, ứng dụng sẽ nhắc người dùng cài đặt hoặc cập nhật ứng dụng.
  • Có dữ liệu hồ sơ thiết bị ARCore mới nhất. Nếu chưa cập nhật, ứng dụng của bạn sẽ tải dữ liệu mới xuống.

Đặt ARSession.attemptUpdate thành false để tắt các chế độ kiểm tra mặc định này. Ứng dụng của bạn vẫn phải xử lý các điều kiện sau:

Điều kiện Hành động
Thiết bị không hỗ trợ ARCore. Ẩn chức năng liên quan đến thực tế tăng cường.
Thiết bị hỗ trợ ARCore, nhưng dữ liệu hồ sơ thiết bị Google Play Services for AR và/hoặc ARCore chưa được cài đặt hoặc lỗi thời. Nhắc người dùng cài đặt hoặc cập nhật dữ liệu hồ sơ thiết bị Google Play Services for AR và/hoặc ARCore bằng cách gọi ARSession.Install().
Thiết bị hỗ trợ ARCore và Google Play Services for AR cũng như dữ liệu hồ sơ thiết bị ARCore được cài đặt và cập nhật. Tạo ARCore Session và bắt đầu sử dụng ARCore.

Bạn cũng có thể kiểm tra ARSession.state để biết trạng thái cài đặt và hỗ trợ.

Tuân thủ các Yêu cầu về quyền riêng tư của người dùng

Để phát hành ứng dụng trên Cửa hàng Play, hãy đảm bảo ứng dụng của bạn tuân thủ Yêu cầu về quyền riêng tư của người dùng của ARCore.

Bước tiếp theo