Éléments et attributs d’un fichier VCD v1.2

La valeur de l’attribut xml :lang doit être unique dans le document VoiceCommand , et il s’agit d’une seule langue spécifique, spécifiée dans le formulaire de nom de langue, qui correspond à une langue disponible dans le panneau de configuration Speech .

Note Les langues spécifiées dans le fichier VCD, mais non prises en charge sur le système, sont ignorées.

L’attribut Name est facultatif et peut être n’importe quelle chaîne arbitraire ; Toutefois, l’attribut Name est nécessaire pour référencer et mettre à jour par programmation la propriété PhraseList d’un élément CommandSet. L’élément CommandSet contient les éléments enfants suivants : Éléments CommandPrefix (0 ou 1) ou AppName (0 ou 1), Exemple (exactement 1), Command (1 à 100), Éléments PhraseList (0 à 10) et Éléments PhraseTopic (0 à 10). Ces éléments enfants doivent se produire dans l’ordre indiqué.

Élément enfant facultatif de l’élément CommandSet . Le cas échéant, doit être le premier élément enfant de l’élément CommandSet .

Spécifie un nom convivial pour une application qu’un utilisateur peut parler lors de l’exécution d’une commande vocale. Cela est utile pour les applications dont les noms sont longs ou difficiles à prononcer.

Évitez d’utiliser des préfixes qui entrent en conflit avec d’autres expériences vocales.

Élément enfant facultatif de l’élément CommandSet . Le cas échéant, doit être le premier élément enfant de l’élément CommandSet .

Remplace CommandPrefix et prend en charge l’attribut et {builtin:AppName} l’expression RequireAppName de l’élément ListenFor.

Spécifie un nom convivial pour une application qu’un utilisateur peut parler lors de l’exécution d’une commande vocale. Cela est utile pour les applications dont les noms sont longs ou difficiles à prononcer.

Évitez d’utiliser des préfixes qui entrent en conflit avec d’autres expériences vocales.

Par défaut, appName est pris en charge en tant que suffixe dans la commande vocale.

Élément enfant obligatoire de l’élément CommandSet .

Prend l’attribut Name . Définit une action d’application que les utilisateurs peuvent lancer en parlant et ce que les utilisateurs peuvent dire pour lancer l’action. Chaque élément Command peut être associé à une page spécifique dans votre application. Contient les éléments enfants requis suivants : Example (exactement 1), ListenFor (1 à 20), Feedback (exactement 1) et Navigate (exactement 1). Ces éléments enfants doivent se produire dans l’ordre indiqué.

Note Les exemples doivent inclure AppName ou CommandPrefix.

Élément enfant obligatoire (1 à 20) de l’élément Command .

Contient un mot ou une expression que votre application reconnaîtra pour cette commande. Cela peut inclure ou être une référence à l’attribut Label d’un élément PhraseList (ou PhraseTopic), qui apparaît dans l’élément ListenFor entouré d’accolades, par exemple : {myList}, ou {myTopic}.

Le contenu de n’importe quel élément ListenFor peut être reconnu pour activer la commande.

Un attribut RequireAppName facultatif peut être spécifié pour indiquer si la valeur de l’élément AppName peut être ajoutée, ajoutée ou utilisée en ligne avec l’élément ListenFor .

Cet attribut prend en charge quatre valeurs :

• BeforePhrase

  L’utilisateur doit indiquer appName avant l’expression ListenFor .

• AfterPhrase

  L’utilisateur doit dire « In|Activé|Utilisation de|With » AppName après l’expression ListenFor .

• BeforeOrAfterPhrase

  L’utilisateur doit indiquer appName avant ou après l’expression ListenFor .

• ExplicitlySpecified

  AppName est explicitement référencé dans ListenFor, à l’aide {builtin:AppName}de . L’utilisateur n’est pas tenu de dire appName avant ou après l’expression ListenFor .

