Grammar Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Speech.Recognition

Zestaw:: System.Speech.dll

Pakiet:: System.Speech v8.0.0

Pakiet:: System.Speech v9.0.0-preview.3.24172.9

Źródło:: Grammar.cs

Źródło:: Grammar.cs

Źródło:: Grammar.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Obiekt środowiska uruchomieniowego odwołujący 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: Object
Grammar

Pochodne: System.Speech.Recognition.DictationGrammar

Przykłady

Poniższy przykład tworzy Grammar obiekt z gramatyki rozpoznawania mowy zdefiniowanej w pliku XML (cities.xml). Zawartość pliku cities.xml pojawia się 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 istotne 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 go 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żna użyć konstruktora Grammar , aby utworzyć Grammar wystąpienie na podstawie GrammarBuilder obiektu lub SrgsDocument z pliku lub obiektu Stream , który zawiera opis gramatyki w obsługiwanym formacie. Obsługiwane formaty obejmują następujące elementy:

Pliki w formacie XML zgodne z specyfikacją gramatyki rozpoznawania mowy W3C (SRGS) w wersji 1.0
Gramatyki, które zostały skompilowane do pliku binarnego z rozszerzeniem pliku cfg

Konstruktory gramatyczne, 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 zuż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 obiekt SpeechRecognizer 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żywanej do kompilowania Grammar obiektu.

System Windows i platforma mowa zapewniają zabezpieczenia 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 nowe wystąpienie Grammar 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 jako punkt 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 rozpoznawać 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 jako punkt wejścia do gramatyki i podstawowy identyfikator URI do rozpoznawania 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 rozpoznawać odwołania do reguł względnych.
Grammar(Stream, String, Uri, Object[])	Inicjuje Grammar nowe wystąpienie 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 rozpoznawanie mowy może być używane przez aparat rozpoznawania mowy.
IsStg	Pobiera, czy gramatyka jest silnie typizowana.
Loaded	Pobiera informację, 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 wartość bieżącego wystąpienia. (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 typizowana gramatyka.
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