Najlepsze rozwiązania dotyczące działań użytkowników

W tym przewodniku opisano zalecane rozwiązania dotyczące tworzenia i aktualizowania działań użytkownika. Aby zapoznać się z omówieniem funkcji Działania użytkownika w systemie Windows, zobacz Kontynuuj aktywność użytkownika, nawet na urządzeniach. Możesz też zapoznać się z sekcją Działania użytkowników programu Project Rome, aby zapoznać się z implementacjami działań na innych platformach deweloperskich.

Kiedy utworzyć lub zaktualizować działania użytkownika

Ponieważ każda aplikacja jest inna, zależy od każdego dewelopera, aby określić najlepszy sposób mapowania akcji w aplikacji na działania użytkownika. Działania użytkowników zostaną zaprezentowane w Cortanie i osi czasu, które koncentrują się na zwiększeniu produktywności i wydajności użytkowników, pomagając im wrócić do zawartości, którą odwiedzili w przeszłości.

Ogólne wytyczne

• Rejestrowanie pojedynczego działania dla grupy powiązanych akcji użytkownika. Jest to szczególnie istotne w przypadku list odtwarzania muzyki lub programów TELEWIZYJNYch: pojedyncze działanie można aktualizować w regularnych odstępach czasu w celu odzwierciedlenia postępu użytkownika. W takim przypadku będziesz mieć jedną aktywność użytkownika z wieloma elementami historii reprezentującymi okresy zaangażowania w ciągu wielu dni lub tygodni. To samo dotyczy działań opartych na dokumentach, na których użytkownik stopniowo postępuje w aplikacji.
• Przechowywanie danych użytkownika w chmurze. Jeśli chcesz obsługiwać działania obejmujące wiele urządzeń, musisz upewnić się, że zawartość wymagana do ponownego zaangażowania tego działania jest przechowywana w lokalizacji w chmurze. Działania specyficzne dla urządzenia będą wyświetlane na osi czasu na urządzeniu, na którym zostało utworzone działanie, ale może nie być wyświetlane na innych urządzeniach.
• Nie twórz Aktywności dla działań, których użytkownicy nie będą musieli wznawiać. Jeśli aplikacja jest używana do wykonywania prostych jednorazowych operacji, które nie utrzymują stanu, prawdopodobnie nie trzeba tworzyć działania użytkownika.
• Nie twórz działań dla akcji wykonanych przez innych użytkowników. Jeśli konto zewnętrzne wysyła użytkownikowi wiadomość lub wzmiankuje go w aplikacji, nie należy tworzyć aktywności dla tego. Ten typ akcji jest lepiej obsługiwany przez powiadomienia Centrum akcji.
  • Scenariusze współpracy stanowią wyjątek: jeśli wielu użytkowników pracuje razem nad tym samym zadaniem (takim jak dokument programu Word), mogą wystąpić przypadki, w których inny użytkownik wprowadził zmiany po Twoim użytkowaniu. W takim przypadku możesz zaktualizować istniejące działanie w celu odzwierciedlenia zmian wprowadzonych w dokumencie. Wymaga to zaktualizowania istniejących danych zawartości aktywności użytkownika bez tworzenia nowego elementu historii.

wskazówki dotyczące dotyczące określonych typów aplikacji

Chociaż każda aplikacja jest inna, większość aplikacji będzie należeć do jednego z następujących wzorców interakcji.

