檢查裝置的 VPS 可用性';目前位置

地理空間 API 結合 VPS 和 GPS 資料,產生高精確度的地理空間姿勢。您可在裝置能夠判斷其位置的任何位置使用此 API:

  • 如果是 GPS 精確度偏低的區域 (例如室內空間和人口密集的都市環境),API 就會仰賴 VPS 覆蓋範圍來產生高精確度姿勢。
  • 在幾乎沒有高架障礙的戶外環境中,地理空間 API 或許能夠使用現有的 GPS 位置資料,製作出精準的地理空間姿勢。

你可以在 AR 工作階段開始前以特定水平位置判斷 VPS 適用情形,並使用這項功能打造更精準的體驗,舉例來說,只有在 VPS 可用時才會顯示「進入 AR」按鈕。

啟用 ARCore API

您的應用程式必須啟用 ARCore API,才能檢查 VPS 可用性。

檢查應用程式中的 VPS 可用性

地理空間 API 可用於裝置判斷其位置的任何位置。如果您的 AR 體驗取決於 VPS 涵蓋率,可以使用 AREarthManager.CheckVpsAvailabilityAsync() 取得 VpsAvailabilityPromise,這項非同步工作會在特定水平位置檢查 VPS 可用性。 取得 VpsAvailabilityPromise 後,即可透過輪詢取得結果。

意見調查結果

使用 VpsAvailabilityPromise.State 取得 InterruptiblePromise 的狀態。狀態分為三種:

您可以繼續查看 VpsAvailabilityPromise.State,直到工作完成為止。

取消InterruptiblePromise

使用 VpsAvailabilityPromise.Cancel() 嘗試取消 InterruptiblePromise。由於執行緒平行處理,您的取消嘗試實際上可能不會成功。

使用地理空間 API,且未涵蓋 VPS 涵蓋範圍

地理空間 API 也可用於沒有 VPS 涵蓋範圍的區域。在幾乎沒有俯瞰障礙的戶外環境中,GPS 可能足以產生具有高準確度的姿勢。

後續步驟