SpeechTranslationConfig class

Konfigurasi terjemahan ucapan.

Extends

Properti

authorizationToken

Mendapatkan/Mengatur token otorisasi. Catatan: Pemanggil perlu memastikan bahwa token otorisasi valid. Sebelum token otorisasi kedaluwarsa, pemanggil perlu merefreshnya dengan memanggil setter ini dengan token baru yang valid.

endpointId

Mendapatkan ID titik akhir dari model ucapan yang disesuaikan yang digunakan untuk pengenalan ucapan.

outputFormat

Mendapatkan format output pengenalan ucapan (sederhana atau terperinci). Catatan: Format output ini untuk hasil pengenalan ucapan, gunakan [SpeechConfig.speechSynthesisOutputFormat] untuk mendapatkan format output audio yang disintesis.

region
speechRecognitionLanguage

Mendapatkan/Mengatur bahasa pengenalan ucapan.

speechSynthesisLanguage

Mendapatkan bahasa synthesizer ucapan. Ditambahkan dalam versi 1.11.0.

speechSynthesisOutputFormat

Mendapatkan format output sintesis ucapan. Ditambahkan dalam versi 1.11.0.

speechSynthesisVoiceName

Mendapatkan suara synthesizer ucapan. Ditambahkan dalam versi 1.11.0.

subscriptionKey
targetLanguages

Mendapatkan bahasa target (teks) untuk diterjemahkan.

voiceName

Mendapatkan nama suara yang dipilih.

Metode

addTargetLanguage(string)

Tambahkan bahasa target (teks) untuk diterjemahkan.

close()

Buang sumber daya terkait.

fromAuthorizationToken(string, string)

Instans statis SpeechTranslationConfig dikembalikan dengan meneruskan token otorisasi dan wilayah layanan. Catatan: Pemanggil perlu memastikan bahwa token otorisasi valid. Sebelum token otorisasi kedaluwarsa, pemanggil perlu merefreshnya dengan mengatur properti authorizationToken dengan token baru yang valid. Jika tidak, semua pengenal yang dibuat oleh instans SpeechTranslationConfig ini akan mengalami kesalahan selama pengenalan. Karena nilai konfigurasi disalin saat membuat pengenal baru, nilai token baru tidak akan berlaku untuk pengenal yang telah dibuat. Untuk pengenal yang telah dibuat sebelumnya, Anda perlu mengatur token otorisasi pengenal yang sesuai untuk menyegarkan token. Jika tidak, pengenal akan mengalami kesalahan selama pengenalan.

fromEndpoint(URL, string)

Membuat instans konfigurasi terjemahan ucapan dengan titik akhir dan kunci langganan yang ditentukan. Metode ini hanya ditujukan untuk pengguna yang menggunakan titik akhir atau paramter layanan non-standar. Catatan: Properti kueri yang ditentukan dalam URL titik akhir tidak diubah, meskipun diatur oleh API lain. Misalnya, jika bahasa didefinisikan dalam uri sebagai parameter kueri "language=de-DE", dan juga diatur oleh properti speechRecognitionLanguage, pengaturan bahasa dalam uri lebih diutamakan, dan bahasa yang efektif adalah "de-DE". Hanya properti yang tidak ditentukan dalam URL titik akhir yang dapat diatur oleh API lain. Catatan: Untuk menggunakan token otorisasi dengan fromEndpoint, teruskan string kosong ke subscriptionKey dalam metode fromEndpoint, lalu atur authorizationToken="token" pada instans SpeechConfig yang dibuat untuk menggunakan token otorisasi.

fromHost(URL, string)

Membuat instans konfigurasi ucapan dengan host dan kunci langganan yang ditentukan. Metode ini hanya ditujukan untuk pengguna yang menggunakan host layanan non-default. Jalur sumber daya standar akan diasumsikan. Untuk layanan dengan jalur sumber daya non-standar atau tidak ada jalur sama sekali, gunakan fromEndpoint sebagai gantinya. Catatan: Parameter kueri tidak diizinkan di URI host dan harus diatur oleh API lain. Catatan: Untuk menggunakan token otorisasi dengan fromHost, gunakan fromHost(URL), lalu atur properti AuthorizationToken pada instans SpeechConfig yang dibuat. Catatan: Ditambahkan dalam versi 1.9.0.

fromSubscription(string, string)

Instans statis SpeechTranslationConfig dikembalikan dengan meneruskan kunci langganan dan wilayah layanan.

setProperty(string | PropertyId, string)

Mengatur properti bernama sebagai nilai

Metode yang Diwarisi

enableAudioLogging()

Aktifkan pengelogan audio dalam layanan. Log audio dan konten disimpan baik di penyimpanan milik Microsoft, atau di akun penyimpanan Anda sendiri yang ditautkan ke langganan Cognitive Services Anda (Bring Your Own Storage (BYOS) yang diaktifkan sumber daya Ucapan). Log akan dihapus setelah 30 hari. Ditambahkan dalam versi 1.7.0.

enableDictation()

Aktifkan dikte. Hanya didukung dalam pengenalan berkelanjutan ucapan. Ditambahkan dalam versi 1.7.0.

