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 tính năng 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ó của bạn.

Định cấu hình ứng dụng thành Bắt buộc 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 không gian lưu trữ trên từng thiết bị, tất cả cá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. Ứng dụng này được Cửa hàng Play cập nhật riêng. Ứng dụng Android sử dụng các tính năng thực tế tăng cường giao tiếp với Dịch vụ Google Play cho Thực tế tăng cường bằng SDK ARCore. Bạn có thể định cấu hình cho một ứng dụng có hỗ trợ các tính năng thực tế tăng cường theo 2 cách: Cần có AR và Không bắt buộc sử dụng AR. 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 cần có AR không thể hoạt động mà không có ARCore. Giải pháp này yêu cầu một thiết bị hỗ trợ ARCore và đã 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 Yêu cầu thực tế tăng cường (AR) trên thiết bị hỗ trợ ARCore.
  • Khi người dùng cài đặt một ứng dụng Yêu cầu thực tế tăng cường (AR), 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 các bước kiểm tra bổ sung trong thời gian chạy phòng trường hợp Dịch vụ Google Play cho Thực tế tăng cường đã lỗi thời hoặc đã bị gỡ cài đặt theo cách thủ công.

Ứng dụng AR không bắt buộc dùng ARCore để cải thiện 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 (AR) không bắt buộc. Các tính năng này chỉ được kích hoạt trên những 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 không bắt buộc thực tế tăng cường (AR) trên thiết bị không hỗ trợ ARCore.
  • Khi người dùng cài đặt mộ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ị.
Yêu cầu thực tế tăng cườngThự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 có ARCore cho chức năng cơ bản. ARCore tăng cường chức năng cho ứng dụng của bạn. Ứ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 thông thường đối với trang thông tin.
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 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 về minSdkVersion của Android Android 7.0 (API cấp 24) Android 4.4 (API cấp 19), mặc dù việc chạy mọi chức năng thực tế tăng cường đều yêu cầu Android 7.0 (API cấp 24) trở lên
Phải sử dụng ARSession.state để kiểm tra khả năng hỗ trợ và trạng thái cài đặt ARCore
Phải sử dụng coroutine ARSession.Install() để cài đặt Dịch vụ Google Play cho Thực tế tăng cường

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

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

  3. Trong phần 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ó .

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

Thêm thực tế tăng cường (AR) cho ứng dụng (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 thành AR (không bắt buộc).

  3. Nhấp vào Edit > Project Settings > Player, chọn thẻ có .

  4. Trong phần 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 AR (không bắt buộc).

  3. Nhấp vào Edit > Project Settings > Player, chọn thẻ có .

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

Trong thời gian chạy, các ứng dụng Yêu cầu thực tế tăng cường sẽ tự động 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 chưa cài đặt (có thể là 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 đã cập nhật. Nếu đã cũ, ứ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 tuỳ chọn 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 AR.
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 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 Google Play Services for AR và/hoặc Dữ liệu hồ sơ thiết bị ARCore bằng cách gọi ARSession.Install().
Thiết bị hỗ trợ ARCore, Google Play Services for AR và Dữ liệu hồ sơ thiết bị 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 trạng thái cài đặt và trạng thái hỗ trợ.

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

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

Bước tiếp theo