Grammar Grammar Grammar Grammar Class

정의

응용 프로그램이 음성 인식에 대한 제한 조건을 정의하는 데 사용할 수 있는 음성 인식 문법을 참조하는 런타임 개체입니다.A runtime object that references a speech recognition grammar, which an application can use to define the constraints for speech recognition.

public ref class Grammar
public class Grammar
type Grammar = class
Public Class Grammar
상속
GrammarGrammarGrammarGrammar
파생

예제

다음 예제에서는 생성을 Grammar XML 파일 (cities.xml)에 정의 된 음성 인식 문법 개체입니다.The following example constructs a Grammar object from a speech recognition grammar defined in a XML file (cities.xml). Cities.xml 파일의 내용을 다음 XML 예제에 표시 됩니다.The content of the cities.xml file appears in the following XML example.

// Load a cities grammar from a local file and return the grammar object.   
private static Grammar CreateGrammarFromFile()  
{  
  Grammar citiesGrammar = new Grammar(@"c:\temp\cities.xml");  
  citiesGrammar.Name = "SRGS File Cities Grammar";  
  return citiesGrammar;  
}  

<?xml version="1.0" encoding="UTF-8" ?>  
<grammar version="1.0" xml:lang="en-US"  
         xmlns="http://www.w3.org/2001/06/grammar"  
         tag-format="semantics/1.0" root="Main">  

  <!-- cities.xml:   
    Defines an SRGS grammar for requesting a flight. This grammar includes  
    a Cities rule that lists the cities that can be used for departures  
    and destinations. -->  

  <rule id="Main">  
    <item>  
      I would like to fly from <ruleref uri="#Cities"/>  
      to <ruleref uri="#Cities"/>  
    </item>  
  </rule>  

  <rule id="Cities" scope="public">  
    <one-of>  
      <item> Seattle </item>  
      <item> Los Angeles </item>  
      <item> New York </item>  
      <item> Miami </item>  
    </one-of>  
  </rule>  
</grammar>  

설명

음성 인식 문법을 의미 있는 입력으로 인식 하는 음성 인식 엔진 수를 정의 하는 제약 조건 또는 규칙의 집합.A speech recognition grammar is a set of rules or constraints that define what a speech recognition engine can recognize as meaningful input. 만들기 및 음성 인식 문법을 사용 하는 방법에 대 한 자세한 내용은 참조 하세요. 음성 인식문법을 사용 하 여 XML 만들기, 만들기 문법을 사용 하 여 GrammarBuilder, 및 SrgsGrammar를 사용 하 여 문법을 만들합니다.For more information about creating and using speech recognition grammars, see Speech Recognition, Create Grammars Using XML, Create Grammars Using GrammarBuilder, and Create Grammars Using SrgsGrammar.

에 작성 해야 문법을 만든 후를 Grammar 개체 음성 인식 엔진을 로드할 수 있습니다 및 음성 인식 기능을 관리 하려면 응용 프로그램이 런타임 시 사용할 수 있습니다.After you author a grammar, you must build it into a Grammar object that a speech recognition engine can load and that your application can use at runtime to manage speech recognition. 사용할 수는 Grammar 만드는 생성자입니다를 Grammar 에서 인스턴스를 GrammarBuilder 또는 SrgsDocument 개체 또는 파일 또는 Stream 문법 지원 되는 형식에서에 대 한 설명을 포함 하는 합니다.You can use a Grammar constructor to create a Grammar instance from a GrammarBuilder or a SrgsDocument object, or from a file or a Stream that contains a description of a grammar in a supported format. 지원 되는 형식은 다음과 같습니다.Supported formats include the following:

XML 형식의 문법 파일에 해당 인수를 수락 하는 문법 생성자에는 음성 인식 엔진에 의해 로드 및 사용에 대 한 최적화를 이진 형식으로 XML 문법을 컴파일합니다.Grammar constructors that accept XML-format grammar files in their arguments compile the XML grammars to a binary format to optimize them for loading and consumption by a speech recognition engine. 생성 하는 데 필요한 시간을 줄일 수 있습니다는 Grammar 중 하나를 사용 하 여 문법 미리 컴파일하여 XML 형식 문법의 개체는 Compile 메서드.You can reduce the amount of time required to construct a Grammar object from an XML-format grammar by compiling the grammar in advance, using one of the Compile methods.