getProperty(string, string)

Mengembalikan nilai properti arbitrer saat ini.

requestWordLevelTimestamps()

Menyertakan tanda waktu tingkat kata. Ditambahkan dalam versi 1.7.0.

setProfanity(ProfanityOption)

Mengatur opsi kata-kata kosan. Ditambahkan dalam versi 1.7.0.

setProxy(string, number)

Mengatur konfigurasi proksi. Hanya relevan di lingkungan Node.js. Ditambahkan dalam versi 1.4.0.

setProxy(string, number, string, string)

Mengatur konfigurasi proksi. Hanya relevan di lingkungan Node.js. Ditambahkan dalam versi 1.4.0.

setServiceProperty(string, string, UriQueryParameter)

Mengatur nilai properti yang akan diteruskan ke layanan menggunakan saluran yang ditentukan. Ditambahkan dalam versi 1.7.0.

Detail Properti

authorizationToken

Mendapatkan/Mengatur token otorisasi. Catatan: Pemanggil perlu memastikan bahwa token otorisasi valid. Sebelum token otorisasi kedaluwarsa, pemanggil perlu merefreshnya dengan memanggil setter ini dengan token baru yang valid.

void authorizationToken

Nilai Properti

void

endpointId

Mendapatkan ID titik akhir dari model ucapan yang disesuaikan yang digunakan untuk pengenalan ucapan.

string endpointId

Nilai Properti

string

ID titik akhir

outputFormat

Mendapatkan format output pengenalan ucapan (sederhana atau terperinci). Catatan: Format output ini untuk hasil pengenalan ucapan, gunakan [SpeechConfig.speechSynthesisOutputFormat] untuk mendapatkan format output audio yang disintesis.

OutputFormat outputFormat

Nilai Properti

Mengembalikan format output.

region

string region

Nilai Properti

string

Wilayah yang diatur pada konfigurasi.

speechRecognitionLanguage

Mendapatkan/Mengatur bahasa pengenalan ucapan.

void speechRecognitionLanguage

Nilai Properti

void

speechSynthesisLanguage

Mendapatkan bahasa synthesizer ucapan. Ditambahkan dalam versi 1.11.0.

string speechSynthesisLanguage

Nilai Properti

string

Mengembalikan bahasa sintesis ucapan.

speechSynthesisOutputFormat

Mendapatkan format output sintesis ucapan. Ditambahkan dalam versi 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Nilai Properti

Mengembalikan format output sintesis ucapan

speechSynthesisVoiceName

Mendapatkan suara synthesizer ucapan. Ditambahkan dalam versi 1.11.0.

string speechSynthesisVoiceName

Nilai Properti

string

Mengembalikan suara sintesis ucapan.

subscriptionKey

string subscriptionKey

Nilai Properti

string

Kunci langganan diatur pada konfigurasi.

targetLanguages

Mendapatkan bahasa target (teks) untuk diterjemahkan.

string[] targetLanguages

Nilai Properti

string[]

voiceName

Mendapatkan nama suara yang dipilih.

string voiceName

Nilai Properti

string

Nama suara.

Detail Metode

addTargetLanguage(string)

Tambahkan bahasa target (teks) untuk diterjemahkan.

function addTargetLanguage(value: string)

Parameter

value

string

Bahasa seperti de-DE

close()

Buang sumber daya terkait.

function close()

fromAuthorizationToken(string, string)

Instans statis SpeechTranslationConfig dikembalikan dengan meneruskan token otorisasi dan wilayah layanan. Catatan: Pemanggil perlu memastikan bahwa token otorisasi valid. Sebelum token otorisasi kedaluwarsa, pemanggil perlu merefreshnya dengan mengatur properti authorizationToken dengan token baru yang valid. Jika tidak, semua pengenal yang dibuat oleh instans SpeechTranslationConfig ini akan mengalami kesalahan selama pengenalan. Karena nilai konfigurasi disalin saat membuat pengenal baru, nilai token baru tidak akan berlaku untuk pengenal yang telah dibuat. Untuk pengenal yang telah dibuat sebelumnya, Anda perlu mengatur token otorisasi pengenal yang sesuai untuk menyegarkan token. Jika tidak, pengenal akan mengalami kesalahan selama pengenalan.

static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechTranslationConfig

Parameter

authorizationToken

string

Token otorisasi.

region

string

Nama wilayah (lihat halaman wilayah).

Mengembalikan

Konfigurasi terjemahan ucapan.

fromEndpoint(URL, string)

Membuat instans konfigurasi terjemahan ucapan dengan titik akhir dan kunci langganan yang ditentukan. Metode ini hanya ditujukan untuk pengguna yang menggunakan titik akhir atau paramter layanan non-standar. Catatan: Properti kueri yang ditentukan dalam URL titik akhir tidak diubah, meskipun diatur oleh API lain. Misalnya, jika bahasa didefinisikan dalam uri sebagai parameter kueri "language=de-DE", dan juga diatur oleh properti speechRecognitionLanguage, pengaturan bahasa dalam uri lebih diutamakan, dan bahasa yang efektif adalah "de-DE". Hanya properti yang tidak ditentukan dalam URL titik akhir yang dapat diatur oleh API lain. Catatan: Untuk menggunakan token otorisasi dengan fromEndpoint, teruskan string kosong ke subscriptionKey dalam metode fromEndpoint, lalu atur authorizationToken="token" pada instans SpeechConfig yang dibuat untuk menggunakan token otorisasi.

