Aanbevolen procedures voor gebruikersactiviteiten

Met gebruikersactiviteiten kunnen gebruikers taken hervatten die ze in uw app hebben gestart. Volg deze richtlijnen om activiteiten te maken die nuttig, duidelijk en goed gestructureerd zijn.

Algemene richtlijnen

Activiteiten maken voor zinvolle taken

Maak activiteiten voor taken waarnaar de gebruiker later wilt terugkeren. Goede kandidaten zijn:

  • Documenten : een specifiek document, spreadsheet of bestand dat de gebruiker bewerkt.
  • Projecten : een projectwerkruimte, ontwerp of codebasis.
  • Media : een nummer, video of podcast die de gebruiker speelde.
  • Voortgang van de game: een gamesessie, niveau of controlepunt.

Maak geen activiteiten voor triviale acties, zoals het weergeven van instellingen, het bladeren door een lijst of het navigeren tussen pagina's.

Beschrijvende weergavetekst gebruiken

  • Stel DisplayText deze in op een beknopte, herkenbare naam (bijvoorbeeld 'Kwartaalrapport' of 'Hoofdstuk 5: De reis').
  • Ingesteld Description om context of voortgang aan te geven (bijvoorbeeld 'Sectie 3 bewerken - Omzetanalyse').
  • Vermijd algemene tekst zoals 'Naamloos' of 'Werken aan iets'.

Activiteiten bijwerken terwijl de gebruiker vordert

Roep SaveAsync() regelmatig aan om de beschrijving bij te werken met de huidige positie van de gebruiker:

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

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

Activiteitspatronen per app-type

Op documenten gebaseerde apps

  • Gebruik het pad naar het documentbestand of de unieke id als de activiteits-id.
  • Stel ActivationUri in om het specifieke document te openen.
  • Werk Description bij met de huidige sectie of bewerkingslocatie.

Games

  • Gebruik het opslagslot of de sessie-id als activiteits-id.
  • Stel DisplayText in op het huidige niveau of de missienaam.
  • Neem de voortgang op in de beschrijving (bijvoorbeeld 'Niveau 12 — 85% voltooid').

Media-apps

  • Gebruik de id van het media-item als de activiteits-id.
  • Stel DisplayText in op de naam van de track of aflevering.
  • Neem de afspeelpositie op in de beschrijving (bijvoorbeeld '34:15 / 1:02:00').

Line-Of-Business-apps

  • Gebruik de id van het bedrijfsobject (ordernummer, klant-id, casenummer) als de activiteits-id.
  • Stel DisplayText in op de objectnaam of het nummer.
  • Werk vaak bij terwijl de gebruiker een workflow doorloopt.

Richtlijnen voor uitgebreide visuele elementen

Bij het instellen van de visuele details van de activiteit:

  • Houd DisplayText kort: één regel waarmee de taak wordt geïdentificeerd.
  • Gebruik Description voor één regel context of voortgang, niet voor een alinea.
  • Stel een Attribution pictogram in zodat de activiteit herkenbaar is in de activiteitengeschiedenis.
  • Stel DisplayText altijd in, zelfs als u ook andere visuele eigenschappen instelt, zodat de activiteit een leesbaar alternatief heeft.
UserActivity activity = new UserActivity("quarterly-report");

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

Note

Eerdere versies van deze richtlijnen raden aan een volledige adaptieve kaart (AdaptiveCardBuilderin de Windows.UI.Shell naamruimte) als visual van de activiteit te koppelen. Deze API maakte deel uit van Windows Tijdlijn, die Microsoft buiten gebruik gesteld. Gebruik niet AdaptiveCardBuilder in nieuwe code. Gebruik in plaats daarvan de VisualElements eigenschappen die hierboven worden weergegeven.

Richtlijnen voor activerings-URI

  • Gebruik een aangepast protocolschema dat is geregistreerd bij uw app (bijvoorbeeld myapp://).
  • Neem voldoende informatie op in de URI om rechtstreeks naar de taak te navigeren.
  • Houd URI's stabiel. Neem geen sessiespecifieke tokens op die verlopen.

Voorbeeld:

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

Sessiebeheer

  • Maak een UserActivitySession wanneer de gebruiker aan een taak gaat werken.
  • De sessie verwijderen wanneer de gebruiker overschakelt naar een andere taak.
  • Houd slechts één actieve sessie tegelijk bij per activiteitskanaal.

Verwante onderwerpen

  • Last updated on