응용 프로그램의 음성 인식 엔진을 관리 하는 SpeechRecognizer 또는 SpeechRecognitionEngine 개체, 여러 음성 인식 문법을 로드할 수 있습니다.An application's speech recognition engine, as managed by a SpeechRecognizer or SpeechRecognitionEngine object, can load multiple speech recognition grammars. 응용 프로그램이 독립적으로 설정 하거나 해제할 수 개별 문법 설정 하 여는 Enabled 속성을 통해 인식 동작을 수정 하 고 Grammar 속성을 같은 합니다 PriorityWeight 속성.The application can independently enable or disable individual grammars by setting the Enabled property, and modify recognition behavior through Grammar properties, such as the Priority and Weight properties.

문법의 SpeechRecognized 입력 문법을 통해 경로 일치 하는 이벤트가 발생 합니다.The grammar's SpeechRecognized event is raised when input matches a path through the grammar.

참고

URI 또는 빌드하는 데 사용 되는 DLL의 안전성을 확인 하는 것이 좋습니다는 Grammar 개체입니다.It is a best practice to verify the safety of any URI or DLL used to build a Grammar object.

Windows 및 음성 플랫폼 제공 생성 하는 응용 프로그램에 대 한 보안을 Grammar DLL 또는 스크립팅을 지 원하는 문법의 인스턴스.Windows and the Speech platform provide security for applications constructing a Grammar instance from a DLL or from a grammar that supports scripting.

스크립트 Grammar 웹 페이지에서 다운로드 한 것 처럼 개체는 항상 실행을 Internet Zone입니다.Scripts in Grammar objects are always run as if downloaded from a web page in the Internet Zone. 공용 언어 런타임 (CLR) 문법 정의 가져오려면 로드 된 DLL을 격리 합니다.The Common Language Runtime (CLR) isolates any DLL loaded to obtain a grammar definition.

생성자

Grammar() Grammar() Grammar() Grammar()

Grammar 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Grammar class

Grammar(GrammarBuilder) Grammar(GrammarBuilder) Grammar(GrammarBuilder) Grammar(GrammarBuilder)

Grammar 개체에서 GrammarBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Grammar class from a GrammarBuilder object.

Grammar(SrgsDocument) Grammar(SrgsDocument) Grammar(SrgsDocument) Grammar(SrgsDocument)

Grammar 개체를 사용하여 SrgsDocument 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of a Grammar class from an SrgsDocument object.

Grammar(SrgsDocument, String) Grammar(SrgsDocument, String) Grammar(SrgsDocument, String) Grammar(SrgsDocument, String)

Grammar 개체 및 지정된 루트 규칙에서의 SrgsDocument 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of a Grammar class from an SrgsDocument object and specifies a root rule.

Grammar(SrgsDocument, String, Object[]) Grammar(SrgsDocument, String, Object[]) Grammar(SrgsDocument, String, Object[]) Grammar(SrgsDocument, String, Object[])

Grammar의 인스턴스에서의 SrgsDocument 클래스의 새 인스턴스를 초기화하며, 문법으로의 진입점이 될 규칙의 이름을 지정합니다.Initializes a new instance of the Grammar class from an instance of SrgsDocument, and specifies the name of a rule to be the entry point to the grammar.

Grammar(SrgsDocument, String, Uri) Grammar(SrgsDocument, String, Uri) Grammar(SrgsDocument, String, Uri) Grammar(SrgsDocument, String, Uri)

상대 규칙 참조를 확인하기 위해 루트 규칙을 지정하고, 기본 URI(Uniform Resource Identifier)를 정의하는 Grammar 개체에서의 SrgsDocument 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of a Grammar class from an SrgsDocument object, specifies a root rule, and defines a base Uniform Resource Identifier (URI) to resolve relative rule references.

Grammar(SrgsDocument, String, Uri, Object[]) Grammar(SrgsDocument, String, Uri, Object[]) Grammar(SrgsDocument, String, Uri, Object[]) Grammar(SrgsDocument, String, Uri, Object[])

Grammar의 인스턴스에서의 SrgsDocument 클래스의 새 인스턴스를 초기화하며, 상대 참조를 확인하기 위해 문법 및 기본 URI로의 진입점이 될 규칙의 이름을 지정합니다.Initializes a new instance of the Grammar class from an instance of SrgsDocument, and specifies the name of a rule to be the entry point to the grammar and a base URI to resolve relative references.

Grammar(Stream) Grammar(Stream) Grammar(Stream) Grammar(Stream)

Grammar에서 Stream 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Grammar class from a Stream.

Grammar(Stream, String) Grammar(Stream, String) Grammar(Stream, String) Grammar(Stream, String)

Grammar에서 Stream 클래스의 새 인스턴스를 초기화하고 루트 규칙을 지정합니다.Initializes a new instance of the Grammar class from a Stream and specifies a root rule.

Grammar(Stream, String, Object[]) Grammar(Stream, String, Object[]) Grammar(Stream, String, Object[]) Grammar(Stream, String, Object[])

