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

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

  • 在 GPS 準確度較低的地區 (例如室內空間和人口稠密的都市環境),API 會透過 VPS 覆蓋範圍產生高精確度姿勢。
  • 在幾乎沒有或完全沒有障礙物的戶外環境中,Geospatial API 或許能使用可用的 GPS 位置資料,以高精確度產生地理空間姿勢。

你可以在 AR 工作階段開始前,在特定水平位置決定 VPS 可用性,並據此打造更具體的體驗,例如顯示「進入 AR」模式按鈕。

啟用 ARCore API

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

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

Geospatial API 可用於裝置能夠判斷其位置的任何位置。如果 AR 體驗以 VPS 涵蓋率為依據,可以使用 AREarthManager.CheckVpsAvailabilityAsync() 取得 VpsAvailabilityPromise,這項非同步工作會檢查特定水平位置的 VPS 可用性。 取得 VpsAvailabilityPromise 後,就可以透過輪詢的方式取得結果。

對結果進行意見調查

使用 VpsAvailabilityPromise.State 取得 InterruptiblePromise 的狀態。狀態共有三種:

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

取消InterruptiblePromise

使用 VpsAvailabilityPromise.Cancel() 可嘗試取消 InterruptiblePromise。基於執行緒平行處理的關係,取消嘗試可能並未成功。

在沒有 VPS 涵蓋範圍的情況下使用 Geospatial API

Geospatial API 也可用於沒有 VPS 涵蓋範圍的區域中。在幾乎沒有或完全沒有障礙物的戶外環境中,GPS 可能足以產生高精確度的姿勢。

後續步驟