Come interagire con un'app in background in Cortana (HTML)

  • Articolo

[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]

Informazioni su come un utente può interagire con un'app in background tramite la voce e il canvas di Cortana durante l'esecuzione di un comando vocale.

I comandi vocali con Cortana possono includere un'esperienza utente avanzata e un flusso di interazioni all'interno di Cortana che è controllato dall'app background. L'app può specificare numerosi tipi di schermate diversi per supportare la funzionalità, inclusi:

  • Operazione completata
  • Passaggio
  • Stato
  • Conferma
  • Rimozione di ambiguità
  • Errore

Prerequisiti

Questo argomento si basa su Avviare un'app in background con i comandi vocali di Cortana. Continueremo a fornire una dimostrazione delle funzionalità con un'app per la pianificazione e la gestione dei viaggi denominata Adventure Works.

Per completare questa esercitazione ti consigliamo di leggere gli argomenti seguenti per acquisire familiarità con le tecnologie descritte:

Istruzioni

Passaggio 1: Schermata di completamento

Una schermata di completamento fornisce all'utente informazioni sull'attività del comando vocale completata.

Qui viene mostrato in che modo Cortana può visualizzare un elenco di risultati relativi a itinerari di viaggio dall'app Adventure Works per i viaggi in programma a Las Vegas.

Schermata di completamento dell'app in background in Cortana

  1. Scegli le stringhe di feedback che devono essere visualizzate e pronunciate da Cortana

    Segui le linee guida per la progettazione di Cortana per suggerimenti sulla creazione delle stringhe visualizzate e pronunciate da Cortana.

  2. Scegli i riquadri di contenuto in base all'azione eseguita (facoltativo)

    I riquadri di contenuto possono fornire ulteriore contesto per l'utente e contribuire a mantenere concise le stringhe di feedback.

    Cortana supporta i seguenti modelli di riquadro di contenuto (è possibile usare un solo modello nella schermata di completamento):

    • Solo il titolo
    • Titolo con un massimo di tre righe di testo
    • Titolo con icona
    • Titolo con icona e un massimo di tre righe di testo

    L'icona può essere:

    • 68 di larghezza x 68 di altezza
    • 68 di larghezza x 92 di altezza
    • 280 di larghezza x 140 di altezza

    È anche possibile consentire agli utenti di avviare l'app in primo piano toccando un riquadro o il link di testo all'app.

  3. Visualizza la schermata di completamento

    Ecco un esempio di una schermata di completamento con più riquadri di contenuto.

    N/A

Passaggio 2: Schermata di passaggio

Quando un comando vocale viene riconosciuto, Cortana deve presentare il feedback in circa 0,5 secondi. Se il servizio app non riesce a completare l'azione specificata dal comando vocale entro 0,5 secondi, Cortana presenta all'utente una schermata di passaggio per un massimo di 5 secondi.

Ecco un esempio di una schermata di passaggio per l'app Adventure Works. In questo esempio, un utente ha richiesto a Cortana i prossimi voli per Las Vegas. La schermata di passaggio include un messaggio personalizzato con il nome del servizio app, un'icona e la stringa Feedback dichiarata nel file VCD.

Schermata di passaggio dell'app in background in Cortana

Passaggio 3: Schermata di stato

Quando un comando vocale viene riconosciuto, Cortana deve presentare il feedback in circa 0,5 secondi. Se il servizio app impiega più tempo per il completamento dell'azione, può fornire una schermata di stato per indicare all'utente che è in corso l'elaborazione del comando vocale.

Cortana visualizza una schermata di stato per un massimo di 5 secondi. Dopo 5 secondi, Cortana presenta all'utente un messaggio di errore e il servizio app viene chiuso. Se il servizio app impiega più di 5 secondi per completare l'azione, può continuare ad aggiornare Cortana con schermate di stato.

Ecco un esempio di una schermata di passaggio per l'app Adventure Works. In questo esempio, un utente ha annullato un viaggio a Las Vegas tramite Cortana. La schermata di stato include un messaggio personalizzato per l'azione, un'icona e un riquadro di contenuto con informazioni sul viaggio di cui è in corso l'annullamento.

