Version v1.2 der VCD-Elemente und -Attribute (Voice Command Definition, Sprachbefehlsdefinition)

Der Wert des xml:lang-Attributs muss im VoiceCommand-Dokument eindeutig sein, und es handelt sich um eine einzelne, spezifische Sprache, die im Sprachnamenformular angegeben ist und einer Sprache entspricht, die in der Sprachsteuerung verfügbar ist.

Hinweis Sprachen, die in der VCD-Datei angegeben sind, aber auf dem System nicht unterstützt werden, werden ignoriert.

Das Name-Attribut ist optional und kann eine beliebige Zeichenfolge sein. Das Name-Attribut ist jedoch erforderlich, um programmgesteuert auf die PhraseList eines CommandSet-Elements zu verweisen und diese zu aktualisieren. Das CommandSet-Element enthält die folgenden untergeordneten Elemente: CommandPrefix (0 oder 1) oder AppName (0 oder 1), Example (genau 1), Command (1 bis 100), PhraseList-Elemente (0 bis 10) und PhraseTopic-Elemente (0 bis 10). Diese untergeordneten Elemente müssen in der aufgeführten Reihenfolge auftreten.

Optionales untergeordnetes Element des CommandSet-Elements . Falls vorhanden, muss es das erste untergeordnete Element des CommandSet-Elements sein.

Gibt einen benutzerfreundlichen Namen für eine App an, die ein Benutzer sprechen kann, wenn er einen Sprachbefehl gibt. Dies ist nützlich für Apps mit langen oder schwer auszusprechenden Namen.

Vermeiden Sie die Verwendung von Präfixen, die mit anderen sprachfähigen Umgebungen in Konflikt geraten.

Optionales untergeordnetes Element des CommandSet-Elements . Falls vorhanden, muss es das erste untergeordnete Element des CommandSet-Elements sein.

Ersetzt CommandPrefix und unterstützt das RequireAppName-Attribut und {builtin:AppName} den Ausdruck des ListenFor-Elements .

Gibt einen benutzerfreundlichen Namen für eine App an, die ein Benutzer sprechen kann, wenn er einen Sprachbefehl gibt. Dies ist nützlich für Apps mit langen oder schwer auszusprechenden Namen.

Vermeiden Sie die Verwendung von Präfixen, die mit anderen sprachfähigen Umgebungen in Konflikt geraten.

Der AppName wird standardmäßig als Suffix im Sprachbefehl unterstützt.

Erforderliches untergeordnetes Element des CommandSet-Elements .

Verwendet das Name-Attribut . Definiert eine App-Aktion, die Benutzer durch Sprechen initiieren können, und was Benutzer sagen können, um die Aktion zu initiieren. Jedes Command-Element kann einer bestimmten Seite in Ihrer App zugeordnet werden. Enthält die folgenden erforderlichen untergeordneten Elemente: Example (genau 1), ListenFor (1 bis 20), Feedback (genau 1) und Navigate (genau 1). Diese untergeordneten Elemente müssen in der aufgeführten Reihenfolge auftreten.

Hinweis Beispiele hierfür sollten AppName oder CommandPrefix sein.

Erforderlich (1 bis 20) untergeordnetes Element des Command-Elements .

Enthält ein Wort oder einen Ausdruck, den Ihre App für diesen Befehl erkennt. Dies kann ein Verweis auf das Label-Attribut eines PhraseList- (oder PhraseTopic-Elements) sein, das im ListenFor-Element angezeigt wird, das in geschweiften Klammern eingeschlossen ist, z. B. {myList}, oder {myTopic}.

Der Inhalt aller ListenFor-Elemente kann erkannt werden, um den Befehl zu aktivieren.

Ein optionales RequireAppName-Attribut kann angegeben werden, um anzugeben, ob der Wert des AppName-Elements inline mit dem ListenFor-Element vorangestellt, angefügt oder verwendet werden kann.

Dieses Attribut unterstützt vier Werte:

• BeforePhrase

  Der Benutzer muss den AppName vor dem ListenFor-Ausdruck angeben.

• AfterPhrase

  Der Benutzer muss "In|Ein|Verwenden|Mit" AppName nach dem ListenFor-Ausdruck .

• BeforeOrAfterPhrase

  Der Benutzer muss den AppName vor oder nach dem ListenFor-Ausdruck angeben.

• ExplicitlySpecified

  In ListenFor wird explizit auf den AppName verwiesen, wobei verwendet {builtin:AppName}wird. Der Benutzer muss den AppName nicht vor oder nach dem ListenFor-Ausdruck angeben.

Verwenden Sie Klammern um ein Wort oder Wörter, die optional sind. Das heißt, das Wort oder die Wörter können gesprochen werden, sind aber für eine Übereinstimmung nicht erforderlich. Beispiel: <ListenFor>[Show] {options}</ListenFor>.

Sie können Platzhalterfunktionen einrichten, indem Sie ein Sternchen in ein Paar geschweifte Klammern einfügen, z. B <ListenFor> Find {*} </ListenFor>. . In diesem Beispiel entspricht der Sprachbefehl, solange der Benutzer "Suchen" spricht, optional gefolgt von einem anderen Wort oder Ausdruck. Wenn der Sprachbefehl für ein ListenFor-Element mit Wildcard-Aktivierung übereinstimmt, enthält die SpeechRecognitionResult.Text-Eigenschaft die Zeichenfolge "..." an derselben Position wie der Platzhalter.

Optionales untergeordnetes Element des CommandSet-Elements . Ein CommandSet-Element darf nicht mehr als 2.000 Item-Elemente enthalten, und 2.000 Item-Elemente sind die kombinierte Obergrenze für alle PhraseList-Elemente in einem CommandSet. Jedes Element gibt ein Wort oder einen Ausdruck an, der erkannt werden kann, um den Befehl zu initiieren, der auf die PhraseList verweist. Der Inhalt der Elemente kann programmgesteuert in Ihrer Anwendung aktualisiert werden. Für eine PhraseList ist das Label-Attribut erforderlich, dessen Wert in ListenFor- oder Feedback-Elementen – eingeschlossen von geschweiften Klammern – angezeigt werden kann und zum Verweisen auf die PhraseList verwendet wird.

PhraseList verfügt über ein optionales Disambiguate-Attribut (standard true), das angibt, ob diese PhraseList zu Benutzerdeutigkeit führt, wenn mehrere Elemente aus der Liste gleichzeitig erkannt werden. Bei false ist diese PhraseList auch innerhalb von Feedbackelementen nicht verwendbar und erzeugt keine Parameter für Ihre Anwendung. Dies ist nützlich für Ausdrücke, die alternative Möglichkeiten sind, dasselbe zu sagen, aber keine spezifische Aktion erfordern.

Um herauszufinden, welcher Ausdruck aus der Liste gesprochen wurde, können Sie in Ihrer App auf das Wörterbuch SpeechRecognitionSemanticInterpretation.Properties zugreifen, indem Sie einen Schlüssel mit demselben Wert wie die Bezeichnung der PhraseList verwenden.

Optionales untergeordnetes Element des CommandSet-Elements . Gibt ein Thema für die Große Vokabelerkennung an. Das Thema kann ein einzelnes (0 oder 1) Szenario-Attribut und mehrere (0 bis 20) untergeordnete Elemente des Subjekts für das Szenario angeben, die verwendet werden können, um die Relevanz der erzielten Anerkennung zu verbessern. Ein PhraseTopic-Element erfordert das Label-Attribut , dessen Wert in listenFor - oder Feedback-Elementen – eingeschlossen von geschweiften Klammern – angezeigt werden kann und zum Verweisen auf PhraseTopic verwendet wird.

Das Scenario-Attribut (Standard "Diktat") gibt das gewünschte Szenario für dieses PhraseTopic an, das die zugrunde liegende Spracherkennung von Sprachbefehlen mithilfe von PhraseTopic optimieren kann, um Ergebnisse zu erzielen, die für den gewünschten Kontext des Befehls besser geeignet sind. Gültige Werte sind "Natürliche Sprache", "Suche", "Kurznachricht", "Diktat", "Befehle" und "Formularausfüllen".

Die untergeordneten Subject-Elemente geben ein Subjekt an, das für das Scenario-Attribut des übergeordneten PhraseTopic-Attributs spezifisch ist, um die Relevanz von Spracherkennungsergebnissen in gesprochenen Befehlen mithilfe von PhraseTopic weiter zu verfeinern. Die Themen werden in der angegebenen Reihenfolge bewertet, und bei Bedarf beschränken später angegebene Themen die zuvor angegebenen. Gültige innere Textwerte sind "Datum/Uhrzeit", "Adressen", "Stadt/Staat", "Personennamen", "Filme", "Musik" und "Telefonnummer". Beispiel: <Subject>Phone Number</Subject>

Um den Inhalt zu ermitteln, der in der Teilmenge eines ListenFor-Elements gesprochen wird, das durch einen PhraseTopic-Verweis dargestellt wird, können Sie auf das Wörterbuch SpeechRecognitionSemanticInterpretation.Properties mithilfe eines Schlüssels mit demselben Wert wie die Bezeichnung von PhraseTopic zugreifen.