Grammar Classe

Riferimento

Definizione

Spazio dei nomi:: System.Speech.Recognition

Assembly:: System.Speech.dll

Pacchetto:: System.Speech v8.0.0

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

Origine:: Grammar.cs

Origine:: Grammar.cs

Origine:: Grammar.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Un oggetto runtime che fa riferimento a una grammatica di riconoscimento vocale, che un'applicazione può utilizzare per definire vincoli per il riconoscimento vocale.

public ref class Grammar

public class Grammar

type Grammar = class

Public Class Grammar

Ereditarietà: Object
Grammar

Derivato: System.Speech.Recognition.DictationGrammar

Esempio

Nell'esempio seguente viene creato un Grammar oggetto da una grammatica di riconoscimento vocale definita in un file XML (cities.xml). Il contenuto del file cities.xml viene visualizzato nell'esempio XML seguente.

// 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>

Commenti

Una grammatica di riconoscimento vocale è un set di regole o vincoli che definiscono ciò che un motore di riconoscimento vocale può riconoscere come input significativo. Per altre informazioni sulla creazione e sull'uso delle grammatiche di riconoscimento vocale, vedere Riconoscimento vocale e Creare grammatiche con SrgsGrammar.

Dopo aver creato una grammatica, è necessario compilarla in un Grammar oggetto che un motore di riconoscimento vocale può caricare e che l'applicazione può usare in fase di esecuzione per gestire il riconoscimento vocale. È possibile usare un Grammar costruttore per creare un'istanza Grammar da un GrammarBuilder oggetto o SrgsDocument da un file o da un Stream oggetto contenente una descrizione di una grammatica in un formato supportato. I formati supportati includono i seguenti:

File in formato XML conformi a W3C Speech Recognition Grammar Specification (SRGS) versione 1.0
Grammatiche compilate in un file binario con estensione cfg

I costruttori grammaticali che accettano file grammaticali in formato XML nei relativi argomenti compilano le grammatiche XML in un formato binario per ottimizzarle per il caricamento e l'utilizzo da parte di un motore di riconoscimento vocale. È possibile ridurre la quantità di tempo necessaria per costruire un oggetto da una Grammar grammatica in formato XML compilando la grammatica in anticipo, usando uno dei Compile metodi .

Il motore di riconoscimento vocale di un'applicazione, gestito da un SpeechRecognizer oggetto o SpeechRecognitionEngine , può caricare più grammatiche di riconoscimento vocale. L'applicazione può abilitare o disabilitare le singole grammatiche impostando la proprietà e modificando il Enabled comportamento di riconoscimento tramite Grammar proprietà, ad esempio le Priority proprietà e Weight .

L'evento della SpeechRecognized grammatica viene generato quando l'input corrisponde a un percorso tramite la grammatica.

Nota

È consigliabile verificare la sicurezza di qualsiasi URI o DLL usata per compilare un Grammar oggetto.

Windows e la piattaforma Voce forniscono sicurezza per le applicazioni che creano un'istanza Grammar da una DLL o da una grammatica che supporta lo scripting.

Gli script negli Grammar oggetti vengono sempre eseguiti come se scaricati da una pagina Web in Internet Zone. Common Language Runtime (CLR) isola qualsiasi DLL caricata per ottenere una definizione di grammatica.

Costruttori

Grammar()	Inizializza una nuova istanza della classe Grammar.
Grammar(GrammarBuilder)	Inizializza una nuova istanza della classe Grammar da un oggetto GrammarBuilder.
Grammar(SrgsDocument)	Inizializza una nuova istanza della classe Grammar con un oggetto SrgsDocument.
Grammar(SrgsDocument, String)	Inizializza una nuova istanza della Grammar classe da un SrgsDocument oggetto e specifica una regola radice.
Grammar(SrgsDocument, String, Object[])	Inizializza una nuova istanza della classe Grammar da un'istanza dell'oggetto SrgsDocument e specifica il nome di una regola affinché sia il punto di ingresso della grammatica.
Grammar(SrgsDocument, String, Uri)	Inizializza una nuova istanza della Grammar classe da un SrgsDocument oggetto , specifica una regola radice e definisce un URI (Uniform Resource Identifier) di base per risolvere i riferimenti alle regole relative.
Grammar(SrgsDocument, String, Uri, Object[])	Inizializza una nuova istanza della classe Grammar da un'istanza dell'oggetto SrgsDocument e specifica il nome di una regola affinché sia il punto di ingresso della grammatica e un URI di base per risolvere i relativi riferimenti.
Grammar(Stream)	Inizializza una nuova istanza della classe Grammar da un oggetto Stream.
Grammar(Stream, String)	Inizializza una nuova istanza della classe Grammar da Stream e specifica una regola radice.
Grammar(Stream, String, Object[])	Inizializza una nuova istanza della classe Grammar da Stream e specifica una regola radice.
Grammar(Stream, String, Uri)	Inizializza una nuova istanza della classe Grammar da un flusso, specifica una regola radice e definisce un URI (Uniform Resource Identifier) di base per risolvere i relativi riferimenti della regola.
Grammar(Stream, String, Uri, Object[])	Inizializza una nuova istanza delle classi Grammar e Stream e specifica una regola radice e un URI di base per risolvere i riferimenti relativi.
Grammar(String)	Inizializza una nuova istanza della classe Grammar da un file.
Grammar(String, String)	Inizializza una nuova istanza della classe Grammar da un file e specifica una regola radice.
Grammar(String, String, Object[])	Inizializza una nuova istanza della classe Grammar da un file contenente una definizione di grammatica e specifica il nome di una regola che sarà il punto di ingresso della grammatica.

Proprietà

Enabled	Ottiene o imposta un valore che controlla se Grammar può essere utilizzato da un riconoscimento vocale per eseguire il riconoscimento.
IsStg	Ottiene un valore che indica se una grammatica è fortemente tipizzata.
Loaded	Ottiene un valore che indica se Grammar è stato caricato da un riconoscimento vocale.
Name	Ottiene o imposta il nome di un oggetto Grammar.
Priority	Ottiene o imposta il valore di priorità di un oggetto Grammar.
ResourceName	Ottiene o imposta un valore con il nome di una risorsa binaria utilizzata per caricare l'oggetto Grammar corrente.
RuleName	Ottiene il nome del punto di ingresso o della regola radice di un oggetto Grammar.
Weight	Ottiene o imposta il valore della larghezza di un oggetto Grammar.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
LoadLocalizedGrammarFromType(Type, Object[])	Il metodo `LoadLocalizedGrammarFromType` restituisce un'istanza localizzata di un oggetto Grammar derivato da Type.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
StgInit(Object[])	Il metodo `StgInit` inizializza una grammatica fortemente tipizzata.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

SpeechRecognized

Generato quando il riconoscimento vocale esegue il riconoscimento utilizzando l'oggetto Grammar.

Si applica a