• aplikacje oparte na dokumentach — utwórz jedno działanie na dokument z co najmniej jednym elementem historii odzwierciedlającym okresy użycia. Ważne jest zaktualizowanie swojej Aktywności w miarę wprowadzania zmian w dokumencie.
• Gry — Utwórz jedną Aktywność dla każdego zapisu lub świata. Jeśli Twoja gra obsługuje tylko jedną sekwencję poziomów, możesz w przyszłości ponownie publikować tę samą interakcję, aktualizując dane dotyczące zawartości, aby pokazać najnowsze postępy lub osiągnięcia.
• Aplikacje narzędziowe — jeśli w aplikacji nie ma nic, co użytkownicy będą musieli opuścić i wznowić, nie musisz używać działań użytkownika. Dobrym przykładem jest prosta aplikacja, na przykład Kalkulator.
• aplikacje branżowe — istnieje wiele aplikacji do zarządzania prostymi zadaniami lub procesami biznesowymi. Utwórz jedno działanie dla każdego oddzielnego przepływu pracy dostępnego za pośrednictwem aplikacji (na przykład raporty wydatków będą oddzielnym działaniem, aby użytkownik mógł kliknąć działanie, aby sprawdzić, czy określony raport został zatwierdzony).
• aplikacje odtwarzania multimediów — utwórz jedno działanie na logiczne grupowanie zawartości (takie jak lista odtwarzania, program lub zawartość autonomiczna). Podstawowym pytaniem dla deweloperów aplikacji jest to, czy każda część zawartości (odcinek telewizyjny, piosenka) liczy się jako autonomiczna zawartość lub część kolekcji. Ogólnie rzecz biorąc, jeśli użytkownik zdecyduje się na odtwarzanie kolekcji lub zawartości sekwencyjnej, kolekcja jako całość jest działaniem. Jeśli zdecydują się na odtworzenie jednego fragmentu zawartości, to ten fragment staje się aktywnością. Zobacz bardziej szczegółowe wskazówki poniżej.
  • Muzyka: Album/Artysta/Gatunek — jeśli użytkownik wybierze album, artystę lub gatunek i naciśnie odtwórz, ta kolekcja jest czynnością; nie zapisuj oddzielnej czynności dla każdej piosenki. W przypadku krótkich kolekcji, takich jak pojedynczy album lub kolekcje odtwarzane w losowej kolejności, może nie być konieczne zaktualizowanie działania w celu odzwierciedlenia bieżącej pozycji użytkownika. W przypadku długiego odtwarzania sekwencyjnego, takiego jak album lub lista odtwarzania, nagrywanie pozycji w albumie może mieć sens.
  • Music: inteligentne listy odtwarzania — aplikacje, które odtwarzają muzykę w losowej kolejności, powinny nagrywać pojedynczą aktywność dla tej listy odtwarzania. Jeśli użytkownik odtwarza listę odtwarzania po raz drugi, należy utworzyć dodatkowe rekordy historii dla tego samego działania. Rejestrowanie bieżącej pozycji użytkownika na liście odtwarzania nie jest konieczne, ponieważ kolejność jest losowa.
  • serialu telewizyjnego — jeśli aplikacja jest skonfigurowana do odtwarzania następnego odcinka po zakończeniu bieżącego, należy napisać pojedynczą aktywność dla serialu telewizyjnego. Podczas oglądania różnych odcinków w różnych sesjach, zaktualizujesz swoją Aktywność, aby odzwierciedlić aktualną pozycję w serii, a tym samym zostanie utworzonych wiele wpisów w historii.
  • Movie — film jest samodzielnym utworem i powinien mieć własną historię. Jeśli użytkownik przerwie oglądanie filmu w trakcie, dobrze jest zapisać ich pozycję. Gdy zechcą wznowić odtwarzanie w przyszłości, aplikacja może wznowić film w miejscu, w którym została przerwana, lub nawet zapytać użytkownika, czy chce wznowić, czy rozpocząć od początku.

Projekt działania użytkownika

Działania użytkownika składają się z trzech składników: identyfikatora URI aktywacji, danych wizualnych i metadanych zawartości.

• Identyfikator URI aktywacji to identyfikator URI, który można przekazać do aplikacji lub interfejsu użytkownika w celu wznowienia działania aplikacji z określonym kontekstem. Zazwyczaj te linki przybierają formę obsługi protokołu w schemacie (na przykład "my-app://page2?action=edit"). Deweloper decyduje o sposobie obsługi parametrów identyfikatora URI przez aplikację. Aby uzyskać więcej informacji, zobacz Obsługa aktywacji identyfikatora URI.
• Dane wizualne składające się z zestawu wymaganych i opcjonalnych właściwości (na przykład tytuł, opis lub elementy karty adaptacyjnej) umożliwiają użytkownikom wizualne identyfikowanie działania. Zapoznaj się z poniższymi wskazówkami dotyczącymi tworzenia wizualizacji kart adaptatywnych dla twojej aktywności.
• Metadane zawartości to dane JSON, których można użyć do grupowania i pobierania działań w określonym kontekście. Zazwyczaj przyjmuje to formę danych http://schema.org. Zapoznaj się z poniższymi wskazówkami dotyczącymi wypełniania tych danych.

Wskazówki dotyczące projektowania kart adaptacyjnych

Gdy działania pojawiają się na osi czasu, są one wyświetlane za pomocą struktury Adaptive Card . Jeśli deweloper nie udostępnia karty adaptacyjnej dla każdego działania, oś czasu automatycznie utworzy prostą kartę na podstawie nazwy/ikony aplikacji, wymaganego pola Tytuł i opcjonalnego pola Opis.

