Bật API Không gian địa lý cho ứng dụng Unity (AR Foundation) nhắm đến Android

Định cấu hình chế độ cài đặt của ứng dụng để có thể sử dụng API Không gian địa lý.

Điều kiện tiên quyết

Đảm bảo rằng bạn hiểu rõ các khái niệm cơ bản về AR và cách định cấu hình phiên ARCore trước khi tiếp tục.

Xem Giới thiệu về API Không gian địa lý để biết thêm thông tin thông tin về API không gian địa lý.

Nếu bạn mới phát triển bằng ARCore, hãy xem phần Bắt đầu để biết thông tin về các yêu cầu, điều kiện tiên quyết và phần mềm và phần cứng thông tin khác dành riêng cho các nền tảng mà bạn đang sử dụng.

Để sử dụng API Không gian địa lý ARCore, dự án của bạn phải hỗ trợ Quỹ AR và các tiện ích ARCore cho AR Foundation.

Bật API ARCore

Trước khi sử dụng Hệ thống định vị hình ảnh (VPS) trong ứng dụng của mình, bạn phải bật ARCore API trong một dự án mới hoặc hiện có trên Google Cloud. Dịch vụ này chịu trách nhiệm về lưu trữ, lưu trữ và giải quyết các neo không gian địa lý.

Ưu tiên phương thức uỷ quyền không dùng khoá, nhưng hệ thống cũng hỗ trợ phương thức uỷ quyền Khoá API.

Thêm các thư viện cần thiết vào ứng dụng của bạn

Sau khi cho phép ứng dụng của bạn gọi API ARCore, bạn phải thêm thư viện vào bật tính năng Không gian địa lý trong ứng dụng của bạn.

  1. Chuyển đến Chỉnh sửa > Cài đặt dự án > Quản lý plugin XR > Tiện ích ARCore.
  2. Trong Đối tượng không bắt buộc, hãy chọn Không gian địa lý.

Bật các chức năng Không gian địa lý trong cấu hình phiên

Sau khi bạn bật chức năng Không gian địa lý trong ứng dụng, hãy bật các chức năng Không gian địa lý trong phần cấu hình phiên AR của ứng dụng để có thể giao tiếp với ARCore API:

  1. Đảm bảo rằng thư mục Assets (Tài sản) của dự án chứa đối tượng có thể tạo tập lệnh ARCoreExtensionConfig. Để tạo tài sản, hãy nhấp chuột phải vào ngăn Assets (Tài sản) rồi chọn Create (Tạo) > XR > Cấu hình tiện ích ARCore.

  2. Chọn đối tượng có thể tạo tập lệnh ARCoreExtensionsConfig trong thư mục ARCoreExtensionsConfig (Thành phần) rồi đặt ARCoreExtensionsConfig thành ARCoreExtensionsConfig (Bật).

  3. Định cấu hình đối tượng trò chơi ARCore Extensions để sử dụng cấu hình ARCoreExtensionConfig. Trong ngăn Phân cấp, hãy tìm đối tượng trò chơi ARCore Extensions mà bạn đã tạo khi thiết lập Tiện ích ARCore lần đầu tiên, rồi kết nối trường Cấu hình tiện ích ARCore với đối tượng có thể tạo tập lệnh ARCoreExtensionConfig trong thư mục Assets của mình.

Nhắc người dùng cho phép sử dụng dữ liệu thiết bị

Ứng dụng dùng API Không gian địa lý ARCore phải hiển thị cho người dùng lời nhắc để xác nhận và cho phép sử dụng dữ liệu trên thiết bị của trẻ. Xem Yêu cầu về quyền riêng tư của người dùng để biết thêm thông tin của bạn.

Kiểm tra khả năng tương thích của thiết bị

Không phải thiết bị nào hỗ trợ ARCore cũng hỗ trợ API Không gian địa lý. Để kiểm tra đến thiết bị của người dùng về tính tương thích, AREarthManager.IsGeospatialModeSupported(). Nếu giá trị trả về FeatureSupported.Unsupported không được cố định cấu hình phiên hoạt động.

Yêu cầu người dùng cấp quyền truy cập thông tin vị trí trong thời gian chạy

Tiện ích ARCore tự động yêu cầu quyền truy cập thông tin vị trí thích hợp khi bạn bật Chế độ không gian địa lý trong ARCoreExtensions.Update(). Nếu người dùng không cấp quyền truy cập thông tin vị trí chính xác, phiên không tiếp tục được và "chưa được cấp quyền" lỗi. Đây là chấm dứt và yêu cầu khởi động lại để kích hoạt lại yêu cầu cấp quyền.

Kiểm tra tính khả dụng không gian địa lý tại vị trí hiện tại của thiết bị

Vì API Không gian địa lý sử dụng tổ hợp VPS và GPS để xác định tư thế Không gian địa lý, nên bạn có thể sử dụng API này, miễn là thiết bị có thể xác định được vị trí của thiết bị. Ở những khu vực có độ chính xác GPS thấp, chẳng hạn như không gian trong nhà và môi trường đô thị đông đúc, API sẽ dựa vào phạm vi phủ sóng của VPS để tạo các tư thế có độ chính xác cao. Trong điều kiện thông thường, máy chủ ảo có thể được cung cấp độ chính xác về vị trí khoảng 5 mét và độ chính xác quay là 5 độ. Sử dụng AREarthManager.CheckVpsAvailability() để xác định xem một vị trí cụ thể có phạm vi phủ sóng của VPS hay không.

Bạn cũng có thể sử dụng API không gian địa lý ở những khu vực không có phạm vi phủ sóng của VPS. Trong môi trường ngoài trời có ít hoặc không có vật cản trên đầu, GPS có thể đủ để tạo tư thế với độ chính xác cao.

Các bước tiếp theo