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 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
-
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 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) | |
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 |
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 . |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla