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.
- Instale o Microsoft Visual Studio.
- Obter uma licença de desenvolvedor. Para obter instruções, veja Desenvolver usando o Visual Studio 2013.
- Crie seu primeiro aplicativo em JavaScript.
- Mapa para os aplicativos da Windows Store usando JavaScript
- Saiba mais sobre os eventos em Início rápido: adicionando controles HTML e manipulando eventos
- Consulte a referência Voice Command Definition (VCD) elements and attributes v1.2 para saber mais sobre elementos de VCD.
- Confira as Diretrizes de design da Cortana para saber como integrar seu aplicativo à Cortana e as Diretrizes de design de controle por voz para obter dicas úteis para criar um aplicativo interessante e útil habilitado para controle por voz.
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.
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.
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.
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.
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.
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.
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.
Compilar a resposta
Chame ReportProgressAsync para mostrar a tela de progresso na Cortana.
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.
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.
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.
Compilar a resposta
Chame RequestConfirmationAsync para mostrar a tela de confirmação na Cortana.
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.
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.
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.
Compilar a resposta
Chame RequestDisambiguationAsync para mostrar a tela de desambiguidade na Cortana.
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.
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.
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.
Compilar a resposta
Chame ReportFailureAsync para mostrar a tela de erro na Cortana.
Mostrar a tela de erro
Este é um exemplo de uma tela de erro.
N/A
Exemplo completo
Tópicos relacionados
Iniciar um aplicativo em segundo plano com comandos de voz na Cortana
VCD elements and attributes v1.2
Designers