Deweloperzy aplikacji są zachęcani do udostępniania kart niestandardowych przy użyciu prostego schematu JSON karty adaptacyjnej. Zapoznaj się z dokumentacją kart adaptacyjnych , aby uzyskać instrukcje techniczne dotyczące tworzenia obiektów kart adaptacyjnych. Zapoznaj się z poniższymi wytycznymi dotyczącymi projektowania kart adaptacyjnych w działaniach użytkownika.

• Korzystanie z obrazów
  • Jeśli to możliwe, użyj unikatowego obrazu dla każdego działania. Nazwa i ikona aplikacji będą automatycznie wyświetlane obok karty Działanie; dodatkowe obrazy ułatwią użytkownikom znalezienie szukanych działań.
  • Obrazy nie powinny zawierać tekstu, który ma zostać odczytany przez użytkownika. Ten tekst nie będzie dostępny dla użytkowników z potrzebami ułatwień dostępu i nie można go przeszukiwać.
  • Jeśli obraz nie zawiera tekstu i może zostać przycięty do około proporcji 2:1, należy użyć go jako obrazu tła. Spowoduje to, że odważna karta aktywności, która wyróżni się na Osi Czasu. Obraz zostanie nieco zaciemniony, aby upewnić się, że tekst pozostanie widoczny na karcie i zachęcamy do używania tylko nazwy działania w tym przypadku, ponieważ mniejszy tekst może stać się trudny do odczytania.
  • Jeśli nie można przyciąć obrazu do wartości 2:1, należy umieścić go na karcie działania.
    • Jeśli współczynnik proporcji to kwadrat lub pionowy, zakotwicz obraz po prawej stronie karty bez marginesów.
    • Jeśli współczynnik proporcji to Poziomo, przymocować obrazek do górnego prawego rogu karty.
• Każde działanie musi mieć podaną nazwę, która powinna być zawsze wyświetlana.
  • Ta nazwa powinna być wyświetlana w lewym górnym rogu karty przy użyciu opcji pogrubionego tekstu. Ważne jest, aby nazwa była łatwo rozpoznawalna, ponieważ jest to jedyna część, którą użytkownicy zobaczą, gdy działanie jest wyświetlane w scenariuszach Cortany. Wyświetlanie tej samej nazwy na osi czasu ułatwia użytkownikom przeglądanie dużej liczby działań.
• Użyj tego samego stylu wizualnego dla wszystkich działań z aplikacji, aby użytkownicy mogli łatwo zlokalizować działania aplikacji na osi czasu.
  • Na przykład wszystkie działania powinny używać tego samego koloru tła.
• Używaj dodatkowych informacji tekstowych oszczędnie.
  • Unikaj wypełniania karty tekstem i używaj tylko dodatkowych informacji, które ułatwiają użytkownikom znalezienie właściwej aktywności lub odzwierciedla informacje o stanie (takie jak bieżący postęp w konkretnym zadaniu).

Wytyczne dotyczące metadanych zawartości

Działania użytkownika mogą również zawierać metadane zawartości, których system Windows i Cortana używają do kategoryzowania działań i generowania wnioskowań. Działania można następnie zgrupować wokół określonego tematu, na przykład lokalizacji (jeśli użytkownik bada urlopy), obiektu (jeśli użytkownik bada coś) lub akcji (jeśli użytkownik robi zakupy dla określonego produktu w różnych aplikacjach i witrynach internetowych). Dobrym pomysłem jest reprezentowanie zarówno rzeczowników, jak i czasowników zaangażowanych w działanie.

W poniższym przykładzie kod JSON metadanych zawartości, zgodnie ze standardami Schema.org, reprezentuje scenariusz: "John grał Angry Birds ze Steve'em".

// John played angry birds with Steve.
{
  "@context": "http://schema.org",
  "@type": "PlayAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "MobileApplication",
    "name": "Angry Birds."
  },
  "participant": {
    "@type": "Person",
    "name": "Steve"
  }
}

Kluczowe interfejsy API

• przestrzeń nazw UserActivities

Tematy pokrewne

• Działania użytkowników (Dokumentacja projektu Rome)
• karty adaptacyjne
• Wizualizator Kart Adaptacyjnych, przykłady
• Procedura aktywacji URI
• Microsoft Graph