Grammar Klasa
Definicja
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, 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:
Pliki w formacie XML zgodne z specyfikacją gramatyki rozpoznawania mowy W3C (SRGS) w wersji 1.0
Gramatyki skompilowane do pliku binarnego z rozszerzeniem pliku cfg
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) | |
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 |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
StgInit(Object[]) |
Metoda |
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. |