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-preview.3.24172.9

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, kterou 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 může modul rozpoznávání řeči rozpoznat jako smysluplný vstup. Další informace o vytváření a používání gramatik 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 načíst modul rozpoznávání řeči 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 , ze souboru nebo z 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 kompilované do binárního souboru s příponou .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 snížit kompilací gramatiky předem pomocí jedné z Compile metod.

Modul pro 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 je vyvolána, když vstup odpovídá cestě prostřednictvím gramatiky.

Poznámka

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

Windows a platforma Speech poskytují zabezpečení pro aplikace, které sestavují Grammar instanci z knihovny DLL nebo z 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. ClR (Common Language Runtime) izoluje všechny načtené knihovny DLL, aby získaly definici 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 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 ze streamu, 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ý má být 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 rozpoznávání.
IsStg	Získá, zda je gramatika silného typu.
Loaded	Získá, zda Grammar byl načten 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í Grammar.
RuleName	Získá název kořenového pravidla nebo vstupního bodu objektu Grammar .
Weight	Získá nebo nastaví hodnotu hmotnosti 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()	Získá aktuální Type instanci. (Zděděno od Object)
LoadLocalizedGrammarFromType(Type, Object[])	Metoda `LoadLocalizedGrammarFromType` vrátí lokalizovanou instanci objektu Grammar odvozeného 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ána, když rozpoznávání řeči provádí rozpoznávání pomocí objektu Grammar .

Platí pro