Grammar Kelas

Definisi

Objek runtime yang mereferensikan tata bahasa pengenalan ucapan, yang dapat digunakan aplikasi untuk menentukan batasan untuk pengenalan ucapan.

public ref class Grammar
public class Grammar
type Grammar = class
Public Class Grammar
Warisan
Grammar
Turunan

Contoh

Contoh berikut membuat Grammar objek dari tata bahasa pengenalan ucapan yang ditentukan dalam file XML (cities.xml). Konten file cities.xml muncul dalam contoh XML berikut.

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

Keterangan

Tata bahasa pengenalan ucapan adalah seperangkat aturan atau batasan yang menentukan apa yang dapat dikenali oleh mesin pengenalan ucapan sebagai input yang bermakna. Untuk informasi selengkapnya tentang membuat dan menggunakan tata bahasa pengenalan ucapan, lihat Pengenalan Ucapan, dan Membuat Tata Bahasa Menggunakan SrgsGrammar.

Setelah Anda menulis tata bahasa, Anda harus membangunnya menjadi Grammar objek yang dapat dimuat oleh mesin pengenalan ucapan dan yang dapat digunakan aplikasi Anda pada runtime untuk mengelola pengenalan ucapan. Anda dapat menggunakan Grammar konstruktor untuk membuat Grammar instans dari GrammarBuilder atau SrgsDocument objek, atau dari file atau Stream yang berisi deskripsi tata bahasa dalam format yang didukung. Format yang didukung meliputi yang berikut ini:

Konstruktor tata bahasa yang menerima file tata bahasa format XML dalam argumennya mengkompilasi tata bahasa XML ke format biner untuk mengoptimalkan pemuatan dan konsumsi oleh mesin pengenalan ucapan. Anda dapat mengurangi jumlah waktu yang Grammar diperlukan untuk membuat objek dari tata bahasa format XML dengan mengkompilasi tata bahasa terlebih dahulu, menggunakan salah Compile satu metode.

Mesin pengenalan ucapan aplikasi, seperti yang dikelola oleh SpeechRecognizer objek atau SpeechRecognitionEngine , dapat memuat beberapa tata bahasa pengenalan ucapan. Aplikasi dapat mengaktifkan atau menonaktifkan tata bahasa individu secara independen dengan mengatur Enabled properti , dan memodifikasi perilaku pengenalan melalui Grammar properti, seperti Priority properti dan Weight .

Peristiwa tata SpeechRecognized bahasa dimunculkan saat input cocok dengan jalur melalui tata bahasa.

Catatan

Ini adalah praktik terbaik untuk memverifikasi keamanan URI atau DLL apa pun yang digunakan untuk membangun Grammar objek.

Windows dan platform Ucapan memberikan keamanan untuk aplikasi yang Grammar membangun instans dari DLL atau dari tata bahasa yang mendukung pembuatan skrip.

Skrip dalam Grammar objek selalu dijalankan seolah-olah diunduh dari halaman web di Internet Zone. Common Language Runtime (CLR) mengisolasi DLL apa pun yang dimuat untuk mendapatkan definisi tata bahasa.

Konstruktor

Grammar()

Menginisialisasi instans baru kelas Grammar.

Grammar(GrammarBuilder)

Menginisialisasi instans Grammar baru kelas dari GrammarBuilder objek.

Grammar(SrgsDocument)

Menginisialisasi instans Grammar baru kelas dari SrgsDocument objek.

Grammar(SrgsDocument, String)

Menginisialisasi instans Grammar baru kelas dari SrgsDocument objek dan menentukan aturan akar.

Grammar(SrgsDocument, String, Object[])

Menginisialisasi instans Grammar baru kelas dari instans SrgsDocument, dan menentukan nama aturan untuk menjadi titik masuk ke tata bahasa.

Grammar(SrgsDocument, String, Uri)

Menginisialisasi instans Grammar baru kelas dari SrgsDocument objek, menentukan aturan akar, dan menentukan Pengidentifikasi Sumber Daya Seragam (URI) dasar untuk menyelesaikan referensi aturan relatif.

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

Menginisialisasi instans Grammar baru kelas dari instans SrgsDocument, dan menentukan nama aturan untuk menjadi titik masuk ke tata bahasa dan URI dasar untuk menyelesaikan referensi relatif.

Grammar(Stream)

Menginisialisasi instans Grammar baru kelas dari Stream.

Grammar(Stream, String)

Menginisialisasi instans Grammar baru kelas dari Stream dan menentukan aturan akar.

Grammar(Stream, String, Object[])

Menginisialisasi instans Grammar baru kelas dari Stream dan menentukan aturan akar.

Grammar(Stream, String, Uri)

Menginisialisasi instans Grammar baru kelas dari aliran, menentukan aturan akar, dan menentukan Pengidentifikasi Sumber Daya Seragam (URI) dasar untuk menyelesaikan referensi aturan relatif.

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

Menginisialisasi instans Grammar baru kelas a Stream dan menentukan aturan akar dan URI dasar untuk menyelesaikan referensi relatif.

Grammar(String)

Menginisialisasi instans Grammar baru kelas dari file.

Grammar(String, String)

Menginisialisasi instans Grammar baru kelas dari file dan menentukan aturan akar.

Grammar(String, String, Object[])

Menginisialisasi instans Grammar baru kelas dari file yang berisi definisi tata bahasa, dan menentukan nama aturan untuk menjadi titik masuk ke tata bahasa.

Properti

Enabled

Mendapatkan atau menetapkan nilai yang mengontrol apakah Grammar dapat digunakan oleh pengenal ucapan untuk melakukan pengenalan.

IsStg

Mendapatkan apakah tata bahasa ditik dengan kuat.

Loaded

Mendapatkan apakah Grammar telah dimuat oleh pengenal ucapan.

Name

Mendapatkan atau mengatur nama Grammar objek.

Priority

Mendapatkan atau mengatur nilai Grammar prioritas objek.

ResourceName

Mendapatkan atau menetapkan nilai dengan nama sumber daya biner yang digunakan untuk memuat saat ini Grammar.

RuleName

Mendapatkan nama aturan akar atau titik Grammar masuk objek.

Weight

Mendapatkan atau mengatur nilai Grammar berat objek.

Metode

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
LoadLocalizedGrammarFromType(Type, Object[])

Metode mengembalikan LoadLocalizedGrammarFromType instans yang dilokalkan dari objek yang Grammar berasal dari Type.

MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
StgInit(Object[])

Metode ini StgInit menginisialisasi tata bahasa yang sangat ditik.

ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Acara

SpeechRecognized

Dimunculkan saat pengenal ucapan melakukan pengenalan menggunakan Grammar objek .

Berlaku untuk

Lihat juga