Sdílet prostřednictvím


Grammar Třída

Definice

Objekt modulu runtime, který odkazuje na gramatiku rozpoznávání řeči, který může aplikace použít k definování omezení rozpoznávání řeči.

public ref class Grammar
public class Grammar
type Grammar = class
Public Class Grammar
Dědičnost
Grammar
Odvozené

Příklady

Následující příklad vytvoří objekt z gramatiky Grammar rozpoznávání řeči definované v souboru XML (cities.xml). Obsah souboru cities.xml se zobrazí v následujícím příkladu 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>  

Poznámky

Gramatika rozpoznávání řeči je sada pravidel nebo omezení, která definují, co modul rozpoznávání řeči dokáže rozpoznat jako smysluplný vstup. Další informace o vytváření a používání gramatiky rozpoznávání řeči najdete v tématech Rozpoznávání řeči a Vytváření gramatik pomocí SrgsGrammar.

Jakmile vytvoříte gramatiku, musíte ji zabudovat do objektu Grammar , který může modul rozpoznávání řeči načíst a který může vaše aplikace používat za běhu ke správě rozpoznávání řeči. Konstruktor můžete použít Grammar k vytvoření Grammar instance z objektu GrammarBuilder nebo objektu SrgsDocument nebo ze souboru nebo objektu, Stream který obsahuje popis gramatiky v podporovaném formátu. Mezi podporované formáty patří:

Konstruktory gramatiky, které ve svých argumentech přijímají gramatické soubory formátu XML, kompilují gramatiky XML do binárního formátu, aby je optimalizovaly pro načítání a používání modulem rozpoznávání řeči. Dobu potřebnou k vytvoření objektu Grammar z gramatiky ve formátu XML můžete zkrátit kompilací gramatiky předem pomocí jedné z Compile metod.

Modul rozpoznávání řeči aplikace spravovaný objektem SpeechRecognizer nebo SpeechRecognitionEngine může načíst více gramatik rozpoznávání řeči. Aplikace může nezávisle povolit nebo zakázat jednotlivé gramatiky nastavením Enabled vlastnosti a upravit chování rozpoznávání prostřednictvím Grammar vlastností, jako Priority jsou vlastnosti a Weight .

Událost gramatiky SpeechRecognized se vyvolá, když vstup odpovídá cestě přes gramatiku.

Poznámka

Osvědčeným postupem je ověřit bezpečnost jakéhokoli identifikátoru URI nebo knihovny DLL použité k sestavení objektu Grammar .

Windows a platforma Speech poskytují zabezpečení pro aplikace, Grammar které vytvářejí instanci z knihovny DLL nebo gramatiky, která podporuje skriptování.

Skripty v Grammar objektech se vždy spouštějí, jako by byly staženy z webové stránky v objektu Internet Zone. Modul CLR (Common Language Runtime) izoluje všechny načtené knihovny DLL za účelem získání definice gramatiky.

Konstruktory

Grammar()

Inicializuje novou instanci Grammar třídy .

Grammar(GrammarBuilder)

Inicializuje novou instanci Grammar třídy z objektu GrammarBuilder .

Grammar(SrgsDocument)

Inicializuje novou instanci Grammar třídy z objektu SrgsDocument .

Grammar(SrgsDocument, String)

Inicializuje novou instanci Grammar třídy z objektu SrgsDocument a určuje kořenové pravidlo.

Grammar(SrgsDocument, String, Object[])

Inicializuje novou instanci Grammar třídy z instance SrgsDocumenta určuje název pravidla, které má být vstupním bodem do gramatiky.

Grammar(SrgsDocument, String, Uri)

Inicializuje novou instanci Grammar třídy z objektu SrgsDocument , určuje kořenové pravidlo a definuje základní identifikátor URI (Uniform Resource Identifier) pro překlad odkazů na relativní pravidlo.

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

Inicializuje novou instanci Grammar třídy z instance SrgsDocumenta určuje název pravidla, které má být vstupním bodem do gramatiky, a základní identifikátor URI pro překlad relativních odkazů.

Grammar(Stream)

Inicializuje novou instanci Grammar třídy z objektu Stream.

Grammar(Stream, String)

Inicializuje novou instanci Grammar třídy z Stream a určuje kořenové pravidlo.

Grammar(Stream, String, Object[])

Inicializuje novou instanci Grammar třídy z Stream a určuje kořenové pravidlo.

Grammar(Stream, String, Uri)

Inicializuje novou instanci Grammar třídy z datového proudu, určuje kořenové pravidlo a definuje základní identifikátor URI (Uniform Resource Identifier) pro překlad odkazů na relativní pravidlo.

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

Inicializuje novou instanci Grammar třídy a Stream a určuje kořenové pravidlo a základní identifikátor URI pro překlad relativních odkazů.

Grammar(String)

Inicializuje novou instanci Grammar třídy ze souboru.

Grammar(String, String)

Inicializuje novou instanci Grammar třídy ze souboru a určuje kořenové pravidlo.

Grammar(String, String, Object[])

Inicializuje novou instanci Grammar třídy ze souboru, který obsahuje definici gramatiky, a určuje název pravidla, který bude vstupním bodem do gramatiky.

Vlastnosti

Enabled

Získá nebo nastaví hodnotu, která určuje, zda Grammar lze použít rozpoznávání řeči k provedení rozpoznávání.

IsStg

Získá, zda gramatika je silného typu.

Loaded

Získá, zda Grammar byla načtena rozpoznáváním řeči.

Name

Získá nebo nastaví název objektu Grammar .

Priority

Získá nebo nastaví hodnotu priority objektu Grammar .

ResourceName

Získá nebo nastaví hodnotu s názvem binárního prostředku, který byl použit k načtení aktuálního Grammar.

RuleName

Získá název kořenového pravidla nebo vstupního bodu objektu Grammar .

Weight

Získá nebo nastaví hodnotu váhy objektu Grammar .

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
LoadLocalizedGrammarFromType(Type, Object[])

Metoda LoadLocalizedGrammarFromType vrátí lokalizovanou instanci objektu odvozeného Grammar z Type.

MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
StgInit(Object[])

Metoda StgInit inicializuje gramatiku silného typu.

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Událost

SpeechRecognized

Vyvolá se, když rozpoznávání řeči provádí rozpoznávání pomocí objektu Grammar .

Platí pro

Viz také