Hướng dẫn cho nhà phát triển Cloud Anchors về tính năng nhắm mục tiêu Unity

Tìm hiểu cách sử dụng Cloud Anchors trong các ứng dụng của riêng bạn.

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

Đảm bảo bạn nắm được các khái niệm cơ bản về thực tế tăng cường và cách định cấu hình phiên ARCore trước khi tiếp tục.

Nếu mới sử dụng Cloud Anchors, hãy đảm bảo bạn hiểu rõ cách hoạt động của neo và neo đám mây.

Bật Neo neo trong ứng dụng của bạn

Theo mặc định, Cloud Anchors bị tắt trong ARCore. Ứng dụng mẫu sẽ được bật với Cloud Anchors chỉ được bật cho mục đích minh hoạ. Trước khi sử dụng Neo neo trên ứng dụng, trước tiên bạn phải bật API ARCore trong một dự án Google Cloud Platform mới hoặc hiện có. Dịch vụ này chịu trách nhiệm lưu trữ, lưu trữ và giải quyết Cloud Anchors.

Bạn cũng sẽ cần phải bật tính năng Cloud Anchor trong cấu hình phiên AR của ứng dụng để có thể giao tiếp với API ARCore:

  1. Bật các chức năng Cloud Anchor trong cấu hình phiên AR của bạn.
  2. Tiếp tục phiên AR.

Xác thực ứng dụng bằng API ARCore

Bạn phải xác thực API ARCore trong ứng dụng của mình để lưu trữ và phân giải Cloud Anchors. Khi nhắm mục tiêu Android, Unity cung cấp các tuỳ chọn Keyless (Khoá) và API Key (Khoá API) để xác thực. Ứng dụng lưu trữ và phân giải Cloud Anchors có TTL hơn 1 ngày phải sử dụng phương thức xác thực không cần chìa khoá.

Chiến lược xác thực mặc định cho các dự án Unity mới được tạo bằng ARCore v1.24 trở lên là DoNotUse. Điều này nhằm ngăn việc xây dựng ứng dụng bằng các thư viện không cần thiết. Nếu ứng dụng của bạn sử dụng Cloud Anchors và được xây dựng bằng ARCore phiên bản 1.24 trở lên, thì bạn phải bật tính năng xác thực theo cách thủ công trong phần cài đặt dự án Unity.

Xác thực không cần chìa khoá

Sử dụng phương thức xác thực bằng khoá để lưu trữ và phân giải các Cloud Anchors có các TTL trong khoảng từ 1 đến 365 ngày.

  1. Chọn Keyless (Khoá) để xoá mọi khoá API được lưu trữ khỏi chế độ cài đặt Cloud Anchors trước đó và thêm các phần phụ thuộc cần thiết cũng như các ngoại lệ của Proguard. Nếu trước đây bạn đã sử dụng khoá API và không còn cần đến nữa, thì bạn nên xoá khoá đó trong Google Cloud Platform Console và xoá khoá đó khỏi ứng dụng sau khi chuyển người dùng sang phiên bản mới nhất.
  2. Tạo ứng dụng OAuth cho ứng dụng Android trong Google Developers Console, dùng mã nhận dạng ứng dụng và vân tay số của chứng chỉ ký. Mã này liên kết mã ứng dụng Android với dự án Google Cloud Platform của bạn.

Xác thực khoá API

Sử dụng phương thức xác thực khoá API để lưu trữ và phân giải Cloud Anchors bằng TTL lên đến 24 giờ (1 ngày).

  1. Xem Trung tâm trợ giúp của Google Cloud Platform Console để lấy khóa API.
  2. Chuyển đến Chỉnh sửa > Cài đặt dự án > Cài đặt dự án ARCore và thêm khóa API của bạn vào trường Khoá API Cloud Anchor để thêm khoá API mới vào dự án của bạn.

Kiểm tra chất lượng ánh xạ của các điểm nổi bật

FeatureMapQuality cho biết chất lượng của các điểm tính năng mà ARCore nhìn thấy trong vài giây trước đó từ một tư thế máy ảnh cụ thể. Thông thường, Cloud Anchors được lưu trữ bằng các tính năng có chất lượng cao hơn sẽ được giải quyết chính xác hơn.

Giá trị Mô tả
Insufficient Chất lượng của các điểm đặc trưng được xác định từ tư thế trong vài giây trước đó thấp. Trạng thái này cho biết ARCore có thể sẽ gặp khó khăn hơn khi phân giải Cloud Anchor. Khuyến khích người dùng di chuyển thiết bị để xem vị trí mong muốn của Cloud Anchor mà họ muốn lưu trữ có thể xem được từ nhiều góc.
Sufficient Chất lượng của các điểm tính năng được xác định từ tư thế trong vài giây trước đó có thể đủ để ARCore giải quyết thành công một Cloud Anchor, mặc dù độ chính xác của tư thế đã phân giải có thể sẽ bị giảm. Khuyến khích người dùng di chuyển thiết bị để xem vị trí mong muốn của Cloud Anchor mà họ muốn lưu trữ có thể xem được từ nhiều góc.
Good Chất lượng các điểm tính năng được xác định từ tư thế trong vài giây trước đó có thể đủ để ARCore giải quyết thành công một Cloud Anchor với độ chính xác cao.

Hạn mức API cho máy chủ và giải quyết các yêu cầu

API ARCore có các hạn mức sau đây cho băng thông của yêu cầu:

Loại hạn mức Tối đa Thời lượng Áp dụng cho
Số neo không giới hạn Không áp dụng dự án
Yêu cầu liên kết máy chủ 30 phút Địa chỉ IP và dự án
Yêu cầu giải quyết neo 300 phút Địa chỉ IP và dự án

Các phương pháp hay nhất để mang lại trải nghiệm tốt cho người dùng

Hướng dẫn người dùng thực hiện những điều sau để đảm bảo trải nghiệm người dùng tốt trên ứng dụng của bạn:

  • Đợi vài giây sau khi phiên bắt đầu trước khi thử tổ chức một điểm neo. Việc này giúp quá trình theo dõi ổn định.
  • Khi chọn một địa điểm để lưu trữ neo, hãy cố gắng tìm một khu vực có các đặc điểm hình ảnh dễ phân biệt với nhau. Để có kết quả tốt nhất, hãy tránh các bề mặt phản chiếu hoặc các bề mặt không có các đặc điểm hình ảnh, chẳng hạn như tường trắng trống.

  • Giữ máy ảnh ở vị trí trung tâm theo sở thích và di chuyển thiết bị xung quanh để ánh xạ môi trường từ nhiều góc độ khác nhau, duy trì khoảng cách vật lý gần như nhau trong suốt. Thực hiện việc này trong tối đa 30 giây. Điều này sẽ giúp thu thập dữ liệu trực quan hơn và giúp giải quyết vấn đề hiệu quả hơn.

  • Đảm bảo rằng bạn có đủ ánh sáng trong môi trường thực tế trong khi lưu trữ và phân giải Cloud Anchors.

Chính sách về việc ngừng cung cấp

  • Các ứng dụng được xây dựng bằng ARCore SDK 1.12.0 trở lên thuộc phạm vi điều chỉnh của chính sách ngừng sử dụng Cloud Anchor API.
  • Các ứng dụng được xây dựng bằng ARCore SDK 1.11.0 trở xuống không thể lưu trữ hoặc phân giải Cloud Anchors do SDK sử dụng API ARCore cũ không còn được dùng nữa.

Bước tiếp theo