Elementos e atributos de Voice Command Definition (VCD) v1.1
Observação
A Cortana Skills Kit para consumidores e empresas e as habilidades criadas nessas plataformas foram preteridas.
Consulte a versão mais recente em Elementos e atributos de VCD (Definição de Comando de Voz) v1.2.
Documentação de referência para os elementos e atributos de marcação XML usados em arquivos VCD para especificar restrições de reconhecimento.
Use comandos de voz para iniciar um aplicativo e especificar uma ação ou comando a ser executado. Por exemplo, um usuário pode tocar no botão Iniciar e dizer "Widgets da Contoso, mostrar best sellers" para iniciar o aplicativo Widgets da Contoso e navegar até uma página de "best sellers".
Elementos e atributos
Assim como acontece com qualquer arquivo XML, um arquivo VCD deve começar com uma declaração XML que especifica a versão XML e a codificação de caracteres.
<?xml version="1.0" encoding="utf-8"?>
O elemento raiz é o elemento VoiceCommands e seu atributo xmlns deve ser definido http://schemas.microsoft.com/voicecommands/1.1 como (sem caracteres maiúsculos). Para obter um exemplo que esteja em conformidade com esse esquema, consulte o exemplo de Comando de Voz da Cortana.
| Elemento | Descrição | |
|---|---|---|
| VoiceCommands | Obrigatórios. O elemento raiz de um arquivo VCD. Contém entre 1 e 15 elementos CommandSet , cada um dos quais representa os comandos de voz para um único idioma. | |
| CommandSet | Elemento filho necessário do elemento VoiceCommands . Um contêiner para todos os comandos de voz que um aplicativo aceitará no idioma especificado pelo atributo xml:lang necessário. O valor do atributo xml:lang deve ser exclusivo no documento VoiceCommand e é um idioma único e específico, especificado no formato de nome de idioma, que corresponde a um idioma disponível no painel de controle de Fala . O atributo Name é opcional e pode ser qualquer cadeia de caracteres arbitrária; no entanto, o atributo Name é necessário para referenciar e atualizar a PhraseList de um elemento CommandSet programaticamente. O elemento CommandSet contém os seguintes elementos filho: CommandPrefix (0 ou 1), Exemplo (exatamente 1), Command (1 a 100), elementos PhraseList (0 a 10) e elementos PhraseTopic (0 a 10). Esses elementos filho devem ocorrer na ordem listada. | |
| CommandPrefix | Elemento filho opcional do elemento CommandSet . Se presente, deve ser o primeiro elemento filho do elemento CommandSet . Especifica um nome amigável para um aplicativo que um usuário pode falar ao dar um comando de voz. Isso é útil para aplicativos com nomes longos ou difíceis de pronunciar. Evite usar prefixos que entram em conflito com outras experiências habilitadas para voz. | |
| Comando | Elemento filho necessário do elemento CommandSet . Usa o atributo Name . Define uma ação de aplicativo que os usuários podem iniciar falando e o que os usuários podem dizer para iniciar a ação. Cada elemento Command pode ser associado a uma página específica em seu aplicativo. Contém os seguintes elementos filho necessários: Exemplo (exatamente 1), ListenFor (1 a 10), Feedback (exatamente 1) e Navigate (exatamente 1). Esses elementos filho devem ocorrer na ordem listada. |
|
| Exemplo | Filho necessário do elemento CommandSet e do elemento Command . Fornece um exemplo representativo do que um usuário pode dizer para um CommandSet como um todo e para um comando individual. Esses exemplos ficarão visíveis para um usuário ao exibir a tela O que posso dizer no telefone. Essa tela aparece quando um usuário pressiona e segura o botão Pesquisar e diz"Ajuda" ou "O que posso dizer?", ou toca Em Ver mais. Os exemplos não devem incluir o nome ou o prefixo do aplicativo, pois isso é tratado automaticamente. | |
| ListenFor | Elemento filho obrigatório (1 a 10) do elemento Command . Contém uma palavra ou frase que seu aplicativo reconhecerá para este comando. Isso pode incluir ou ser uma referência ao atributo Label de um elemento PhraseList (ou PhraseTopic), que aparece no elemento ListenFor entre chaves, por exemplo: {myList}ou {myTopic}. O conteúdo de qualquer elemento ListenFor pode ser reconhecido para ativar o comando. Use colchetes em torno de uma palavra ou palavras que são opcionais. Ou seja, a palavra ou as palavras podem ser faladas, mas não são necessárias para uma correspondência. Por exemplo, Você pode configurar a funcionalidade curinga incluindo um caractere asterisco dentro de um par de chaves, como |
|
| Comentários | Elemento filho necessário do elemento Command . Especifica o texto que será exibido e lido novamente para o usuário quando o comando for reconhecido. Se o elemento Feedback incluir uma referência a um atributo Label de um elemento PhraseList (ou PhraseTopic), cada elemento ListenFor no elemento Command que contém também deverá referenciar o mesmo atributo Label do elemento PhraseList (ou PhraseTopic). | |
| Navegar | Elemento filho necessário do elemento Command . O atributo Target é opcional e normalmente é usado para especificar a página para a qual o aplicativo deve navegar quando ele é iniciado. Você pode obter o valor do atributo Target (ou a cadeia de caracteres vazia se omitir o atributo Target ) do dicionário SpeechRecognitionSemanticInterpretation.Properties usando a chave "NavigationTarget". | |
| PhraseList | Filho opcional do elemento CommandSet . Um elemento CommandSet não pode conter mais de 2.000 elementos Item e 2.000 elementos Item é o limite total combinado em todos os elementos PhraseList em um CommandSet. Cada Item especifica uma palavra ou frase que pode ser reconhecida para iniciar o comando que faz referência à PhraseList. O conteúdo de Itens pode ser atualizado programaticamente de dentro de seu aplicativo. Um PhraseList requer o atributo Label , cujo valor pode aparecer — entre chaves — dentro dos elementos ListenFor ou Feedback e é usado para referenciar o PhraseList. PhraseList tem um atributo Disambiguate opcional (padrão true), que especifica se essa PhraseList produzirá a desambiguação do usuário quando vários itens da lista forem reconhecidos simultaneamente. Quando false, essa PhraseList também será inutilizável de dentro dos elementos Feedback e não produzirá parâmetros para seu aplicativo. Isso é útil para frases que são formas alternativas de dizer a mesma coisa, mas não exigem nenhuma ação específica. Em seu aplicativo, para descobrir qual frase da lista foi falada, você pode acessar o dicionário SpeechRecognitionSemanticInterpretation.Properties usando uma chave com o mesmo valor que o Rótulo da PhraseList. |
|
| Item | Filho opcional do elemento PhraseList . Uma das várias palavras ou frases que podem ser reconhecidas para iniciar um comando. Um CommandSet não pode conter mais de 2.000 elementos Item em todos os seus elementos PhraseList filho. | |
| PhraseTopic | Filho opcional do elemento CommandSet . Especifica um tópico para reconhecimento de vocabulário grande. O tópico pode especificar um único atributo (0 ou 1) Scenario e vários (0 a 20) Elementos filho da entidade para o cenário, que podem ser usados para melhorar a relevância do reconhecimento obtido. Um PhraseTopic requer o atributo Label , cujo valor pode aparecer — entre chaves — dentro dos elementos ListenFor ou Feedback e é usado para fazer referência ao PhraseTopic. O atributo Scenario (padrão "Ditado") especifica o cenário desejado para este PhraseTopic, que pode otimizar o reconhecimento de fala subjacente de comandos de voz usando PhraseTopic para produzir resultados mais adequados ao contexto desejado do comando. Os valores válidos são "Linguagem Natural", "Pesquisa", "Mensagem Curta", "Ditado", "Comandos" e "Preenchimento de Formulário". Os elementos filho Subject especificam um assunto específico ao atributo Scenario do PhraseTopic pai para refinar ainda mais a relevância dos resultados de reconhecimento de fala dentro de comandos falados usando PhraseTopic. As entidades serão avaliadas na ordem fornecida e, quando apropriado, as entidades especificadas posteriormente restringirão as especificadas anteriormente. Os valores de texto interno válidos são "Data/Hora", "Endereços", "Cidade/Estado", "Nomes de Pessoas", "Filmes", "Música" e "Número de Telefone". Por exemplo: Em seu aplicativo, para descobrir o conteúdo falado no subconjunto de um elemento ListenFor representado por uma referência PhraseTopic , você pode acessar o dicionário SpeechRecognitionSemanticInterpretation.Properties usando uma chave com o mesmo valor que o Rótulo do PhraseTopic. |
|
Importante
Não é possível aninhar os caracteres especiais listados abaixo. Por exemplo, instruções como [[start] new game] e [{myPhraseList}] não são possíveis.
| Caractere especial | Descrição |
|---|---|
| {} | Contém o valor do atributo Label para a referência PhraseList ou PhraseTopic , por exemplo: {myList}ou {myTopic}. Usado em um elemento ListenFor ou Feedback . Uma referência PhraseList ou PhraseTopic em um elemento Feedback deve corresponder a uma referência correspondente em um elemento ListenFor no mesmo comando. |
| [] | Designa que a palavra ou frase incluída é opcional. A palavra ou frase incluída pode ser falada, mas não é necessário ser reconhecida para iniciar o comando. Por exemplo, se o conteúdo de um elemento ListenFor for "[start] [begin] new game", o usuário poderá falar "start new game" ou "new game" ou "begin new game" (ou até mesmo "start begin new game") para iniciar o comando. Cada elemento entre colchetes é opcional de forma independente, mas deve ser falado na ordem correta para ser reconhecido. Portanto, no exemplo de "novo jogo", "começar um novo jogo" funcionaria, mas "começar a começar um novo jogo" não funcionaria devido à ordem em que foram declarados. |
Confira também
Windows.ApplicationModel.VoiceCommands
Elementos e atributos VCD v1.2
Amostras