Condividi tramite

Procedure consigliate per le attività utente

  • Articolo

Questa guida illustra le procedure consigliate per la creazione e l'aggiornamento delle attività utente. Per una panoramica della funzionalità Attività utente in Windows, vedere Continuare l'attività utente, anche in tutti i dispositivi. In alternativa, vedere la sezione Attività utente di Project Rome per le implementazioni di Attività su altre piattaforme di sviluppo.

Nota

A partire da luglio 2021, gli utenti con cronologia attività sincronizzata tra i dispositivi Windows tramite l'account Microsoft (MSA) non avranno più la possibilità di caricare una nuova attività nella sequenza temporale. Potranno comunque usare Timeline e visualizzare la cronologia delle attività (informazioni sulle app, i siti Web e i file recenti) nel PC locale. Gli account connessi ad AAD non saranno interessati.

Quando creare o aggiornare le attività utente

Poiché ogni app è diversa, spetta a ogni sviluppatore determinare il modo migliore per eseguire il mapping delle azioni all'interno dell'app alle attività utente. Le attività utente verranno presentate in Cortana e Timeline, incentrate sull'aumento della produttività e dell'efficienza degli utenti, consentendo loro di tornare ai contenuti visitati in passato.

Linee guida generali

  • Registrare una singola attività per un gruppo di azioni utente correlate. Questo è particolarmente rilevante per le playlist musicali o gli spettacoli televisivi: una singola attività può essere aggiornata a intervalli regolari per riflettere lo stato dell'utente. In questo caso, si avrà una singola attività utente con più elementi della cronologia che rappresentano periodi di engagement tra più giorni o settimane. Lo stesso vale per le attività basate su documenti su cui l'utente procede gradualmente all'interno dell'app.
  • Archiviazione dei dati utente nel cloud. Se si vuole supportare le attività tra dispositivi, è necessario assicurarsi che il contenuto necessario per riattivare l'attività venga archiviato in una posizione cloud. Le attività specifiche del dispositivo verranno visualizzate nella sequenza temporale del dispositivo in cui è stata creata l'attività, ma potrebbero non essere visualizzate in altri dispositivi.
  • Non creare attività per azioni che gli utenti non dovranno riprendere. Se l'applicazione viene usata per completare operazioni semplici e monouso che non persistono lo stato, è probabile che non sia necessario creare un'attività utente.
  • Non creare attività per le azioni completate da altri utenti. Se un account esterno invia all'utente un messaggio o @-menzioni all'interno dell'app, non è consigliabile creare un'attività per questa operazione. Questo tipo di azione è meglio gestito dalle notifiche del Centro notifiche.
    • Gli scenari di collaborazione sono un'eccezione: se più utenti lavorano insieme alla stessa attività (ad esempio un documento di Word), ci saranno casi in cui un altro utente ha apportato modifiche dopo l'utente. In questo caso, è possibile aggiornare l'attività esistente in modo da riflettere le modifiche apportate al documento. Ciò comporta l'aggiornamento dei dati del contenuto dell'attività utente esistenti senza creare un nuovo elemento cronologia.

Linee guida per tipi specifici di app

