透過 Ongoing Activity API 以全新方式與 Wear OS 使用者互動

1. 簡介

a3457956a1735674.gif

觀看上方的動畫 (「持續性活動」示範影片)。注意:動畫 GIF 只能播放一次。如果您錯過動畫,請重新載入頁面。

錶面上會顯示動畫圖示 (代表計時器),如果使用者輕觸該圖示,支援計時器的應用程式就會啟動。

持續進行的活動是 Wear OS 的新功能,可讓 Wear OS 使用者介面中的其他介面顯示持續通知,提升使用者對於長時間執行活動的參與程度。

持續通知通常用於表示「通知」含有使用者積極參與 (例如播放音樂) 的背景工作,這類背景工作也有可能是以某種方式處於待處理的狀態,因此佔用了裝置 (例如檔案下載、同步處理作業或有效的網路連線)。

舉例來說,Wear OS 使用者可能會使用計時器應用程式來為活動計時,然後離開該應用程式以開始執行其他工作 (查看天氣、開始運動等)。

當使用者離開計時器應用程式時,應用程式通常會轉換成與某些背景工作 (服務、鬧鐘管理員等) 相關的持續通知,讓使用者掌握計時器上的剩餘時間。

使用者可以查看「通知」以取得最新資訊,也可以與「通知」互動。

不過,如果使用者要檢視「通知」,必須查看錶面下方的通知匣,並且找到適當的「通知」,因此操作方式不如其他介面方便。

應用程式可透過 Ongoing Activity API,在 Wear OS 全新方便的介面上顯示資訊,讓使用者保持參與。

在「計時器」應用程式的案例中,資訊能以可輕觸的圖示顯示在使用者的錶面上 (螢幕截圖底部的活動指標):

b65ade9bf43c526e.png

「計時器」應用程式也會顯示在全域應用程式啟動器的「近期」部分,其中會列出所有「持續進行的活動」:

1bc84dd2bd2d2b5d.png

全域啟動器

最棒的是,您只需要加入大約 10 行程式碼即可!

學習目標

  • 建立及自訂持續進行的活動
  • 持續進行的活動連結至持續通知
  • 在裝置/模擬器上測試持續進行的活動
  • 將互動新增至持續性活動 (輕觸)

建構目標

您需要擴充現有的「步行追蹤應用程式」,其中包含自訂的「持續進行的活動」,這會將有效步行的「步行點數」顯示在主要錶面上,以及應用程式啟動器的「近期」部分。

必要條件

2. 開始設定

在這個步驟中,您會設定環境並下載範例專案。

軟硬體需求

  • Android Studio
  • Wear OS 模擬器 (API 級別 >= 30)
  • 「持續進行的活動」僅適用於 API 級別 30 以上的版本
  • 第一次使用模擬器嗎?這裡有設定方式的說明。

下載程式碼

如果您已安裝 Git,只要執行下列指令即可複製這個存放區的程式碼。如要檢查 Git 是否已安裝完成,請在終端機或指令列中輸入 git --version,並確認該指令可正確執行。

git clone https://github.com/android/codelab-ongoing-activity.git
cd ongoing-activity

如果您沒有 Git,可以點選下方按鈕,下載這個程式碼研究室的所有程式碼:

您可以隨時變更工具列的執行設定,以便在 Android Studio 中執行任一模組。

b059413b0cf9113a.png

在 Android Studio 中開啟專案

  1. 在「Welcome to Android Studio」視窗中,選取「Open」
  2. 選取資料夾 [Download Location]
  3. Android Studio 匯入專案後,請測試是否能在 Wear OS 模擬器或實體裝置上執行 startfinished 模組。
  4. start 模組應如以下螢幕截圖所示。您會在該處執行所有工作。

a40cc0c7e7e28bcf.png

開始步行運動,試試看這個應用程式。您應該會每隔 3 秒左右就會獲得點數。(這款應用程式使用模擬資料,因此您不需要實際走動)。

請嘗試將應用程式滑出。如果在錶面下方前往瀏覽匣,應該就能找到「持續通知」,以持續追蹤您的步行點數。

輕觸之後,看起來會像這樣: