Compartilhar via


Como interagir com um aplicativo em segundo plano na Cortana (HTML)

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Saiba como um usuário pode interagir com um aplicativo em segundo plano usando a voz e a tela da Cortana durante a execução de um comando de voz.

Os comandos de voz com a Cortana podem incluir uma experiência do usuário avançada e um fluxo de interação na Cortana controlado pelo aplicativo em segundo plano. O aplicativo pode especificar diversos tipos de telas para dar suporte à funcionalidade, incluindo:

  • Conclusão bem-sucedida
  • Transição
  • Progresso
  • Confirmação
  • Desambiguidade
  • Erro

Pré-requisitos

Este tópico complementa Iniciar um aplicativo em segundo plano com comando de voz na Cortana. Continuaremos demonstrando recursos com um aplicativo de planejamento e gerenciamento de viagens chamado Adventure Works.

Para concluir este tutorial, dê uma olhada nestes tópicos para se familiarizar com as tecnologias discutidas aqui.

Instruções

Etapa 1: Tela de conclusão

Uma tela de conclusão fornece ao usuário informações sobre a tarefa de comando de voz concluída.

Veja aqui como a Cortana pode exibir uma lista de resultados de itinerários de viagens futuras do aplicativo Adventure Works para Las Vegas.

Tela de conclusão do aplicativo em segundo plano da Cortana

  1. Escolha as cadeias de feedback que devem ser exibidas e faladas pela Cortana

    Siga as Diretrizes para design da Cortana para obter recomendações sobre como compor cadeias de caracteres para a Cortana mostrar e falar.

  2. Escolha blocos de conteúdo com base na ação realizada (opcional)

    Os blocos de conteúdo podem fornecer um contexto adicional para o usuário e ajudar a manter as cadeias de feedback concisas.

    A Cortana dá suporte aos seguintes modelos de blocos de conteúdo (é possível usar somente um modelo na tela de conclusão):

    • Somente título
    • Título com até três linhas de texto
    • Título com ícone
    • Título com ícone e até três linhas de texto

    O ícone pode ter:

    • 68 l x 68 a
    • 68 l x 92 a
    • 280 l x 140 a

    Você pode também permitir que os usuários iniciem seu aplicativo em primeiro plano, tocando em um bloco ou no link de texto para seu aplicativo.

  3. Mostrar a tela de conclusão bem-sucedida

    Este é um exemplo de uma tela de conclusão bem-sucedida com vários blocos de conteúdo.

    N/A
    

Etapa 2: Tela de transição

Depois que um comando de voz é reconhecido, a Cortana deve apresentar um feedback em aproximadamente 0,5 segundo. Se o serviço de aplicativo não puder concluir a ação especificada pelo comando de voz em 0,5 segundo, a Cortana apresenta ao usuário uma tela de transição por até 5 segundos.

Este é um exemplo de uma tela de transição do aplicativo Adventure Works. Neste exemplo, um usuário consultou a Cortana em relação ao voos futuros para Las Vegas. A tela de transição inclui uma mensagem personalizada com o nome do serviço de aplicativo, um ícone e a cadeia de Feedback declarada no arquivo de VCD.

Tela de transição do aplicativo em segundo plano da Cortana

Etapa 3: Tela de progresso

Depois que um comando de voz é reconhecido, a Cortana deve apresentar um feedback em aproximadamente 0,5 segundo. Se o serviço de aplicativo precisar de mais tempo para concluir a ação, uma tela de progresso poderá ser fornecida para informar ao usuário que o comando de voz está sendo manipulado ativamente.

A Cortana mostra uma tela de progresso por no máximo 5 segundos. Depois de 5 segundos, a Cortana apresenta ao usuário uma mensagem de erro e o serviço de aplicativo é fechado. Se o serviço de aplicativo precisar de mais de 5 segundos para concluir a ação, ele poderá continuar atualizando a Cortana com telas de progresso.

Este é um exemplo de uma tela de transição do aplicativo Adventure Works. Neste exemplo, um usuário cancelou uma viagem para Las Vegas usando a Cortana. A tela de progresso inclui uma mensagem personalizada para a ação, um ícone e um bloco de conteúdo com informações sobre a viagem que está sendo cancelada.

Tela de progresso do aplicativo em segundo plano da Cortana

  1. Escolha as cadeias de feedback que devem ser exibidas e faladas pela Cortana

    Siga as Diretrizes para design da Cortana para obter recomendações sobre como compor cadeias de caracteres para a Cortana mostrar e falar.

  2. Escolha blocos de conteúdo com base na ação realizada (opcional)

    Os blocos de conteúdo podem fornecer um contexto adicional para o usuário e ajudar a manter as cadeias de feedback concisas.

    A Cortana dá suporte aos seguintes modelos de blocos de conteúdo (é possível usar somente um modelo na tela de conclusão):

    • Somente título
    • Título com até três linhas de texto
    • Título com ícone
    • Título com ícone e até três linhas de texto

    O ícone pode ter:

    • 68 l x 68 a
    • 68 l x 92 a
    • 280 l x 140 a

    Você pode também permitir que os usuários iniciem seu aplicativo em primeiro plano, tocando em um bloco ou no link de texto para seu aplicativo.

  3. Compilar a resposta

    Chame ReportProgressAsync para mostrar a tela de progresso na Cortana.

  4. Mostrar a tela de progresso

    Este é um exemplo de uma tela de progresso com um bloco de conteúdo.

    N/A
    

Etapa 4: Tela de confirmação

Quando uma ação especificada por um comando de voz é irreversível, tem um impacto significativo ou a confiança no reconhecimento não for alta, o serviço de um aplicativo pode solicitar uma confirmação.

Este é um exemplo de uma tela de confirmação do aplicativo Adventure Works. Neste exemplo, um usuário instruiu o serviço de aplicativo para cancelar uma viagem para Las Vegas usando a Cortana. O serviço de aplicativo forneceu à Cortana uma tela de confirmação que solicita ao usuário uma resposta sim ou não antes de cancelar a viagem.

Se o usuário disser algo diferente de "Sim" ou "Não", a Cortana não poderá determinar a resposta à pergunta. Nesse caso, a Cortana faz uma pergunta semelhante ao usuário, fornecida pelo serviço de aplicativo.

Na segunda solicitação, se o usuário ainda não responder "Sim" ou "Não", a Cortana fará a mesma pergunta predeterminada ao usuário pela terceira vez, com um pedido de desculpas. Se o usuário ainda não responder "Sim" ou "Não", a Cortana não ouvirá mais a entrada de voz e solicitará que o usuário toque em um dos botões.

A tela de confirmação inclui uma mensagem personalizada para a ação, um ícone e um bloco de conteúdo com informações sobre a viagem que está sendo cancelada.

Tela de confirmação do aplicativo em segundo plano da Cortana

  1. Escolha as cadeias de feedback que devem ser exibidas e faladas pela Cortana

    Siga as Diretrizes para design da Cortana para obter recomendações sobre como compor cadeias de caracteres para a Cortana mostrar e falar.

  2. Escolha blocos de conteúdo com base na ação realizada (opcional)

    Os blocos de conteúdo podem fornecer um contexto adicional para o usuário e ajudar a manter as cadeias de feedback concisas.

    A Cortana dá suporte aos seguintes modelos de blocos de conteúdo (é possível usar somente um modelo na tela de conclusão):

    • Somente título
    • Título com até três linhas de texto
    • Título com ícone
    • Título com ícone e até três linhas de texto

    O ícone pode ter:

    • 68 l x 68 a
    • 68 l x 92 a
    • 280 l x 140 a

    Você pode também permitir que os usuários iniciem seu aplicativo em primeiro plano, tocando em um bloco ou no link de texto para seu aplicativo.

  3. Compilar a resposta

    Chame RequestConfirmationAsync para mostrar a tela de confirmação na Cortana.

  4. Mostrar a tela de confirmação

    Este é um exemplo de uma tela de confirmação com um bloco de conteúdo.

    N/A
    

Etapa 5: Tela de desambiguidade

Quando uma ação especificada por um comando de voz tem mais de um resultado possível, um serviço de aplicativo pode solicitar mais informações do usuário.

Este é um exemplo de uma tela de desambiguidade do aplicativo Adventure Works. Neste exemplo, um usuário instruiu o serviço de aplicativo para cancelar uma viagem para Las Vegas usando a Cortana. No entanto, o usuário tem duas viagens para Las Vegas em datas diferentes, e o serviço de aplicativo não pode concluir a ação sem que o usuário selecione a viagem pretendida.

O serviço de aplicativo fornece à Cortana uma tela de desambiguidade que solicita que o usuário faça a seleção em uma lista de viagens correspondentes para fazer o cancelamento.

Nesse caso, a Cortana faz uma pergunta semelhante ao usuário, fornecida pelo serviço de aplicativo.

Na segunda solicitação, se o usuário ainda não disser algo que possa ser usado para identificar a seleção, a Cortana fará a mesma pergunta predeterminada ao usuário pela terceira vez, com um pedido de desculpas. Se o usuário ainda não disser algo que possa ser usado para identificar a seleção, a Cortana não ouvirá mais a entrada de voz e solicitará que o usuário toque em um dos botões.

A tela de desambiguidade inclui uma mensagem personalizada para a ação, um ícone e um bloco de conteúdo com informações sobre a viagem que está sendo cancelada.

Tela de desambiguidade do aplicativo em segundo plano da Cortana

  1. Escolha as cadeias de feedback que devem ser exibidas e faladas pela Cortana

    Siga as Diretrizes para design da Cortana para obter recomendações sobre como compor cadeias de caracteres para a Cortana mostrar e falar.

  2. Escolha blocos de conteúdo com base na ação realizada (opcional)

    Os blocos de conteúdo podem fornecer um contexto adicional para o usuário e ajudar a manter as cadeias de feedback concisas.

    A Cortana dá suporte aos seguintes modelos de blocos de conteúdo (é possível usar somente um modelo na tela de conclusão):

    • Somente título
    • Título com até três linhas de texto
    • Título com ícone
    • Título com ícone e até três linhas de texto

    O ícone pode ter:

    • 68 l x 68 a
    • 68 l x 92 a
    • 280 l x 140 a

    Você pode também permitir que os usuários iniciem seu aplicativo em primeiro plano, tocando em um bloco ou no link de texto para seu aplicativo.

  3. Compilar a resposta

    Chame RequestDisambiguationAsync para mostrar a tela de desambiguidade na Cortana.

  4. Mostrar a tela de desambiguidade

    Este é um exemplo de uma tela de desambiguidade com blocos de conteúdo.

    N/A
    

Etapa 6: Tela de erro

Quando não é possível concluir uma ação especificada por um comando de voz, o serviço de aplicativo pode fornecer uma tela de erro.

Este é um exemplo de uma tela de erro do aplicativo Adventure Works. Neste exemplo, um usuário instruiu o serviço de aplicativo para cancelar uma viagem para Las Vegas usando a Cortana. No entanto, o usuário não tem viagens agendadas para Las Vegas.

O serviço de aplicativo fornece à Cortana uma tela de erro que inclui uma mensagem personalizada para a ação, um ícone e a mensagem de erro específica.

  1. Escolha as cadeias de feedback que devem ser exibidas e faladas pela Cortana

    Siga as Diretrizes para design da Cortana para obter recomendações sobre como compor cadeias de caracteres para a Cortana mostrar e falar.

  2. Escolha blocos de conteúdo com base na ação realizada (opcional)

    Os blocos de conteúdo podem fornecer um contexto adicional para o usuário e ajudar a manter as cadeias de feedback concisas.

    A Cortana dá suporte aos seguintes modelos de blocos de conteúdo (é possível usar somente um modelo na tela de conclusão):

    • Somente título
    • Título com até três linhas de texto
    • Título com ícone
    • Título com ícone e até três linhas de texto

    O ícone pode ter:

    • 68 l x 68 a
    • 68 l x 92 a
    • 280 l x 140 a

    Você pode também permitir que os usuários iniciem seu aplicativo em primeiro plano, tocando em um bloco ou no link de texto para seu aplicativo.

  3. Compilar a resposta

    Chame ReportFailureAsync para mostrar a tela de erro na Cortana.

  4. Mostrar a tela de erro

    Este é um exemplo de uma tela de erro.

    N/A
    

Exemplo completo

Tópicos relacionados

Interações da Cortana

Iniciar um aplicativo em segundo plano com comandos de voz na Cortana

VCD elements and attributes v1.2

Designers

Diretrizes para design da Cortana