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 AR để 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 AR Required (Bắt buộc phải có AR) hoặc AR Optional (Không bắt buộc phải có AR)

Để tiết kiệm dung lượng 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. Các ứng dụng Android sử dụng tính năng AR 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 một ứng dụng hỗ trợ các tính năng AR theo hai cách: AR bắt buộc và AR không bắt buộc. Chỉ định này xác định cách ứng dụng thực tế tăng cườ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. Ứng dụ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 AR Required trên những thiết bị hỗ trợ ARCore.
  • Khi người dùng cài đặt một ứng dụng Yêu cầu 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 quy trình 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 đã lỗi thời hoặc bị gỡ cài đặt theo cách thủ công.

Ứng dụng AR Optional sử dụng ARCore để cải thiện chức năng hiện có. Ứng dụng này có các tính năng thực tế tăng cường không bắt buộc và chỉ được kích hoạt trên các thiết bị có hỗ trợ ARCore đã 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 Optional trên những thiết bị không hỗ trợ ARCore.
  • Khi người dùng cài đặt một ứng dụng AR Optional, 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 về thực tế tăng cườngKhông bắt buộc sử dụng thực tế tăng cường
Mức sử dụng tính năng AR Ứng dụng của bạn cần 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.
Trạng thái hiển thị trên Cửa hàng Play Ứng dụng của bạn chỉ được liệt kê trong Cửa hàng Play trên những thiết bị hỗ trợ ARCore. Ứng dụng của bạn tuân theo quy trình đăng 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 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 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 mọi chức năng AR đều yêu cầu tối thiểu Android 7.0 (API cấp 24)
Phải sử dụng ARSession.state để kiểm tra trạng thái hỗ trợ và cài đặt ARCore
Phải sử dụng đồng thường trình ARSession.Install() để cài đặt Dịch vụ Google Play cho Thực tế tăng cường

Yêu cầu ứng dụng của bạn hỗ trợ 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 một Minimum API Level là 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 phần Other Settings > Configuration, hãy chỉ định Target minimum iOS Version cho ứng dụng của bạn.

Làm cho ứng dụng của bạn có tính nă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 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 một Minimum API Level là 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 Optional.

  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 của bạn.

Thực hiện các bước 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 AR Required và AR Optional đều phải sử dụng ARSession.Install() coroutine trước khi tạo một phiên ARCore để kiểm tra xem phiên bản tương thích của Dịch vụ Google Play cho Thực tế tăng cường đã được cài đặt (vẫn) 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 AR Required sẽ tự động thực hiện các 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 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 của bạn sẽ nhắc người dùng cài đặt hoặc cập nhật.
  • Có dữ liệu hồ sơ thiết bị ARCore mới nhất – nếu dữ liệu này đã 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 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 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 và Google Play Services for AR, đồng thời dữ liệu hồ sơ thiết bị ARCore đã được cài đặt và là dữ liệu mới nhất. Tạo một Session ARCore 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

Để xuất bản ứ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ủ Yêu cầu về quyền riêng tư của người dùng của ARCore.

Bước tiếp theo