Schermata di stato dell'app in background in Cortana

  1. Scegli le stringhe di feedback che devono essere visualizzate e pronunciate da Cortana

    Segui le linee guida per la progettazione di Cortana per suggerimenti sulla creazione delle stringhe visualizzate e pronunciate da Cortana.

  2. Scegli i riquadri di contenuto in base all'azione eseguita (facoltativo)

    I riquadri di contenuto possono fornire ulteriore contesto per l'utente e contribuire a mantenere concise le stringhe di feedback.

    Cortana supporta i seguenti modelli di riquadro di contenuto (è possibile usare un solo modello nella schermata di completamento):

    • Solo il titolo
    • Titolo con un massimo di tre righe di testo
    • Titolo con icona
    • Titolo con icona e un massimo di tre righe di testo

    L'icona può essere:

    • 68 di larghezza x 68 di altezza
    • 68 di larghezza x 92 di altezza
    • 280 di larghezza x 140 di altezza

    È anche possibile consentire agli utenti di avviare l'app in primo piano toccando un riquadro o il link di testo all'app.

  3. Crea la risposta

    Chiama ReportProgressAsync per visualizzare la schermata di stato in Cortana.

  4. Visualizza la schermata di stato

    Ecco un esempio di una schermata di stato con un riquadro di contenuto.

    N/A

Passaggio 4: Schermata di conferma

Quando un'azione specificata da un comando vocale è irreversibile, ha un impatto significativo o il livello di affidabilità del riconoscimento non è elevato, un servizio app può richiedere una conferma.

Ecco un esempio di una schermata di conferma per l'app Adventure Works. In questo esempio, un utente ha richiesto al servizio app di annullare un viaggio a Las Vegas tramite Cortana. Il servizio app ha fornito a Cortana una schermata di conferma che richiede all'utente di rispondere Sì o No prima di annullare il viaggio.

Se l'utente dice qualcosa di diverso da "Sì" o "No", Cortana non è in grado di determinare la risposta alla domanda. In questo caso, Cortana pone all'utente a una domanda simile a quella fornita dal servizio app.

Se alla seconda richiesta l'utente ancora non pronuncia "Sì" o "No", Cortana pone all'utente la stessa domanda una terza volta, scusandosi per la ripetizione della richiesta. Se l'utente ancora non risponde "Sì" o "No", Cortana interrompe l'ascolto dell'input vocale e richiede all'utente di toccare uno dei pulsanti.

La schermata di conferma include un messaggio personalizzato per l'azione, un'icona e un riquadro di contenuto con informazioni sul viaggio di cui è in corso l'annullamento.

Schermata di conferma dell'app in background in Cortana

  1. Scegli le stringhe di feedback che devono essere visualizzate e pronunciate da Cortana

    Segui le linee guida per la progettazione di Cortana per suggerimenti sulla creazione delle stringhe visualizzate e pronunciate da Cortana.

  2. Scegli i riquadri di contenuto in base all'azione eseguita (facoltativo)

    I riquadri di contenuto possono fornire ulteriore contesto per l'utente e contribuire a mantenere concise le stringhe di feedback.

    Cortana supporta i seguenti modelli di riquadro di contenuto (è possibile usare un solo modello nella schermata di completamento):

    • Solo il titolo
    • Titolo con un massimo di tre righe di testo
    • Titolo con icona
    • Titolo con icona e un massimo di tre righe di testo

    L'icona può essere:

    • 68 di larghezza x 68 di altezza
    • 68 di larghezza x 92 di altezza
    • 280 di larghezza x 140 di altezza

    È anche possibile consentire agli utenti di avviare l'app in primo piano toccando un riquadro o il link di testo all'app.

  3. Crea la risposta

    Chiama RequestConfirmationAsync per visualizzare la schermata di conferma in Cortana.

  4. Visualizza la schermata di conferma

    Ecco un esempio di una schermata di conferma con un riquadro di contenuto.

    N/A

Passaggio 5: Schermata di rimozione di ambiguità

Quando un'azione specificata da un comando vocale ha più di un possibile risultato, un servizio app può richiedere ulteriori informazioni all'utente.

Ecco un esempio di una schermata di rimozione di ambiguità per l'app Adventure Works. In questo esempio, un utente ha richiesto al servizio app di annullare un viaggio a Las Vegas tramite Cortana. L'utente ha tuttavia pianificato due viaggi a Las Vegas in date diverse e il servizio app può completare l'operazione solo se l'utente seleziona il viaggio desiderato.

