Bật AR trong ứng dụng AR Foundation (chỉ dành cho Android)

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

Thiết lập để ứng dụng của bạn đáp ứng yêu cầu AR hoặc 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 đều đượ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 được Cửa hàng Play cập nhật riêng. Các ứng dụng Android sử dụng các tính năng AR sẽ giao tiếp với Dịch vụ Google Play cho AR bằ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 thực tế tăng cườngKhông bắt buộc 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 ứng dụng Dịch vụ Google Play cho 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. Nó yêu cầu một thiết bị được hỗ trợ ARCore đã cài đặt Dịch vụ Google Play cho AR.

  • 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 AR cần thiết, 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 vẫn phải thực hiện thêm các bước kiểm tra 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) đã cũ hoặc bị gỡ cài đặt theo cách thủ công.

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

  • Bạn có thể cài đặt và chạy các ứng dụng AR không bắt buộc trên các thiết bị không hỗ trợ ARCore.
  • Khi người dùng cài đặt một ứng dụng AR không bắt buộc, 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ị.
Yêu cầu ARAR (không bắt buộc)
Sử dụng tính năng thực tế tăng cường Ứng dụng của bạn cần có ARCore để có 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ỉ có 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 liệt kê thông thường.
Phương thức cài đặt Dịch vụ Google Play cho Thực tế tăng cường Cửa hàng Play 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 sẽ dùng ARSession.state để tải xuống và cài đặt ARCore.
Yêu cầu của 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 thực tế tăng cường nào yêu cầu ít nhất Android 7.0 (API cấp 24)
Phải dùng ARSession.state để kiểm tra trạng thái hỗ trợ và cài đặt ARCore

Yêu cầu ứng dụng thực tế tăng cường

Android

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

  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. Requirement được đặt thành Required theo mặc định.

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

  3. Trong Other Settings > Configuration, hãy chỉ định Target minimum iOS Version cho ứng dụng của bạn.

Đặt ứng dụng của bạn ở chế độ thực tế tăng cường (AR) (không bắt buộc)

Android

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

  2. Trong trình đơn thả xuống Requirement, hãy chọn Optional để đặt ứng dụng của bạn ở chế độ thực tế tăng cường (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. Trong trình đơn thả xuống Requirement, hãy chọn Optional để đặt ứng dụng của bạn thành Chế độ thực tế tăng cường 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 Other Settings > Configuration, hãy chỉ định Target minimum iOS Version cho ứng dụng của bạn.

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

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

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

Trong thời gian chạy, các ứng dụng Bắt buộc thực tế tăng cường sẽ tự động thực hiện các bước kiểm tra trong 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 phiên bản này chưa được cài đặt (có thể do người dùng đã xoá) hoặc phiên bản quá cũ, thì ứ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 mới nhất về hồ sơ thiết bị ARCore — nếu dữ liệu đã lỗi thời, thì ứ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 bước kiểm tra mặc định này. Ứng dụng của bạn vẫn sẽ 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 Google Play Services for AR và/hoặc dữ liệu hồ sơ thiết bị ARCore không đượ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ợ dữ liệu cấu hình thiết bị ARCore, Google Play Services for AR và ARCore được cài đặt và cập nhật. Tạo một ARCore Session và bắt đầu sử dụng ARCore.

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

Tuân thủ 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 rằng ứng dụng của bạn tuân thủ Các yêu cầu về quyền riêng tư của người dùng của ARCore.

Bước tiếp theo