Grammar Třída

Reference

Definice

Obor názvů:: System.Speech.Recognition

Sestavení:: System.Speech.dll

Balíček:: System.Speech v8.0.0

Balíček:: System.Speech v9.0.0-rc.1.24431.7

Zdroj:: Grammar.cs

Zdroj:: Grammar.cs

Zdroj:: Grammar.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: Object
Grammar

Odvozené: System.Speech.Recognition.DictationGrammar

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ří:

Soubory ve formátu XML, které odpovídají specifikaci W3C Speech Recognition Grammar Specification (SRGS) verze 1.0
Gramatiky, které byly zkompilovány do binárního souboru s příponou souboru .cfg

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

Sdílet prostřednictvím