Il servizio app fornisce a Cortana una schermata di rimozione delle ambiguità che richiede all'utente di effettuare una selezione da un elenco di viaggi corrispondenti, prima di eseguire l'annullamento.

In questo caso, Cortana pone all'utente a una domanda simile a quella fornita dal servizio app.

Se alla seconda richiesta l'utente ancora non dice qualcosa che consenta di identificare la selezione, Cortana pone all'utente la stessa domanda una terza volta, scusandosi per la ripetizione della richiesta. Se l'utente ancora non risponde con qualcosa che consenta di identificare la selezione, Cortana interrompe l'ascolto dell'input vocale e richiede all'utente di toccare uno dei pulsanti.

La schermata di rimozione di ambiguità include un messaggio personalizzato per l'azione, un'icona e un riquadro di contenuto con informazioni sul viaggio di cui è in corso l'annullamento.

Schermata di rimozione di ambiguità dell'app in background in Cortana

  1. Scegli le stringhe di feedback che devono essere visualizzate e pronunciate da Cortana

    Segui le linee guida per la progettazione di Cortana per suggerimenti sulla creazione delle stringhe visualizzate e pronunciate da Cortana.

  2. Scegli i riquadri di contenuto in base all'azione eseguita (facoltativo)

    I riquadri di contenuto possono fornire ulteriore contesto per l'utente e contribuire a mantenere concise le stringhe di feedback.

    Cortana supporta i seguenti modelli di riquadro di contenuto (è possibile usare un solo modello nella schermata di completamento):

    • Solo il titolo
    • Titolo con un massimo di tre righe di testo
    • Titolo con icona
    • Titolo con icona e un massimo di tre righe di testo

    L'icona può essere:

    • 68 di larghezza x 68 di altezza
    • 68 di larghezza x 92 di altezza
    • 280 di larghezza x 140 di altezza

    È anche possibile consentire agli utenti di avviare l'app in primo piano toccando un riquadro o il link di testo all'app.

  3. Crea la risposta

    Chiama RequestDisambiguationAsync per visualizzare la schermata di rimozione di ambiguità in Cortana.

  4. Visualizza la schermata di rimozione di ambiguità

    Ecco un esempio di una schermata di rimozione di ambiguità con riquadri di contenuto.

    N/A

Passaggio 6: Schermata di errore

Quando non è possibile completare un'azione specificata da un comando vocale, un servizio app può fornire una schermata di errore.

Ecco un esempio di una schermata di errore per l'app Adventure Works. In questo esempio, un utente ha richiesto al servizio app di annullare un viaggio a Las Vegas tramite Cortana. L'utente non ha tuttavia pianificato alcun viaggio a Las Vegas.

Il servizio app fornisce a Cortana una schermata di errore che include un messaggio personalizzato per l'azione, un'icona e il messaggio di errore specifico.

  1. Scegli le stringhe di feedback che devono essere visualizzate e pronunciate da Cortana

    Segui le linee guida per la progettazione di Cortana per suggerimenti sulla creazione delle stringhe visualizzate e pronunciate da Cortana.

  2. Scegli i riquadri di contenuto in base all'azione eseguita (facoltativo)

    I riquadri di contenuto possono fornire ulteriore contesto per l'utente e contribuire a mantenere concise le stringhe di feedback.

    Cortana supporta i seguenti modelli di riquadro di contenuto (è possibile usare un solo modello nella schermata di completamento):

    • Solo il titolo
    • Titolo con un massimo di tre righe di testo
    • Titolo con icona
    • Titolo con icona e un massimo di tre righe di testo

    L'icona può essere:

    • 68 di larghezza x 68 di altezza
    • 68 di larghezza x 92 di altezza
    • 280 di larghezza x 140 di altezza

    È anche possibile consentire agli utenti di avviare l'app in primo piano toccando un riquadro o il link di testo all'app.

  3. Crea la risposta

    Chiama ReportFailureAsync per visualizzare la schermata di errore in Cortana.

  4. Visualizza la schermata di errore

    Ecco un esempio di schermata di errore.

    N/A

Esempio completo

Argomenti correlati

Interazioni con Cortana

Avviare un'app in background con i comandi vocali di Cortana

VCD elements and attributes v1.2

Progettisti

Linee guida per la progettazione di Cortana