您可以使用 Snapshot API 取得使用者目前環境的相關資訊。透過 Snapshot API,你可以使用各種情境信號:
- 偵測到的使用者活動,例如步行或開車。
- 你註冊的附近信標。
- 耳機狀態:已接上電源。
- 位置,包括緯度和經度。
系統會快取這些值,以便快速傳回。如果沒有任何資料,系統會執行感應和推論作業,以便傳回最新的狀態值。Awareness API 會傳回含有公用 API 的結構定義現有資料類型。
每個內容信號都有對應的 Snapshot API 方法。舉例來說,如要取得目前偵測到的活動,您可以呼叫 getDetectedActivity()
,使用 SuccessListener
取得 DetectedActivityResponse
,然後呼叫 getActivityRecognitionResult()
來傳回 ActivityRecognitionResult
,以便取得實際的要求資料。
以下範例說明如何取得最新的偵測到活動:
Awareness.getSnapshotClient(this).getDetectedActivity()
.addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
@Override
public void onSuccess(DetectedActivityResponse dar) {
ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
}
})
如要進一步瞭解如何利用要求資料,請參閱取得快照資料。