使用者活動最佳實務

使用者活動幫助使用者恢復在應用程式中開始的任務。 遵循這些指引,創造有用、清晰且結構良好的活動。

一般指導方針

為有意義的任務創造活動

為使用者日後想回頭處理的任務建立活動。 好的候選者包括:

  • 文件 — 使用者正在編輯的特定文件、試算表或檔案。
  • 專案 — 專案工作空間、設計或程式碼庫。
  • 媒體 — 使用者正在播放的歌曲、影片或 Podcast。
  • 遊戲進度 — 遊戲場次、關卡或檢查點。

不要為瑣碎的操作建立活動,例如查看設定、瀏覽清單或在頁面間移動。

使用描述性顯示文字

  • 並以簡潔且易於辨識的名稱命名 DisplayText (例如「季報」或「第五章:旅程」)。
  • 設定 Description 為顯示上下文或進度(例如:「編輯第 3 節 — 收入分析」)。
  • 避免使用像「無題」或「正在做某件事」這類通用文字。

隨著使用者進度更新活動

請定期呼叫 SaveAsync(),以使用者目前的位置更新描述:

UserActivity activity = new UserActivity("quarterly-report");
int currentPage = 3;
int totalPages = 10;

activity.VisualElements.Description = $"Page {currentPage} of {totalPages}";
await activity.SaveAsync();

依應用程式類型的活動模式

文件式應用程式

  • 使用文件檔案路徑或唯一識別碼作為活動 ID。
  • 設定 ActivationUri 為開啟特定文件。
  • 請使用目前章節或編輯位置更新 Description。

遊戲

  • 使用存檔槽或會話識別碼作為活動 ID。
  • 設定 DisplayText 為當前關卡或任務名稱。
  • 在描述中包含進度(例如「Level 12 — 85% 完成」)。

媒體應用程式

  • 使用媒體項目識別碼作為活動 ID。
  • 設定 DisplayText 為該曲目或集數名稱。
  • 在描述中包含播放位置(例如「34:15 / 1:02:00」)。

企業業務應用程式

  • 使用業務物件識別碼(訂單號碼、客戶 ID、案件編號)作為活動 ID。
  • 設定 DisplayText 為物件名稱或編號。
  • 隨著使用者工作流程的進展,請定期更新。

豐富的視覺指引

設定活動的視覺細節時:

  • 保持 DisplayText 簡短——一行明確指出任務。
  • 用 Description 來說明一行背景或進度,而不是整段。
  • 設定一個 Attribution 圖示,讓活動在活動歷史中能辨識。
  • 即使你也設定其他視覺屬性,也一定要設定 DisplayText,這樣活動才有可讀的備援。
UserActivity activity = new UserActivity("quarterly-report");

activity.VisualElements.DisplayText = "Quarterly Report"; // Fallback
activity.VisualElements.Description = "Page 3 of 10";

Note

較早版本的指引建議將完整的 Adaptive Card(AdaptiveCardBuilder,位於 Windows.UI.Shell 命名空間中)附加為活動的視覺呈現。 該 API 是 Windows Timeline 的一部分,但 Microsoft 已將其退休。 不要在新程式碼中使用 AdaptiveCardBuilder ——改用 VisualElements 上述的屬性。

啟用 URI 準則

  • 使用註冊在你的應用程式上的自訂協定方案(例如, myapp://。
  • 在 URI 中包含足夠的資訊,以便直接導航到任務。
  • 保持 URI 穩定 — 不要包含會話專用且會過期的代幣。

範例:

myapp://document/quarterly-report-2026?page=12

會話管理

  • 當使用者開始著手某項任務時,建立一個 UserActivitySession 。
  • 當使用者切換到其他任務時,請捨棄該工作階段。
  • 每個活動頻道一次只維持一個活躍會話。