Kiểm tra khả năng sử dụng VPS tại vị trí hiện tại của thiết bị

API không gian địa lý sử dụng kết hợp dữ liệu VPS và GPS để tạo các phép biến đổi không gian địa lý có độ chính xác cao. API này có thể được sử dụng ở bất kỳ nơi nào mà thiết bị có thể xác định vị trí của nó:

  • Ở 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 VPS để tạo các phép biến đổi có độ chính xác cao.
  • Trong môi trường ngoài trời có ít hoặc không có vật cản trên đầu, API Không gian địa lý có thể sử dụng dữ liệu vị trí GPS có sẵn để tạo ra các biến đổi Không gian địa lý với độ chính xác cao.

Bạn có thể xác định khả năng sử dụng máy chủ ảo (VS) tại một vị trí ngang nhất định trước khi phiên thực tế tăng cường bắt đầu và sử dụng mô-đun này để tạo trải nghiệm cụ thể hơn – ví dụ: để trình bày một giao diện "Chuyển sang môi trường thực tế tăng cường" chỉ khi có sẵn dịch vụ ảo VPN.

Bật API ARCore

Ứng dụng của bạn phải bật ARCore API để kiểm tra khả năng sử dụng VPS.

Kiểm tra khả năng sử dụng máy chủ ảo (VS) trong ứng dụng của bạn

Bạn có thể sử dụng API không gian địa lý ở bất kỳ nơi nào mà thiết bị có thể xác định vị trí của thiết bị. Nếu trải nghiệm AR của bạn phụ thuộc vào phạm vi phủ sóng của VPS, bạn có thể sử dụng GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: để lấy GARVPSAvailabilityFuture, một tác vụ không đồng bộ kiểm tra khả năng sử dụng VPS ở một vị trí ngang nhất định. Sau khi có GARVPSAvailabilityFuture, bạn có thể lấy kết quả bằng cách thăm dò ý kiến hoặc thông qua lệnh gọi lại.

Thăm dò kết quả

Sử dụng GARFuture.state để lấy trạng thái của Future. Có 3 trạng thái:

  • GARFutureStatePending: Thao tác chưa hoàn tất nên chưa có kết quả.
  • GARFutureStateCancelled: Thao tác đã bị GARFuture#cancel huỷ. Mọi lệnh gọi lại đã đăng ký sẽ không bao giờ được gọi.
  • GARFutureStateDone: Thao tác đã hoàn tất. Sử dụng GARVPSAvailabilityFuture.result để nhận kết quả.

Bạn có thể tiếp tục kiểm tra GARFuture.state cho đến khi tác vụ hoàn tất.

Lấy kết quả thông qua lệnh gọi lại

Bạn cũng có thể lấy kết quả của Future thông qua lệnh gọi lại. Sử dụng GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: và cung cấp completionHandler. completionHandler này sẽ được gọi trên Luồng chính ngay sau khi Future có trạng thái GARFutureStateDone.

Huỷ Future

Sử dụng GARFuture#cancel để thử huỷ Future. Do tình trạng song song của luồng, có thể yêu cầu huỷ của bạn không thực sự thành công. GARFuture#cancel sẽ trả về YES nếu lần thử này thành công và nếu không thì trả về NO.

Sử dụng API không gian địa lý mà không cần có phạm vi cung cấp dịch vụ VPS

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