Grammar에서 Stream 클래스의 새 인스턴스를 초기화하고 루트 규칙을 지정합니다.Initializes a new instance of the Grammar class from a Stream and specifies a root rule.

Grammar(Stream, String, Uri) Grammar(Stream, String, Uri) Grammar(Stream, String, Uri) Grammar(Stream, String, Uri)

스트림에서의 Grammar 클래스의 새 인스턴스를 초기화하며, 루트 규칙을 지정하고, 상대 규칙 참조를 확인하기 위해 기본 URI(Uniform Resource Identifier)를 정의합니다.Initializes a new instance of the Grammar class from a stream, specifies a root rule, and defines a base Uniform Resource Identifier (URI) to resolve relative rule references.

Grammar(Stream, String, Uri, Object[]) Grammar(Stream, String, Uri, Object[]) Grammar(Stream, String, Uri, Object[]) Grammar(Stream, String, Uri, Object[])

StreamGrammar 클래스의 새 인스턴스를 초기화하며 상대 참조를 확인하기 위해 루트 규칙 및 기본 URI를 지정합니다.Initializes a new instance of the Grammar class a Stream and specifies a root rule and a base URI to resolve relative references.

Grammar(String) Grammar(String) Grammar(String) Grammar(String)

파일에서 Grammar 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Grammar class from a file.

Grammar(String, String) Grammar(String, String) Grammar(String, String) Grammar(String, String)

파일에서 Grammar 클래스의 새로운 인스턴스를 초기화하고 루트 규칙을 지정합니다.Initializes a new instance of the Grammar class from a file and specifies a root rule.

Grammar(String, String, Object[]) Grammar(String, String, Object[]) Grammar(String, String, Object[]) Grammar(String, String, Object[])

문법 정의를 포함하는 파일에서의 Grammar 클래스의 새 인스턴스를 초기화하며, 문법으로의 진입점이 될 규칙의 이름을 지정합니다.Initializes a new instance of the Grammar class from a file that contains a grammar definition, and specifies the name of a rule to be the entry point to the grammar.

속성

Enabled Enabled Enabled Enabled

음성 인식기가 Grammar를 사용하여 인식을 수행할 수 있는지 여부를 제어하는 값을 가져오거나 설정합니다.Gets or sets a value that controls whether a Grammar can be used by a speech recognizer to perform recognition.

IsStg IsStg IsStg IsStg

문법이 강력한 형식으로 되어있는지 여부를 가져옵니다.Gets whether a grammar is strongly typed.

Loaded Loaded Loaded Loaded

음성 인식기가 Grammar을 로드했는지 여부를 가져옵니다.Gets whether a Grammar has been loaded by a speech recognizer.

Name Name Name Name

Grammar 개체의 이름을 가져오거나 설정합니다.Gets or sets the name of a Grammar object.

Priority Priority Priority Priority

Grammar 개체의 우선 순위 값을 가져오거나 설정합니다.Gets or sets the priority value of a Grammar object.

ResourceName ResourceName ResourceName ResourceName

현재 Grammar를 로드하는 데 사용하는 이진 리소스의 이름을 사용하여 값을 가져오거나 설정합니다.Gets or sets a value with the name of a binary resource that was used to load the current Grammar.

RuleName RuleName RuleName RuleName

Grammar 개체의 루트 규칙 또는 입력 지점의 이름을 가져옵니다.Gets the name of the root rule or entry point of a Grammar object.

Weight Weight Weight Weight

Grammar 개체의 가중치 값을 가져오거나 설정합니다.Gets or sets the weight value of a Grammar object.

메서드

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
LoadLocalizedGrammarFromType(Type, Object[]) LoadLocalizedGrammarFromType(Type, Object[]) LoadLocalizedGrammarFromType(Type, Object[]) LoadLocalizedGrammarFromType(Type, Object[])

LoadLocalizedGrammarFromType 메서드는 Grammar에서 파생된 Type 개체의 지역화된 인스턴스를 반환합니다.The LoadLocalizedGrammarFromType method returns a localized instance of a Grammar object derived from Type.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
StgInit(Object[]) StgInit(Object[]) StgInit(Object[]) StgInit(Object[])

StgInit 메서드는 강력한 형식의 문법을 초기화합니다.The StgInit method initializes a strongly-typed grammar.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

이벤트

SpeechRecognized SpeechRecognized SpeechRecognized SpeechRecognized

음성 인식기가 Grammar 개체를 사용하여 인식을 수행할 때 발생했습니다.Raised when a speech recognizer performs recognition using the Grammar object.

적용 대상

추가 정보