Meilleures pratiques relatives aux activités des utilisateurs

Les activités utilisateur aident les utilisateurs à reprendre les tâches qu’ils ont démarrées dans votre application. Suivez ces instructions pour créer des activités utiles, claires et bien structurées.

Recommandations générales

Créer des activités pour des tâches significatives

Créez des activités pour les tâches auxquelles l’utilisateur souhaite revenir ultérieurement. Les candidats parfaits sont :

  • Documents : un document, une feuille de calcul ou un fichier spécifique que l’utilisateur modifie.
  • Projets : un espace de travail de projet, une conception ou une base de code.
  • Média : chanson, vidéo ou podcast que l’utilisateur jouait.
  • Progression du jeu : session de jeu, niveau ou point de contrôle.

Ne créez pas d’activités pour des actions triviales telles que l’affichage des paramètres, le défilement d’une liste ou la navigation entre les pages.

Utiliser le texte d’affichage descriptif

  • Défini DisplayText sur un nom concis et reconnaissable (par exemple, « Rapport trimestriel » ou « Chapitre 5 : Le parcours »).
  • Définissez Description pour indiquer le contexte ou la progression (par exemple, « Modification de la section 3 — Analyse des revenus »).
  • Évitez le texte générique tel que « Sans titre » ou « Travail sur quelque chose ».

Mettre à jour les activités à mesure que l’utilisateur progresse

Appelez SaveAsync() régulièrement pour mettre à jour la description avec la position actuelle de l’utilisateur :

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

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

Modèles d’activité par type d’application

Applications basées sur des documents

  • Utilisez le chemin d’accès au fichier de document ou l’identificateur unique comme ID d’activité.
  • Définissez cette option ActivationUri pour ouvrir le document spécifique.
  • Mettez à jour Description avec la section actuelle ou modifiez l’emplacement.

Jeux

  • Utilisez l’emplacement d’enregistrement ou l’identificateur de session comme ID d’activité.
  • Définissez DisplayText sur le nom du niveau ou de la mission en cours.
  • Incluez la progression dans la description (par exemple, « Niveau 12 — 85% terminé »).

Applications multimédias

  • Utilisez l’identificateur d’élément multimédia comme ID d’activité.
  • Définissez DisplayText sur le nom de la piste ou de l’épisode.
  • Incluez la position de lecture dans la description (par exemple, « 34:15 / 1:02:00 »).

Applications métier

  • Utilisez l’identificateur d’objet métier (numéro de commande, ID client, numéro de cas) comme ID d’activité.
  • Défini DisplayText sur le nom ou le numéro de l’objet.
  • Mettez à jour fréquemment à mesure que l’utilisateur progresse dans un flux de travail.

Instructions visuelles enrichies

Lors de la définition des détails visuels de l’activité :

  • Gardez DisplayText court : une ligne qui identifie la tâche.
  • Utiliser Description pour une seule ligne de contexte ou de progression, et non pour un paragraphe.
  • Définissez une Attribution icône afin que l’activité soit reconnaissable dans l’historique des activités.
  • Définissez toujours DisplayText, même si vous définissez également d’autres propriétés visuelles, afin que l’activité dispose d’une solution de secours lisible.
UserActivity activity = new UserActivity("quarterly-report");

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

Note

Les versions antérieures de ces directives recommandaient de joindre une carte adaptative complète (AdaptiveCardBuilder, dans l’espace de noms Windows.UI.Shell) comme élément visuel de l’activité. Cette API faisait partie de Windows Chronologie, qui Microsoft mise hors service. N’utilisez AdaptiveCardBuilder pas dans le nouveau code : utilisez plutôt les VisualElements propriétés indiquées ci-dessus.

Consignes concernant l’URI d’activation

  • Utilisez un schéma de protocole personnalisé inscrit dans votre application (par exemple, myapp://).
  • Incluez suffisamment d’informations dans l’URI pour accéder directement à la tâche.
  • Conservez les URI stables : n’incluez pas de jetons spécifiques à la session qui expirent.

Exemple :

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

Gestion des sessions

  • Créez un UserActivitySession lorsque l’utilisateur commence à travailler sur une tâche.
  • Supprimez la session lorsque l’utilisateur bascule vers une autre tâche.
  • Conservez une seule session active à la fois par canal d’activité.

Contenu connexe

  • Last updated on