Anche se ogni app è diversa, la maggior parte delle app rientra in uno dei modelli di interazione seguenti.

  • App basate su documenti: crea un'attività per ogni documento, con uno o più elementi della cronologia che riflettono i periodi di utilizzo. È importante aggiornare l'attività man mano che vengono apportate modifiche al documento.
  • Giochi: crea un'attività per ogni salvataggio o mondo di gioco. Se il gioco supporta solo una singola sequenza di livelli, si può ri-pubblicare la stessa attività nel tempo, anche se si potrebbe voler aggiornare i dati del contenuto per mostrare lo stato di avanzamento o gli obiettivi più recenti.
  • App di utilità: se non c'è nulla all'interno dell'app che gli utenti devono lasciare e riprendere, non è necessario usare le attività utente. Un buon esempio è una semplice app come Calcolatrice.
  • App line-of-business: esistono molte app per la gestione di attività o flussi di lavoro semplici. Creare un'attività per ogni flusso di lavoro separato a cui si accede tramite l'app (ad esempio, i report spese sarebbero un'attività separata, in modo che l'utente possa quindi fare clic su un'attività per verificare se un report specifico è stato approvato).
  • App di riproduzione multimediale: creare un'attività per raggruppamento logico di contenuto ,ad esempio una playlist, un programma o un contenuto autonomo. La domanda sottostante per gli sviluppatori di app è se ogni parte di contenuto (episodio televisivo, brano) viene conteggiata come contenuto autonomo o parte di una raccolta. Come regola generale, se l'utente sceglie di riprodurre una raccolta o un contenuto sequenziale, la raccolta nel suo complesso è l'attività. Se scelgono di riprodurre una singola parte di contenuto, tale parte di contenuto è l'attività. Di seguito sono riportate linee guida più specifiche.
    • Musica: Album/Artista/Genere: Se l'utente seleziona un album, un artista o un brano di genere e hit, tale raccolta è l'attività; non scrivere un'attività separata per ogni brano. Per raccolte brevi come un singolo album o raccolte riprodotte in un ordine casuale, potrebbe non essere necessario aggiornare l'attività in modo da riflettere la posizione corrente dell'utente. Per la riproduzione sequenziale prolungata, ad esempio un album o una playlist, la registrazione della posizione all'interno dell'album potrebbe avere senso.
    • Musica: playlist intelligenti - Applicazioni che riproducono musica in un ordine casuale devono registrare una singola attività per tale playlist. Se l'utente riproduce la playlist una seconda volta, creare record di cronologia aggiuntivi per la stessa attività. La registrazione della posizione corrente dell'utente nella playlist non è necessaria perché l'ordinamento è casuale.
    • Serie TV - se l'app è configurata per riprodurre l'episodio successivo dopo il completamento di quello corrente, si deve scrivere un'unica attività per la serie TV. Mentre si riproducono i vari episodi in più sessioni di visualizzazione, si aggiornerà l'attività in modo da riflettere la posizione corrente nella serie e verranno creati più record di cronologia.
    • Film - Un film è un singolo contenuto e deve avere un proprio record di storia. Se l'utente smette di guardare il film in parte, è consigliabile registrare la loro posizione. Quando desiderano riprenderlo in futuro, l'attività potrebbe riprendere il film in cui si è interrotto o anche chiedere all'utente se desidera riprendere o iniziare all'inizio.

Design dell'attività utente

Le attività utente sono costituite da tre componenti: un URI di attivazione, dati visivi e metadati del contenuto.

  • L'URI di attivazione è un URI che può essere passato a un'applicazione o a un'esperienza per riprendere l'applicazione con un contesto specifico. In genere, questi collegamenti assumono la forma di gestore di protocolli per uno schema (ad esempio, "my-app://page2?action=edit"). Spetta allo sviluppatore determinare il modo in cui i parametri URI verranno gestiti dall'app. Per altre informazioni, vedere Gestire l'0attivazione degli URI.
  • I dati visivi, costituiti da un set di proprietà obbligatorie e facoltative (ad esempio: titolo, descrizione o elementi scheda adattiva), consentono agli utenti di identificare visivamente un'attività. Vedere di seguito per indicazioni sulla creazione di oggetti visivi scheda adattiva per l'attività.
  • I metadati del contenuto sono dati JSON che possono essere usati per raggruppare e recuperare attività in un contesto specifico. Generalmente, questo assume la forma di dati http://schema.org. Vedere di seguito per indicazioni sulla compilazione di questi dati.

Linee guida per la progettazione di schede adattive

Quando le attività vengono visualizzate nella sequenza temporale, vengono visualizzate usando il framework della scheda adattiva. Se lo sviluppatore non fornisce una scheda adattiva per ogni attività, la sequenza temporale creerà automaticamente una scheda semplice in base al nome o all'icona dell'app, al campo Titolo obbligatorio e al campo Descrizione facoltativo.

Gli sviluppatori di app sono invitati a fornire schede personalizzate usando lo schema JSON della scheda adattiva semplice. Per istruzioni tecniche su come costruire oggetti scheda adattiva, vedere la documentazione sulle schede adattive. Per la progettazione di schede adattive nelle attività utente, vedere le linee guida seguenti.

  • Usare immagini
    • Usare un'immagine univoca per ogni attività, se possibile. Il nome e l'icona dell'applicazione verranno visualizzati automaticamente accanto alla scheda dell'attività; immagini aggiuntive consentiranno agli utenti di individuare l'attività che stanno cercando.
    • Le immagini non devono includere testo che l'utente deve leggere. Questo testo non sarà disponibile per gli utenti con esigenze di accessibilità e non potrà essere cercato.
    • Se l'immagine non contiene testo e può essere ritagliata a circa un rapporto di 2:1, è consigliabile usarlo come immagine di sfondo. Ciò comporta una scheda attività in grassetto che si distinguerà nella sequenza temporale. L'immagine verrà leggermente oscurata per garantire che il testo rimanga visibile sulla scheda e si consiglia di usare solo il nome dell'attività in questo caso, poiché il testo più piccolo può diventare difficile da leggere.
    • Se l'immagine non può essere ritagliata su 2:1, è necessario inserirla nella scheda attività.
      • Se le proporzioni sono Square o Portrait, ancorare l'immagine sul lato destro della scheda senza margini.
      • Se le proporzioni sono Orizzontale, ancorare l'immagine all'angolo superiore destro della scheda.
  • Ogni attività è necessaria per specificare un Nome attività, che deve essere sempre visualizzato.
    • Questo nome deve essere visualizzato nell'angolo superiore sinistro della scheda usando l'opzione testo in grassetto grande. È importante che il nome sia facilmente riconoscibile, poiché questa è l'unica parte che gli utenti vedranno quando l'attività viene visualizzata negli scenari di Cortana. La visualizzazione dello stesso nome in Sequenza temporale semplifica l'esplorazione di un numero elevato di attività da parte degli utenti.
  • Usare lo stesso stile di visualizzazione per tutte le attività dell'app, in modo che gli utenti possano facilmente individuare le attività dell'app nella sequenza temporale.
    • Ad esempio, le attività devono usare lo stesso colore di sfondo.
  • Usare le informazioni supplementari sul testo con moderazione.
    • Evitare di riempire la scheda con testo e usare solo informazioni supplementari che aiutano gli utenti a trovare l'attività corretta o riflettono le informazioni sullo stato (ad esempio lo stato corrente in un'attività specifica).

Linee guida per i metadati del contenuto

Le attività utente possono anche contenere metadati del contenuto, che Windows e Cortana usano per classificare le attività e generare inferenze. Le attività possono quindi essere raggruppate intorno a un particolare argomento, ad esempio una località (se l'utente sta cercando vacanze), oggetto (se l'utente sta cercando qualcosa) o azione (se l'utente sta facendo acquisti per un determinato prodotto in app e siti Web diversi). È consigliabile rappresentare sia i sostantivi che i verbi coinvolti in un'attività.

Nell'esempio seguente il codice JSON dei metadati del contenuto, seguendo gli standard di Schema.org, rappresenta lo scenario: "John ha giocato a Angry Birds con Steve".

// 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"
  }
}

API chiave