static function fromEndpoint(endpoint: URL, subscriptionKey: string): SpeechTranslationConfig

Parameter

endpoint

URL

Titik akhir layanan yang akan disambungkan.

subscriptionKey

string

Kunci langganan.

Mengembalikan

Instans konfigurasi ucapan.

fromHost(URL, string)

Membuat instans konfigurasi ucapan dengan host dan kunci langganan yang ditentukan. Metode ini hanya ditujukan untuk pengguna yang menggunakan host layanan non-default. Jalur sumber daya standar akan diasumsikan. Untuk layanan dengan jalur sumber daya non-standar atau tidak ada jalur sama sekali, gunakan fromEndpoint sebagai gantinya. Catatan: Parameter kueri tidak diizinkan di URI host dan harus diatur oleh API lain. Catatan: Untuk menggunakan token otorisasi dengan fromHost, gunakan fromHost(URL), lalu atur properti AuthorizationToken pada instans SpeechConfig yang dibuat. Catatan: Ditambahkan dalam versi 1.9.0.

static function fromHost(hostName: URL, subscriptionKey?: string): SpeechConfig

Parameter

hostName

URL

subscriptionKey

string

Kunci langganan. Jika kunci langganan tidak ditentukan, token otorisasi harus diatur.

Mengembalikan

Instans pabrik ucapan.

fromSubscription(string, string)

Instans statis SpeechTranslationConfig dikembalikan dengan meneruskan kunci langganan dan wilayah layanan.

static function fromSubscription(subscriptionKey: string, region: string): SpeechTranslationConfig

Parameter

subscriptionKey

string

Kunci langganan.

region

string

Nama wilayah (lihat halaman wilayah).

Mengembalikan

Konfigurasi terjemahan ucapan.

setProperty(string | PropertyId, string)

Mengatur properti bernama sebagai nilai

function setProperty(name: string | PropertyId, value: string)

Parameter

name

string | PropertyId

Nama properti yang akan diatur.

value

string

Nilai baru properti.

Detail Metode yang Diwarisi

enableAudioLogging()

Aktifkan pengelogan audio dalam layanan. Log audio dan konten disimpan baik di penyimpanan milik Microsoft, atau di akun penyimpanan Anda sendiri yang ditautkan ke langganan Cognitive Services Anda (Bring Your Own Storage (BYOS) yang diaktifkan sumber daya Ucapan). Log akan dihapus setelah 30 hari. Ditambahkan dalam versi 1.7.0.

function enableAudioLogging()

Diwarisi DariSpeechConfig.enableAudioLogging

enableDictation()

Aktifkan dikte. Hanya didukung dalam pengenalan berkelanjutan ucapan. Ditambahkan dalam versi 1.7.0.

function enableDictation()

Diwarisi DariSpeechConfig.enableDictation

getProperty(string, string)

Mengembalikan nilai properti arbitrer saat ini.

function getProperty(name: string, def?: string): string

Parameter

name

string

Nama properti yang akan dikueri.

def

string

Nilai yang akan dikembalikan jika properti tidak diketahui.

Mengembalikan

string

Nilai saat ini, atau default yang disediakan, dari properti yang diberikan.

Diwarisi dariSpeechConfig.getProperty

requestWordLevelTimestamps()

Menyertakan tanda waktu tingkat kata. Ditambahkan dalam versi 1.7.0.

function requestWordLevelTimestamps()

Diwarisi DariSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

Mengatur opsi kata-kata kosan. Ditambahkan dalam versi 1.7.0.

function setProfanity(profanity: ProfanityOption)

Parameter

profanity
ProfanityOption

Diwarisi DariSpeechConfig.setProfanity

setProxy(string, number)

Mengatur konfigurasi proksi. Hanya relevan di lingkungan Node.js. Ditambahkan dalam versi 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Parameter

proxyHostName

string

Nama host server proksi.

proxyPort

number

Nomor port server proksi.

Diwarisi DariSpeechConfig.setProxy

setProxy(string, number, string, string)

Mengatur konfigurasi proksi. Hanya relevan di lingkungan Node.js. Ditambahkan dalam versi 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number, proxyUserName: string, proxyPassword: string)

Parameter

proxyHostName

string

Nama host server proksi, tanpa skema protokol (http://)

proxyPort

number

Nomor port server proksi.

proxyUserName

string

Nama pengguna server proksi.

proxyPassword

string

Kata sandi server proksi.

Diwarisi DariSpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

Mengatur nilai properti yang akan diteruskan ke layanan menggunakan saluran yang ditentukan. Ditambahkan dalam versi 1.7.0.

function setServiceProperty(name: string, value: string, channel: UriQueryParameter)

Parameter

name

string

value

string

Diwarisi dariSpeechConfig.setServiceProperty