DictationGrammar.SetDictationContext(String, String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Adds a context to a dictation grammar that has been loaded by a SpeechRecognizer or a SpeechRecognitionEngine object.
public:
void SetDictationContext(System::String ^ precedingText, System::String ^ subsequentText);
public void SetDictationContext (string precedingText, string subsequentText);
member this.SetDictationContext : string * string -> unit
Public Sub SetDictationContext (precedingText As String, subsequentText As String)
Parameters
- precedingText
- String
Text that indicates the start of a dictation context.
- subsequentText
- String
Text that indicates the end of a dictation context.
Remarks
By default, the dictation grammar does not make use of specific words or word order to identify and interpret audio input. When a context is added to a dictation grammar, the recognition engine uses the precedingText
and subsequentText
to identify when to interpret speech as dictation.
Note
A dictation grammar must be loaded by a SpeechRecognizer or SpeechRecognitionEngine object before you can use SetDictationContext to add a context.
The following table describes how the recognition engine uses the two parameters to determine when to use the dictation grammar.
precedingText |
subsequentText |
Description |
---|---|---|
not null |
not null |
The recognition engine uses the terms to bracket possible candidate phrases. |
null |
not null |
The recognition engine uses the subsequentText to finish dictation. |
not null |
null |
The recognition engine uses the precedingText to start dictation. |
null |
null |
The recognition engine does not use a context when using the dictation grammar. |
Applies to
See also
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應