Udostępnij za pośrednictwem


Grammar Klasa

Definicja

Obiekt środowiska uruchomieniowego, który odwołuje się do gramatyki rozpoznawania mowy, której aplikacja może użyć do zdefiniowania ograniczeń rozpoznawania mowy.

public ref class Grammar
public class Grammar
type Grammar = class
Public Class Grammar
Dziedziczenie
Grammar
Pochodne

Przykłady

Poniższy przykład tworzy Grammar obiekt z gramatyki rozpoznawania mowy zdefiniowanej w pliku XML (cities.xml). Zawartość pliku cities.xml jest wyświetlana w poniższym przykładzie 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>  

Uwagi

Gramatyka rozpoznawania mowy to zestaw reguł lub ograniczeń, które definiują, co aparat rozpoznawania mowy może rozpoznać jako znaczące dane wejściowe. Aby uzyskać więcej informacji na temat tworzenia i używania gramatyki rozpoznawania mowy, zobacz Rozpoznawanie mowy i Tworzenie gramatyki przy użyciu biblioteki SrgsGrammar.

Po utworzeniu gramatyki należy ją skompilować w Grammar obiekt, który aparat rozpoznawania mowy może załadować i że aplikacja może używać w czasie wykonywania do zarządzania rozpoznawaniem mowy. Możesz użyć konstruktora Grammar , aby utworzyć Grammar wystąpienie z GrammarBuilder obiektu lub SrgsDocument obiektu albo z pliku lub obiektu Stream zawierającego opis gramatyki w obsługiwanym formacie. Obsługiwane formaty obejmują następujące elementy:

Konstruktory gramatyki, które akceptują pliki gramatyczne w formacie XML w swoich argumentach, kompilują gramatyki XML do formatu binarnego, aby zoptymalizować je pod kątem ładowania i użycia przez aparat rozpoznawania mowy. Możesz skrócić czas wymagany do utworzenia Grammar obiektu z gramatyki w formacie XML, kompilując gramatykę z wyprzedzeniem przy użyciu jednej z Compile metod.

Aparat rozpoznawania mowy aplikacji, zarządzany przez SpeechRecognizer obiekt lub SpeechRecognitionEngine , może ładować wiele gramatyk rozpoznawania mowy. Aplikacja może niezależnie włączać lub wyłączać poszczególne gramatyki, ustawiając Enabled właściwość i modyfikując zachowanie rozpoznawania za pomocą Grammar właściwości, takich jak Priority właściwości i Weight .

Zdarzenie gramatyki SpeechRecognized jest wywoływane, gdy dane wejściowe pasują do ścieżki przez gramatykę.

Uwaga

Najlepszym rozwiązaniem jest sprawdzenie bezpieczeństwa dowolnego identyfikatora URI lub biblioteki DLL używanego do kompilowania Grammar obiektu.

System Windows i platforma mowa zapewniają bezpieczeństwo aplikacji tworzących Grammar wystąpienie z biblioteki DLL lub z gramatyki obsługującej skrypty.

Skrypty w Grammar obiektach są zawsze uruchamiane tak, jakby zostały pobrane ze strony internetowej w pliku Internet Zone. Środowisko uruchomieniowe języka wspólnego (CLR) izoluje wszystkie załadowane biblioteki DLL w celu uzyskania definicji gramatycznej.

Konstruktory

Grammar()

Inicjuje nowe wystąpienie klasy Grammar.

Grammar(GrammarBuilder)

Inicjuje Grammar nowe wystąpienie klasy z GrammarBuilder obiektu.

Grammar(SrgsDocument)

Inicjuje Grammar nowe wystąpienie klasy z SrgsDocument obiektu.

Grammar(SrgsDocument, String)

Inicjuje Grammar nowe wystąpienie klasy z SrgsDocument obiektu i określa regułę główną.

Grammar(SrgsDocument, String, Object[])

Inicjuje nowe wystąpienie Grammar klasy z wystąpienia SrgsDocumentklasy i określa nazwę reguły, która ma być punktem wejścia do gramatyki.

Grammar(SrgsDocument, String, Uri)

Inicjuje nowe wystąpienie Grammar klasy z SrgsDocument obiektu, określa regułę główną i definiuje podstawowy identyfikator URI (Uniform Resource Identifier), aby rozwiązać odwołania do reguł względnych.

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

Inicjuje nowe wystąpienie Grammar klasy z wystąpienia SrgsDocumentklasy i określa nazwę reguły, która ma być punktem wejścia do gramatyki i podstawowym identyfikatorem URI w celu rozpoznania odwołań względnych.

Grammar(Stream)

Inicjuje Grammar nowe wystąpienie klasy z klasy Stream.

Grammar(Stream, String)

Inicjuje Grammar nowe wystąpienie klasy z klasy Stream i określa regułę główną.

Grammar(Stream, String, Object[])

Inicjuje Grammar nowe wystąpienie klasy z klasy Stream i określa regułę główną.

Grammar(Stream, String, Uri)

Inicjuje nowe wystąpienie Grammar klasy ze strumienia, określa regułę główną i definiuje podstawowy identyfikator URI (Uniform Resource Identifier), aby rozwiązać odwołania do reguł względnych.

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

Inicjuje nowe wystąpienie Grammar klasy a Stream i określa regułę główną oraz podstawowy identyfikator URI do rozpoznawania odwołań względnych.

Grammar(String)

Inicjuje Grammar nowe wystąpienie klasy z pliku.

Grammar(String, String)

Inicjuje nowe wystąpienie Grammar klasy z pliku i określa regułę główną.

Grammar(String, String, Object[])

Inicjuje nowe wystąpienie Grammar klasy z pliku zawierającego definicję gramatyki i określa nazwę reguły jako punkt wejścia do gramatyki.

Właściwości

Enabled

Pobiera lub ustawia wartość, która określa, czy Grammar może być używany przez rozpoznawanie mowy do rozpoznawania.

IsStg

Pobiera, czy gramatyka jest silnie typizowana.

Loaded

Pobiera, czy element Grammar został załadowany przez rozpoznawanie mowy.

Name

Pobiera lub ustawia nazwę Grammar obiektu.

Priority

Pobiera lub ustawia wartość priorytetu Grammar obiektu.

ResourceName

Pobiera lub ustawia wartość o nazwie zasobu binarnego, który został użyty do załadowania bieżącego Grammarelementu .

RuleName

Pobiera nazwę reguły głównej lub punktu Grammar wejścia obiektu.

Weight

Pobiera lub ustawia wartość Grammar wagi obiektu.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
LoadLocalizedGrammarFromType(Type, Object[])

Metoda LoadLocalizedGrammarFromType zwraca zlokalizowane wystąpienie Grammar obiektu pochodzącego z Typeklasy .

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
StgInit(Object[])

Metoda StgInit inicjuje silnie typizowane gramatyki.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Zdarzenia

SpeechRecognized

Wywoływane, gdy rozpoznawanie mowy wykonuje rozpoznawanie przy użyciu Grammar obiektu.

Dotyczy

Zobacz też