Elementos y atributos de definición de comandos de voz (VCD) v1.1
Nota
El Cortana Skills Kit para el consumidor y la empresa, y las aptitudes creadas en estas plataformas, han quedado en desuso.
Consulte la versión más reciente en Definición de comandos de voz (VCD) y atributos v1.2.
Documentación de referencia de los atributos y elementos de marcado XML usados en archivos VCD para especificar restricciones de reconocimiento.
Use comandos de voz para iniciar una aplicación y especificar una acción o un comando que se va a ejecutar. Por ejemplo, un usuario podría pulsar el botón Inicio y decir "Contoso Widgets, mostrar bestsellers" para iniciar la aplicación Contoso Widgets y navegar a una página de "bestellers".
Elementos y atributos
Al igual que con cualquier archivo XML, un archivo VCD debe comenzar con una declaración XML que especifique la versión XML y la codificación de caracteres.
<?xml version="1.0" encoding="utf-8"?>
El elemento raíz es el elemento VoiceCommands y su atributo xmlns debe establecerse http://schemas.microsoft.com/voicecommands/1.1 en (sin caracteres en mayúsculas). Para obtener un ejemplo que se ajuste a este esquema, consulte el ejemplo de comando de voz de Cortana.
| Elemento | Descripción | |
|---|---|---|
| VoiceCommands | Necesario. Elemento raíz de un archivo VCD. Contiene entre 1 y 15 elementos CommandSet , cada uno de los cuales representa los comandos de voz de un solo idioma. | |
| CommandSet | Elemento secundario obligatorio del elemento VoiceCommands . Contenedor para todos los comandos de voz que una aplicación aceptará en el idioma especificado por el atributo xml:lang requerido. El valor del atributo xml:lang debe ser único en el documento VoiceCommand y es un único idioma específico, especificado en formato de nombre de idioma, que corresponde a un idioma que está disponible en el panel de control de voz. El atributo Name es opcional y puede ser cualquier cadena arbitraria; sin embargo, el atributo Name es necesario para hacer referencia y actualizar el phraseList de un elemento CommandSet mediante programación. El elemento CommandSet contiene los siguientes elementos secundarios: CommandPrefix (0 o 1), Example (exactamente 1), Command (1 a 100), Elementos PhraseList (de 0 a 10) y Elementos PhraseTopic (de 0 a 10). Estos elementos secundarios deben aparecer en el orden indicado. | |
| CommandPrefix | Elemento secundario opcional del elemento CommandSet . Si está presente, debe ser el primer elemento secundario del elemento CommandSet . Especifica un nombre descriptivo para una aplicación que un usuario puede hablar al dar un comando de voz. Esto es útil para las aplicaciones con nombres que son largos o son difíciles de pronunciar. Evite usar prefijos que entren en conflicto con otras experiencias habilitadas para voz. | |
| Get-Help | Elemento secundario obligatorio del elemento CommandSet . Toma el atributo Name . Define una acción de aplicación que los usuarios pueden iniciar al hablar y lo que los usuarios pueden decir para iniciar la acción. Cada elemento Command se puede asociar a una página específica de la aplicación. Contiene los siguientes elementos secundarios necesarios: Ejemplo (exactamente 1), ListenFor (de 1 a 10), Comentarios (exactamente 1) y Navegar (exactamente 1). Estos elementos secundarios deben aparecer en el orden indicado. |
|
| Ejemplo | Elemento secundario obligatorio tanto del elemento CommandSet como del elemento Command . Proporciona un ejemplo representativo de lo que un usuario puede decir para un CommandSet en su conjunto y para un comando individual. Estos ejemplos serán visibles para un usuario mientras ve la pantalla Qué puedo decir en el teléfono. Esta pantalla aparece cuando un usuario presiona y mantiene presionado el botón Buscar y dice"Ayuda" o "Qué puedo decir?", o pulsa Ver más. Algunos ejemplos no deben incluir el nombre o el prefijo de la aplicación, ya que esto se controla automáticamente. | |
| ListenFor | Elemento secundario obligatorio (de 1 a 10) del elemento Command . Contiene una palabra o frase que la aplicación reconocerá para este comando. Esto puede incluir o ser una referencia al atributo Label del elemento PhraseList (o PhraseTopic), que aparece en el elemento ListenFor entre llaves, por ejemplo: {myList}o {myTopic}. El contenido de cualquier elemento ListenFor se puede reconocer para activar el comando. Use corchetes alrededor de una palabra o palabras que sean opcionales. Es decir, la palabra o las palabras se pueden decir, pero no son necesarias para una coincidencia. Por ejemplo, Puede configurar la funcionalidad de caracteres comodín mediante la inclusión de un carácter asterisco dentro de un par de llaves, como |
|
| Comentarios | Elemento secundario obligatorio del elemento Command . Especifica el texto que se mostrará y volverá a leer al usuario cuando se reconozca el comando. Si el elemento Feedback incluye una referencia a un atributo Label de un elemento PhraseList (o PhraseTopic), cada elemento ListenFor del elemento Command contenedor también debe hacer referencia al mismo atributo Label del elemento PhraseList (o PhraseTopic). | |
| Navegar | Elemento secundario obligatorio del elemento Command . El atributo Target es opcional y se usa normalmente para especificar la página a la que debe navegar la aplicación cuando se inicia. Puede obtener el valor del atributo Target (o la cadena vacía si omite el atributo Target ) del diccionario SpeechRecognitionSemanticInterpretation.Properties mediante la clave "NavigationTarget". | |
| PhraseList | Elemento secundario opcional del elemento CommandSet . Un elemento CommandSet no puede contener más de 2000 elementos Item y 2000 elementos Item es el límite total combinado en todos los elementos PhraseList de un CommandSet. Cada elemento especifica una palabra o frase que se puede reconocer para iniciar el comando que hace referencia a PhraseList. El contenido de los elementos se puede actualizar mediante programación desde dentro de la aplicación. PhraseList requiere el atributo Label, el valor de que puede aparecer (entre llaves) dentro de los elementos ListenFor o Feedback, y se usa para hacer referencia a PhraseList. PhraseList tiene un atributo Opcional Disambiguate (valor predeterminado true), que especifica si phraseList producirá la desambiguación del usuario cuando se reconozcan simultáneamente varios elementos de la lista. Cuando es false, esta PhraseList también se podrá usar desde los elementos Feedback y no generará parámetros para la aplicación. Esto es útil para las frases que son formas alternativas de decir lo mismo, pero no requieren ninguna acción específica. En la aplicación, para averiguar qué frase de la lista se ha hablado, puedes acceder al diccionario SpeechRecognitionSemanticInterpretation.Properties mediante una clave con el mismo valor que la etiqueta de PhraseList. |
|
| Elemento | Elemento secundario opcional del elemento PhraseList . Una de varias palabras o frases que se pueden reconocer para iniciar un comando. Un CommandSet no puede contener más de 2000 elementos Item en todos sus elementos PhraseList secundarios. | |
| PhraseTopic | Elemento secundario opcional del elemento CommandSet . Especifica un tema para el reconocimiento de vocabulario grande. El tema puede especificar un único atributo scenario (0 o 1) y varios elementos secundarios Subject (de 0 a 20) para el escenario, que se pueden usar para mejorar la relevancia del reconocimiento logrado. Un PhraseTopic requiere el atributo Label , el valor de que puede aparecer (entre llaves) dentro de los elementos ListenFor o Feedback , y se usa para hacer referencia a PhraseTopic. El atributo Scenario (predeterminado "Dictado") especifica el escenario deseado para este PhraseTopic, que puede optimizar el reconocimiento de voz subyacente de los comandos de voz mediante PhraseTopic para generar resultados que sean más adecuados para el contexto deseado del comando. Los valores válidos son "Natural Language", "Search", "Short Message", "Dictation", "Commands" y "Form Filling". Los elementos secundarios Subject especifican un asunto específico del atributo Scenario del objeto PhraseTopic primario para refinar aún más la relevancia de los resultados del reconocimiento de voz en los comandos hablados mediante PhraseTopic. Los sujetos se evaluarán en el orden proporcionado y, cuando corresponda, los sujetos especificados posteriormente restringirán los especificados anteriormente. Los valores de texto interno válidos son "Date/Time", "Addresses", "City/State", "Person Names", "Movies", "Music" y "Phone Number". Por ejemplo: En la aplicación, para averiguar el contenido hablado en el subconjunto de un elemento ListenFor representado por una referencia PhraseTopic , puedes acceder al diccionario SpeechRecognitionSemanticInterpretation.Properties mediante una clave con el mismo valor que la Etiqueta del PhraseTopic. |
|
Importante
No es posible anidar los caracteres especiales que se enumeran a continuación. Por ejemplo, las instrucciones como [[start] new game] y [{myPhraseList}] no son posibles.
| Carácter especial | Descripción |
|---|---|
| {} | Contiene el valor del atributo Label para que se haga referencia a PhraseList o PhraseTopic , por ejemplo: {myList}o {myTopic}. Se usa dentro de un elemento ListenFor o Feedback . Una referencia PhraseList o PhraseTopic en un elemento Feedback debe coincidir con una referencia correspondiente en un elemento ListenFor en el mismo comando. |
| [] | Designa que la palabra o frase delimitada es opcional. Se puede hablar la palabra o frase incluida, pero no es necesario que se reconozca para iniciar el comando. Por ejemplo, si el contenido de un elemento ListenFor es "[start] [begin] new game", el usuario puede hablar "start new game" o "new game" o "begin new game" (o incluso "start start new game") para iniciar el comando. Cada elemento entre corchetes es opcional de forma independiente, pero se debe hablar en el orden correcto para que se reconozca. Por lo tanto, en el ejemplo "nuevo juego", "iniciar nuevo juego" funcionaría, pero "comenzar nuevo juego" no funcionaría debido al orden en que se declararon. |
Consulte también
Windows.ApplicationModel.VoiceCommands
VCD elements and attributes v1.2 (Elementos y atributos de VCD v.1.2)
Muestras