使用者活動幫助使用者恢復在應用程式中開始的任務。 遵循這些指引,創造有用、清晰且結構良好的活動。
一般指導方針
為有意義的任務創造活動
為使用者日後想回頭處理的任務建立活動。 好的候選者包括:
- 文件 — 使用者正在編輯的特定文件、試算表或檔案。
- 專案 — 專案工作空間、設計或程式碼庫。
- 媒體 — 使用者正在播放的歌曲、影片或 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。 - 當使用者切換到其他任務時,請捨棄該工作階段。
- 每個活動頻道一次只維持一個活躍會話。