Grammar Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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 waktu proses untuk mengelola pengenalan ucapan. Anda dapat menggunakan Grammar konstruktor untuk membuat Grammar instans dari GrammarBuilder objek atau SrgsDocument , atau dari file atau Stream yang berisi deskripsi tata bahasa dalam format yang didukung. Format yang didukung meliputi yang berikut ini:
File format XML yang sesuai dengan Spesifikasi Tata Bahasa Pengenalan Ucapan (SRGS) W3C Versi 1.0
Tata bahasa yang telah dikompilasi ke file biner dengan ekstensi file .cfg
Konstruktor tata bahasa yang menerima file tata bahasa format XML dalam argumennya mengkompilasi tata bahasa XML ke format biner untuk mengoptimalkannya untuk dimuat dan dikonsumsi 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 dinaikkan 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) | |
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 dititik 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 .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 instans Type saat ini. (Diperoleh dari Object) |
LoadLocalizedGrammarFromType(Type, Object[]) |
Metode mengembalikan |
MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
StgInit(Object[]) |
Metode ini |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Acara
SpeechRecognized |
Dimunculkan saat pengenal ucapan melakukan pengenalan menggunakan Grammar objek . |