Bewährte Methoden für Benutzeraktivitäten

Benutzeraktivitäten helfen Benutzern, Aufgaben fortzusetzen, die sie in Ihrer App gestartet haben. Befolgen Sie diese Richtlinien, um Aktivitäten zu erstellen, die nützlich, klar und gut strukturiert sind.

Allgemeine Richtlinien

Erstellen von Aktivitäten für sinnvolle Aufgaben

Erstellen Sie Aktivitäten für Aufgaben, zu denen der Benutzer später zurückkehren möchte. Folgende Kandidaten sind geeignet:

  • Dokumente – Ein bestimmtes Dokument, eine bestimmte Kalkulationstabelle oder eine Datei, die der Benutzer bearbeitet.
  • Projekte – ein Projektarbeitsbereich, ein Entwurf oder eine Codebasis.
  • Medieninhalt — Ein Song, ein Video oder ein Podcast, den der Benutzer abspielte.
  • Spielfortschritt – Eine Spielsitzung, ein Level oder ein Prüfpunkt.

Erstellen Sie keine Aktivitäten für triviale Aktionen wie das Anzeigen von Einstellungen, das Scrollen durch eine Liste oder das Navigieren zwischen Seiten.

Verwenden von beschreibendem Anzeigetext

  • Legen Sie DisplayText einen präzisen, erkennbaren Namen fest (z. B. "Quartalsbericht" oder "Kapitel 5: Die Reise").
  • Legen Sie diese Einstellung Description fest, um Kontext oder Fortschritt anzugeben (z. B. "Bearbeiten von Abschnitt 3 – Umsatzanalyse").
  • Vermeiden Sie generischen Text wie "Unbenannt" oder "Arbeiten an etwas".

Aktualisieren von Aktivitäten während des Fortschritts des Benutzers

Rufen Sie SaveAsync() regelmäßig auf, um die Beschreibung mit der aktuellen Position des Benutzers zu aktualisieren:

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

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

Aktivitätsmuster nach App-Typ

Dokumentbasierte Apps

  • Verwenden Sie den Dokumentdateipfad oder eindeutigen Bezeichner als Aktivitäts-ID.
  • Legen Sie die Einstellung ActivationUri fest, um das bestimmte Dokument zu öffnen.
  • Aktualisieren Sie Description auf den aktuellen Abschnitt oder bearbeiten Sie den Speicherort.

Spiele

  • Verwenden Sie den Speicherplatz oder den Sitzungsbezeichner als Aktivitäts-ID.
  • Setzen Sie DisplayText auf den aktuellen Level- oder Missionsnamen.
  • Fügen Sie den Fortschritt in die Beschreibung ein (z. B. "Ebene 12 – 85% abgeschlossen").

Medien-Apps

  • Verwenden Sie den Medienelementbezeichner als Aktivitäts-ID.
  • Setzen Sie DisplayText auf den Namen des Tracks oder der Episode.
  • Fügen Sie die Wiedergabeposition in die Beschreibung ein (z. B. "34:15 / 1:02:00").

Branchenspezifische Apps

  • Verwenden Sie die Geschäftsobjekt-ID (Auftragsnummer, Kunden-ID, Fallnummer) als Aktivitäts-ID.
  • Legen Sie für DisplayText den Objektnamen oder die Nummer fest.
  • Aktualisieren Sie häufig, wenn der Benutzer einen Workflow durchschreitet.

Umfassende visuelle Richtlinien

Beim Festlegen der visuellen Details der Aktivität:

  • Halten Sie DisplayText kurz – eine Zeile, die die Aufgabe beschreibt.
  • Verwenden Sie Description für eine einzelne Zeile für Kontext oder Fortschritt, nicht für einen Absatz.
  • Legen Sie ein Attribution Symbol fest, damit die Aktivität im Aktivitätsverlauf erkennbar ist.
  • Legen Sie DisplayText immer fest, auch wenn Sie andere visuelle Eigenschaften festlegen, damit die Aktivität über eine lesbare Ausweichmöglichkeit verfügt.
UserActivity activity = new UserActivity("quarterly-report");

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

Note

In früheren Versionen dieses Leitfadens wurde empfohlen, eine vollständige Adaptive Card (AdaptiveCardBuilder, im Windows.UI.Shell-Namespace) als visuelle Darstellung der Aktivität anzufügen. Diese API war Teil der Windows-Zeitachse, die Microsoft eingestellt hat. Verwenden Sie AdaptiveCardBuilder in neuem Code nicht — verwenden Sie stattdessen die oben gezeigten VisualElements-Eigenschaften.

Richtlinien für Aktivierungs-URI

  • Verwenden Sie ein benutzerdefiniertes Protokollschema, das für Ihre App registriert ist (z. B myapp://. ).
  • Fügen Sie genügend Informationen in den URI ein, um direkt zur Aufgabe zu navigieren.
  • Halten Sie URIs stabil – schließen Sie keine sitzungsspezifischen Token ein, die ablaufen.

Beispiel:

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

Sitzungsverwaltung

  • Erstellen Sie ein UserActivitySession, sobald der Benutzer mit der Bearbeitung einer Aufgabe beginnt.
  • Verwerfen Sie die Sitzung, wenn der Benutzer zu einer anderen Aufgabe wechselt.
  • Verwalten Sie jeweils nur eine aktive Sitzung pro Aktivitätskanal.

Verwandte Inhalte

  • Last updated on