Utilisez des crochets autour d’un ou plusieurs mots facultatifs. Autrement dit, le ou les mots peuvent être prononcés, mais ne sont pas nécessaires pour une correspondance. Par exemple : <ListenFor>[Show] {options}</ListenFor>.

Vous pouvez configurer des fonctionnalités génériques en incluant un astérisque à l’intérieur d’une paire d’accolades, telles que <ListenFor> Find {*} </ListenFor>. Dans cet exemple, la commande vocale correspond tant que l’utilisateur parle « Rechercher », éventuellement suivi de tout autre mot ou expression. Si la commande vocale d’un élément ListenFor avec caractère générique est mise en correspondance, la propriété SpeechRecognitionResult.Text contient la chaîne « ... » dans la même position que le caractère générique.

Enfant facultatif de l’élément CommandSet . Un élément CommandSet ne peut pas contenir plus de 2 000 éléments Item , et 2 000 éléments Item constituent la limite totale combinée de tous les éléments PhraseList dans un CommandSet. Chaque élément spécifie un mot ou une expression qui peut être reconnu pour lancer la commande qui fait référence à PhraseList. Le contenu des éléments peut être mis à jour par programmation à partir de votre application. Un Objet PhraseList nécessite l’attribut Label , dont la valeur peut apparaître (entourée d’accolades) à l’intérieur des éléments ListenFor ou Feedback , et est utilisé pour faire référence à PhraseList.

PhraseList a un attribut Disambiguate facultatif (valeur true par défaut), qui spécifie si cette PhraseList génère une levée d’ambiguïté de l’utilisateur lorsque plusieurs éléments de la liste sont reconnus simultanément. Si la valeur est false, cette PhraseList est également inutilisable à partir des éléments Feedback et ne produit pas de paramètres pour votre application. Cela est utile pour les expressions qui sont d’autres façons de dire la même chose, mais qui ne nécessitent aucune action spécifique.

Dans votre application, pour savoir quelle expression de la liste a été parlée, vous pouvez accéder au dictionnaire SpeechRecognitionSemanticInterpretation.Properties à l’aide d’une clé avec la même valeur que l’étiquette de phraseList.

Enfant facultatif de l’élément CommandSet . Spécifie une rubrique pour la reconnaissance de vocabulaire volumineux. La rubrique peut spécifier un attribut scénario unique (0 ou 1) et plusieurs (0 à 20) éléments enfants d’objet pour le scénario, qui peuvent être utilisés pour améliorer la pertinence de la reconnaissance obtenue. Une phraseTopic nécessite l’attribut Label, dont la valeur peut apparaître, entourée d’accolades, à l’intérieur des éléments ListenFor ou Feedback, et est utilisé pour référencer l’élément PhraseTopic.

L’attribut Scenario (par défaut « Dictée ») spécifie le scénario souhaité pour cette PhraseTopic, qui peut optimiser la reconnaissance vocale sous-jacente des commandes vocales à l’aide de PhraseTopic pour produire des résultats mieux adaptés au contexte souhaité de la commande. Les valeurs valides sont « Natural Language », « Search », « Short Message », « Dictée », « Commands » et « Form Filling ».

Les éléments enfants Subject spécifient un sujet spécifique à l’attribut Scenario de l’expressionTopic parente pour affiner davantage la pertinence des résultats de la reconnaissance vocale dans les commandes parlées à l’aide de PhraseTopic. Les sujets seront évalués dans l’ordre fourni et, le cas échéant, les sujets spécifiés ultérieurement limiteront ceux spécifiés précédemment. Les valeurs de texte interne valides sont « Date/Heure », « Adresses », « Ville/État », « Noms de personne », « Films », « Musique » et « Numéro de téléphone ». Par exemple : <Subject>Phone Number</Subject>

Dans votre application, pour connaître le contenu parlé dans le sous-ensemble d’un élément ListenFor représenté par une référence PhraseTopic, vous pouvez accéder au dictionnaire SpeechRecognitionSemanticInterpretation.Properties à l’aide d’une clé avec la même valeur que l’étiquette de PhraseTopic.