Grammar 클래스

정의

네임스페이스:

System.Speech.Recognition

어셈블리:

System.Speech.dll

패키지:

System.Speech v9.0.0-preview.3.24172.9

Source:

Grammar.cs

애플리케이션이 음성 인식에 대한 제한 조건을 정의하는 데 사용할 수 있는 음성 인식 문법을 참조하는 런타임 개체입니다.

public ref class Grammar

public class Grammar

type Grammar = class

Public Class Grammar

상속

Object

Grammar

파생

System.Speech.Recognition.DictationGrammar

예제

다음 예제에서는 XML 파일(cities.xml)에 정의된 음성 인식 문법에서 개체를 생성 Grammar 합니다. cities.xml 파일의 콘텐츠는 다음 XML 예제에 나타납니다.

// 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>  

설명

음성 인식 문법은 음성 인식 엔진이 의미 있는 입력으로 인식할 수 있는 항목을 정의하는 규칙 또는 제약 조건 집합입니다. 음성 인식 문법을 만들고 사용하는 방법에 대한 자세한 내용은 음성 인식 및 SrgsGrammar를 사용하여 문법 만들기를 참조하세요.

에 작성 해야 문법을 만든 후를 Grammar 개체 음성 인식 엔진을 로드할 수 있습니다 및 음성 인식 기능을 관리 하려면 애플리케이션이 런타임 시 사용할 수 있습니다. 생성자를 사용하여 Grammar 또는 개체 또는 SrgsDocument 지원되는 형식의 문법에 대한 설명이 포함된 파일 또는 Stream 에서 instance GrammarBuilder 만들 Grammar 수 있습니다. 지원되는 형식은 다음과 같습니다.

• W3C에 따르는 XML 형식 파일 음성 인식 문법 Specification (SRGS) 버전 1.0

• .cfg 파일 확장자를 사용하여 이진 파일로 컴파일된 문법

인수에서 XML 형식 문법 파일을 허용하는 문법 생성자는 XML 문법을 이진 형식으로 컴파일하여 음성 인식 엔진의 로드 및 사용을 최적화합니다. 메서드 중 하나를 Compile 사용하여 문법을 미리 컴파일하여 XML 형식 문법에서 개체를 생성하는 Grammar 데 필요한 시간을 줄일 수 있습니다.

애플리케이션의 음성 인식 엔진을 관리 하는 SpeechRecognizer 또는 SpeechRecognitionEngine 개체, 여러 음성 인식 문법을 로드할 수 있습니다. 애플리케이션이 독립적으로 설정 하거나 해제할 수 개별 문법 설정 하 여는 Enabled 속성을 통해 인식 동작을 수정 하 고 Grammar 속성을 같은 합니다 Priority 및 Weight 속성.

입력이 문법을 SpeechRecognized 통한 경로와 일치하면 문법의 이벤트가 발생합니다.

참고

개체를 빌드 Grammar 하는 데 사용되는 URI 또는 DLL의 안전 여부를 확인하는 것이 가장 좋습니다.

Windows 및 음성 플랫폼 제공 생성 하는 애플리케이션에 대 한 보안을 Grammar DLL 또는 스크립팅을 지 원하는 문법의 인스턴스.

개체의 Grammar 스크립트는 항상 의 웹 페이지에서 Internet Zone다운로드한 것처럼 실행됩니다. CLR(공용 언어 런타임)은 문법 정의를 얻기 위해 로드된 모든 DLL을 격리합니다.

생성자

Grammar()	Grammar 클래스의 새 인스턴스를 초기화합니다.
Grammar(GrammarBuilder)	Grammar 개체에서 GrammarBuilder 클래스의 새 인스턴스를 초기화합니다.
Grammar(SrgsDocument)	Grammar 개체를 사용하여 SrgsDocument 클래스의 새 인스턴스를 초기화합니다.
Grammar(SrgsDocument, String)	개체에서 SrgsDocument 클래스의 Grammar 새 instance 초기화하고 루트 규칙을 지정합니다.
Grammar(SrgsDocument, String, Object[])	Grammar의 인스턴스에서의 SrgsDocument 클래스의 새 인스턴스를 초기화하며, 문법으로의 진입점이 될 규칙의 이름을 지정합니다.
Grammar(SrgsDocument, String, Uri)	개체에서 SrgsDocument 클래스의 Grammar 새 instance 초기화하고, 루트 규칙을 지정하고, 상대 규칙 참조를 resolve 기본 URI(Uniform Resource Identifier)를 정의합니다.
Grammar(SrgsDocument, String, Uri, Object[])	Grammar의 인스턴스에서의 SrgsDocument 클래스의 새 인스턴스를 초기화하며, 상대 참조를 확인하기 위해 문법 및 기본 URI로의 진입점이 될 규칙의 이름을 지정합니다.
Grammar(Stream)	Grammar에서 Stream 클래스의 새 인스턴스를 초기화합니다.
Grammar(Stream, String)	Grammar에서 Stream 클래스의 새 인스턴스를 초기화하고 루트 규칙을 지정합니다.
Grammar(Stream, String, Object[])	Grammar에서 Stream 클래스의 새 인스턴스를 초기화하고 루트 규칙을 지정합니다.
Grammar(Stream, String, Uri)	스트림에서의 Grammar 클래스의 새 인스턴스를 초기화하며, 루트 규칙을 지정하고, 상대 규칙 참조를 확인하기 위해 기본 URI(Uniform Resource Identifier)를 정의합니다.
Grammar(Stream, String, Uri, Object[])	Stream인 Grammar 클래스의 새 인스턴스를 초기화하며 상대 참조를 확인하기 위해 루트 규칙 및 기본 URI를 지정합니다.
Grammar(String)	파일에서 Grammar 클래스의 새 인스턴스를 초기화합니다.
Grammar(String, String)	파일에서 Grammar 클래스의 새로운 인스턴스를 초기화하고 루트 규칙을 지정합니다.
Grammar(String, String, Object[])	문법 정의를 포함하는 파일에서의 Grammar 클래스의 새 인스턴스를 초기화하며, 문법으로의 진입점이 될 규칙의 이름을 지정합니다.

속성

Enabled	음성 인식기가 Grammar를 사용하여 인식을 수행할 수 있는지 여부를 제어하는 값을 가져오거나 설정합니다.
IsStg	문법이 강력한 형식으로 되어있는지 여부를 가져옵니다.
Loaded	음성 인식기가 Grammar을 로드했는지 여부를 가져옵니다.
Name	Grammar 개체의 이름을 가져오거나 설정합니다.
Priority	Grammar 개체의 우선 순위 값을 가져오거나 설정합니다.
ResourceName	현재 Grammar를 로드하는 데 사용하는 이진 리소스의 이름을 사용하여 값을 가져오거나 설정합니다.
RuleName	Grammar 개체의 루트 규칙 또는 입력 지점의 이름을 가져옵니다.
Weight	Grammar 개체의 가중치 값을 가져오거나 설정합니다.

메서드

Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
LoadLocalizedGrammarFromType(Type, Object[])	LoadLocalizedGrammarFromType 메서드는 Grammar에서 파생된 Type 개체의 지역화된 인스턴스를 반환합니다.
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
StgInit(Object[])	StgInit 메서드는 강력한 형식의 문법을 초기화합니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

이벤트

SpeechRecognized

음성 인식기가 Grammar 개체를 사용하여 인식을 수행할 때 발생했습니다.

추가 정보

• SrgsDocument
• GrammarBuilder
• SpeechRecognitionEngine
• SpeechRecognizer
• 음성 인식 문법 사양