Osvědčené postupy pro aktivity uživatelů

Aktivity uživatelů pomáhají uživatelům pokračovat v úlohách, které spustili ve vaší aplikaci. Při vytváření užitečných, jasných a dobře strukturovaných aktivit postupujte podle těchto pokynů.

Obecné pokyny

Vytváření aktivit pro smysluplné úkoly

Vytvořte aktivity pro úkoly, ke kterým by se uživatel chtěl později vrátit. Mezi vhodné kandidáty patří:

  • Dokumenty – určitý dokument, tabulka nebo soubor, který uživatel upravuje.
  • Projekty – pracovní prostor projektu, návrh nebo základ kódu.
  • Média – skladba, video nebo podcast, který uživatel přehrával.
  • Postup ve hře — herní relace, úroveň nebo kontrolní bod.

Nevytvávejte aktivity pro triviální akce, jako je zobrazení nastavení, procházení seznamu nebo navigace mezi stránkami.

Použití popisného zobrazovaného textu

  • Nastavte DisplayText na stručný, rozpoznatelný název (například "Čtvrtletní zpráva" nebo "Kapitola 5: Cesta").
  • Nastavte Description na označení kontextu nebo průběhu (například "Úprava oddílu 3 – Analýza výnosů").
  • Vyhněte se obecnému textu, jako je "Bez názvu" nebo "Práce na něčem".

Aktualizujte aktivity podle toho, jak uživatel postupuje

Pravidelně volejte SaveAsync(), aby se popis aktualizoval o aktuální polohu uživatele:

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

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

Vzory aktivit podle typu aplikace

Aplikace založené na dokumentech

  • Jako ID aktivity použijte cestu k souboru dokumentu nebo jedinečný identifikátor.
  • Nastavte ActivationUri tak, aby se otevřel konkrétní dokument.
  • Aktualizujte Description o aktuální oddíl nebo upravte umístění.

hry

  • Jako ID aktivity použijte identifikátor slotu pro ukládání nebo relace.
  • Nastavte DisplayText na aktuální úroveň nebo název mise.
  • Uveďte průběh v popisu (například úroveň 12 – 85% dokončení).

Aplikace médií

  • Jako ID aktivity použijte identifikátor položky média.
  • Nastavte DisplayText název skladby nebo epizody.
  • Do popisu uveďte pozici přehrávání (například "34:15 / 1:02:00").

Aplikace pro specifické obchodní činnosti

  • Jako ID aktivity použijte identifikátor obchodního objektu (číslo objednávky, ID zákazníka, číslo případu).
  • Nastavte DisplayText název objektu nebo číslo.
  • Často se aktualizuje, když uživatel prochází pracovním postupem.

Bohaté vizuální pokyny

Při nastavování podrobností vizuálu aktivity:

  • Ponechte DisplayText krátký – jeden řádek, který identifikuje úkol.
  • Slouží Description pro jeden řádek kontextu nebo průběhu, ne pro odstavec.
  • Attribution Nastavte ikonu tak, aby byla aktivita rozpoznatelná v historii aktivit.
  • Vždy nastavte DisplayText, i když nastavíte i další vizuální vlastnosti, aby aktivita měla čitelnou náhradní možnost.
UserActivity activity = new UserActivity("quarterly-report");

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

Note

Starší verze těchto pokynů doporučovaly připojit úplnou adaptivní kartu (AdaptiveCardBuilder, v oboru názvů Windows.UI.Shell) jako vizuální prvek aktivity. Toto rozhraní API bylo součástí Časové osy Windows, kterou Microsoft ukončil. Nepoužívejte AdaptiveCardBuilder v novém kódu – místo toho použijte VisualElements vlastnosti uvedené výše.

Pokyny pro aktivační identifikátor URI

  • Použijte vlastní schéma protokolu zaregistrované ve vaší aplikaci (například myapp://).
  • Do identifikátoru URI zahrňte dostatek informací, abyste mohli přejít přímo k úkolu.
  • Udržujte identifikátory URI stabilní – nezahrnujte tokeny specifické pro relaci, jejichž platnost vyprší.

Příklad:

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

Správa relací

  • Vytvořte UserActivitySession , když uživatel začne pracovat na úkolu.
  • Odstraňte relaci, když uživatel přepne na jiný úkol.
  • Udržujte vždy jen jednu aktivní relaci pro každý kanál aktivit.

Související obsah

  • Last updated on