SpeechConfig class

Csomag:

microsoft-cognitiveservices-speech-sdk

Beszédkonfiguráció.

Tulajdonságok

authorizationToken	Lekéri az engedélyezési jogkivonatot.
endpointId	Lekéri a beszédfelismeréshez használt testreszabott beszédmodell végpontazonosítóját.
outputFormat	Lekéri a beszédfelismerés kimeneti formátumát (egyszerű vagy részletes). Megjegyzés: Ez a kimeneti formátum beszédfelismerési eredményhez készült, a [SpeechConfig.speechSynthesisOutputFormat] használatával kérje le a szintetizált hangkimeneti formátumot.
region
speechRecognitionLanguage	A konfigurált nyelvet adja vissza.
speechSynthesisLanguage	Lekéri a beszédszintetizátor nyelvét. Hozzáadva az 1.11.0-s verzióhoz.
speechSynthesisOutputFormat	Lekéri a beszédszintézis kimeneti formátumát. Hozzáadva az 1.11.0-s verzióhoz.
speechSynthesisVoiceName	Lekéri a beszédszintetizátor hangját. Hozzáadva az 1.11.0-s verzióhoz.
subscriptionKey

Metódusok

close()	Bezárja a konfigurációt.
enableAudioLogging()	Engedélyezze a hangnaplózást a szolgáltatásban. A hang- és tartalomnaplók a Microsoft tulajdonában lévő tárolóban vagy a Cognitive Services-előfizetéshez (BYOS) engedélyezett Speech-erőforráshoz társított saját tárfiókban vannak tárolva. A naplók 30 nap elteltével törlődnek. Hozzáadva az 1.7.0-s verzióhoz.
enableDictation()	Diktálás engedélyezése. Csak a beszéd folyamatos felismerésében támogatott. Hozzáadva az 1.7.0-s verzióhoz.
fromAuthorizationToken(string, string)	Létrehozza a speech factory egy példányát a megadott kezdeti engedélyezési jogkivonattal és régióval. Megjegyzés: A hívónak meg kell győződnie arról, hogy az engedélyezési jogkivonat érvényes. Az engedélyezési jogkivonat lejárata előtt a hívónak frissítenie kell azt úgy, hogy meghívja ezt a beállítót egy új érvényes jogkivonattal. Megjegyzés: Használjon a LanguageUnderstanding előfizetési kulcsból származtatott jogkivonatot arra az esetre, ha az Intent Recognizert szeretné használni. Mivel a konfigurációs értékek másolása új felismerő létrehozásakor történik, az új tokenérték nem lesz érvényes a már létrehozott felismerőkre. A korábban létrehozott felismerők esetében be kell állítania a megfelelő felismerő engedélyezési jogkivonatát a jogkivonat frissítéséhez. Ellenkező esetben a felismerők hibákba ütköznek a felismerés során.
fromEndpoint(URL, string)	Létrehozza a beszédkonfigurálás egy példányát a megadott végponttal és előfizetési kulccsal. Ez a módszer csak olyan felhasználók számára készült, akik nem szabványos szolgáltatásvégpontot vagy paramétereket használnak. Megjegyzés: Használja a LanguageUnderstanding előfizetői azonosítóját arra az esetre, ha az Intent Recognizert szeretné használni. Megjegyzés: A végpont URL-címében megadott lekérdezési paraméterek nem változnak, még akkor sem, ha más API-k állítják be őket. Ha például a nyelv az URI-ban a "language=de-DE" lekérdezési paraméterként van definiálva, és a SpeechConfig.speechRecognitionLanguage = "en-US" paraméterrel is meg van adva, akkor az URI nyelvbeállítása elsőbbséget élvez, a tényleges nyelv pedig a "de-DE". Más API-k csak a végpont URL-címében nem megadott paramétereket állíthatják be. Megjegyzés: Ha az engedélyezési jogkivonatot fromEndpointtal szeretné használni, adjon át egy üres sztringet a subscriptionKey metódusnak a fromEndpoint metódusban, majd állítsa be az authorizationToken="token" értéket a létrehozott SpeechConfig-példányon az engedélyezési jogkivonat használatára.
fromHost(URL, string)	Létrehozza a beszédkonfigurálás egy példányát a megadott gazdagéppel és előfizetési kulccsal. Ez a módszer csak olyan felhasználók számára készült, akik nem alapértelmezett szolgáltatásgazdát használnak. A rendszer standard erőforrás-elérési utat feltételez. A nem szabványos erőforrás-elérési úttal rendelkező vagy egyáltalán nem elérési úttal rendelkező szolgáltatások esetében használja helyette a fromEndpoint parancsot. Megjegyzés: A lekérdezési paraméterek nem engedélyezettek a gazdagép URI-jában, és más API-knak kell beállítaniuk. Megjegyzés: Ha hitelesítési jogkivonatot szeretne használni a fromHost-hoz, használja a fromHost(URL) parancsot, majd állítsa be az AuthorizationToken tulajdonságot a létrehozott SpeechConfig-példányon. Megjegyzés: Az 1.9.0-s verzióban van hozzáadva.
fromSubscription(string, string)	A SpeechConfig statikus példánya, amelyet a subscriptionKey és a szolgáltatásrégió átadásával ad vissza. Megjegyzés: Használja a LanguageUnderstanding előfizetői azonosítóját arra az esetre, ha az Intent Recognizert szeretné használni.
getProperty(string, string)	Egy tetszőleges tulajdonság aktuális értékét adja vissza.
requestWordLevelTimestamps()	Szószintű időbélyegeket tartalmaz. Hozzáadva az 1.7.0-s verzióhoz.
setProfanity(ProfanityOption)	Beállítja a trágárság beállítást. Hozzáadva az 1.7.0-s verzióhoz.
setProperty(string | PropertyId, string)	Tetszőleges tulajdonságot állít be.
setProxy(string, number)	Beállítja a proxykonfigurációt. Csak Node.js környezetekben releváns. Hozzáadva az 1.4.0-s verzióhoz.
setProxy(string, number, string, string)	Beállítja a proxykonfigurációt. Csak Node.js környezetekben releváns. Hozzáadva az 1.4.0-s verzióhoz.
setServiceProperty(string, string, UriQueryParameter)	Beállít egy tulajdonságértéket, amely a megadott csatornával lesz átadva a szolgáltatásnak. Hozzáadva az 1.7.0-s verzióhoz.

Tulajdonság adatai

authorizationToken

Lekéri az engedélyezési jogkivonatot.

string authorizationToken

Tulajdonság értéke

string

endpointId

Lekéri a beszédfelismeréshez használt testreszabott beszédmodell végpontazonosítóját.

string endpointId

Tulajdonság értéke

string

A végpont azonosítója

outputFormat

Lekéri a beszédfelismerés kimeneti formátumát (egyszerű vagy részletes). Megjegyzés: Ez a kimeneti formátum beszédfelismerési eredményhez készült, a [SpeechConfig.speechSynthesisOutputFormat] használatával kérje le a szintetizált hangkimeneti formátumot.

OutputFormat outputFormat

Tulajdonság értéke

OutputFormat

A kimeneti formátumot adja vissza.

region

string region

Tulajdonság értéke

string

A konfigurációban beállított régió.

speechRecognitionLanguage

A konfigurált nyelvet adja vissza.

string speechRecognitionLanguage

Tulajdonság értéke

string

speechSynthesisLanguage

Lekéri a beszédszintetizátor nyelvét. Hozzáadva az 1.11.0-s verzióhoz.

string speechSynthesisLanguage

Tulajdonság értéke

string

A beszédszintézis nyelvét adja vissza.

speechSynthesisOutputFormat

Lekéri a beszédszintézis kimeneti formátumát. Hozzáadva az 1.11.0-s verzióhoz.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Tulajdonság értéke

SpeechSynthesisOutputFormat

A beszédszintézis kimeneti formátumát adja vissza

speechSynthesisVoiceName

Lekéri a beszédszintetizátor hangját. Hozzáadva az 1.11.0-s verzióhoz.

string speechSynthesisVoiceName

Tulajdonság értéke

string

A beszédszintézis hangját adja vissza.

subscriptionKey

string subscriptionKey

Tulajdonság értéke

string

A konfigurációban beállított előfizetési kulcs.

Metódus adatai

close()

Bezárja a konfigurációt.

function close()

enableAudioLogging()

Engedélyezze a hangnaplózást a szolgáltatásban. A hang- és tartalomnaplók a Microsoft tulajdonában lévő tárolóban vagy a Cognitive Services-előfizetéshez (BYOS) engedélyezett Speech-erőforráshoz társított saját tárfiókban vannak tárolva. A naplók 30 nap elteltével törlődnek. Hozzáadva az 1.7.0-s verzióhoz.

function enableAudioLogging()

enableDictation()

Diktálás engedélyezése. Csak a beszéd folyamatos felismerésében támogatott. Hozzáadva az 1.7.0-s verzióhoz.

function enableDictation()

fromAuthorizationToken(string, string)

Létrehozza a speech factory egy példányát a megadott kezdeti engedélyezési jogkivonattal és régióval. Megjegyzés: A hívónak meg kell győződnie arról, hogy az engedélyezési jogkivonat érvényes. Az engedélyezési jogkivonat lejárata előtt a hívónak frissítenie kell azt úgy, hogy meghívja ezt a beállítót egy új érvényes jogkivonattal. Megjegyzés: Használjon a LanguageUnderstanding előfizetési kulcsból származtatott jogkivonatot arra az esetre, ha az Intent Recognizert szeretné használni. Mivel a konfigurációs értékek másolása új felismerő létrehozásakor történik, az új tokenérték nem lesz érvényes a már létrehozott felismerőkre. A korábban létrehozott felismerők esetében be kell állítania a megfelelő felismerő engedélyezési jogkivonatát a jogkivonat frissítéséhez. Ellenkező esetben a felismerők hibákba ütköznek a felismerés során.

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

Paraméterek

authorizationToken

string

A kezdeti engedélyezési jogkivonat.

region

string

A régió neve (lásd a régió oldalát).

Válaszok

SpeechConfig

Egy speech factory-példány.

fromEndpoint(URL, string)

Létrehozza a beszédkonfigurálás egy példányát a megadott végponttal és előfizetési kulccsal. Ez a módszer csak olyan felhasználók számára készült, akik nem szabványos szolgáltatásvégpontot vagy paramétereket használnak. Megjegyzés: Használja a LanguageUnderstanding előfizetői azonosítóját arra az esetre, ha az Intent Recognizert szeretné használni. Megjegyzés: A végpont URL-címében megadott lekérdezési paraméterek nem változnak, még akkor sem, ha más API-k állítják be őket. Ha például a nyelv az URI-ban a "language=de-DE" lekérdezési paraméterként van definiálva, és a SpeechConfig.speechRecognitionLanguage = "en-US" paraméterrel is meg van adva, akkor az URI nyelvbeállítása elsőbbséget élvez, a tényleges nyelv pedig a "de-DE". Más API-k csak a végpont URL-címében nem megadott paramétereket állíthatják be. Megjegyzés: Ha az engedélyezési jogkivonatot fromEndpointtal szeretné használni, adjon át egy üres sztringet a subscriptionKey metódusnak a fromEndpoint metódusban, majd állítsa be az authorizationToken="token" értéket a létrehozott SpeechConfig-példányon az engedélyezési jogkivonat használatára.

static function fromEndpoint(endpoint: URL, subscriptionKey?: string): SpeechConfig

Paraméterek

endpoint

URL

A szolgáltatásvégpont, amelyhez csatlakozni szeretne.

subscriptionKey

string

Az előfizetési kulcs. Ha nincs megadva előfizetési kulcs, be kell állítani egy engedélyezési jogkivonatot.

Válaszok

SpeechConfig

Egy speech factory-példány.

fromHost(URL, string)

Létrehozza a beszédkonfigurálás egy példányát a megadott gazdagéppel és előfizetési kulccsal. Ez a módszer csak olyan felhasználók számára készült, akik nem alapértelmezett szolgáltatásgazdát használnak. A rendszer standard erőforrás-elérési utat feltételez. A nem szabványos erőforrás-elérési úttal rendelkező vagy egyáltalán nem elérési úttal rendelkező szolgáltatások esetében használja helyette a fromEndpoint parancsot. Megjegyzés: A lekérdezési paraméterek nem engedélyezettek a gazdagép URI-jában, és más API-knak kell beállítaniuk. Megjegyzés: Ha hitelesítési jogkivonatot szeretne használni a fromHost-hoz, használja a fromHost(URL) parancsot, majd állítsa be az AuthorizationToken tulajdonságot a létrehozott SpeechConfig-példányon. Megjegyzés: Az 1.9.0-s verzióban van hozzáadva.

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

Paraméterek

hostName

URL

subscriptionKey

string

Az előfizetési kulcs. Ha nincs megadva előfizetési kulcs, be kell állítani egy engedélyezési jogkivonatot.

Válaszok

SpeechConfig

Egy speech factory-példány.

fromSubscription(string, string)

A SpeechConfig statikus példánya, amelyet a subscriptionKey és a szolgáltatásrégió átadásával ad vissza. Megjegyzés: Használja a LanguageUnderstanding előfizetői azonosítóját arra az esetre, ha az Intent Recognizert szeretné használni.

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

Paraméterek

subscriptionKey

string

Az előfizetési kulcs.

region

string

A régió neve (lásd a régió oldalát).

Válaszok

SpeechConfig

A speech factory

getProperty(string, string)

Egy tetszőleges tulajdonság aktuális értékét adja vissza.

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

Paraméterek

name

string

A lekérdezendő tulajdonság neve.

def

string

A visszaadandó érték, ha a tulajdonság nem ismert.

Válaszok

string

Az adott tulajdonság aktuális vagy alapértelmezett értéke.

requestWordLevelTimestamps()

Szószintű időbélyegeket tartalmaz. Hozzáadva az 1.7.0-s verzióhoz.

function requestWordLevelTimestamps()

setProfanity(ProfanityOption)

Beállítja a trágárság beállítást. Hozzáadva az 1.7.0-s verzióhoz.

function setProfanity(profanity: ProfanityOption)

Paraméterek

profanity

ProfanityOption

setProperty(string | PropertyId, string)

Tetszőleges tulajdonságot állít be.

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

Paraméterek

name

string | PropertyId

A beállítandó tulajdonság neve.

value

string

A tulajdonság új értéke.

setProxy(string, number)

Beállítja a proxykonfigurációt. Csak Node.js környezetekben releváns. Hozzáadva az 1.4.0-s verzióhoz.

function setProxy(proxyHostName: string, proxyPort: number)

Paraméterek

proxyHostName

string

A proxykiszolgáló állomásneve.

proxyPort

number

A proxykiszolgáló portszáma.

setProxy(string, number, string, string)

Beállítja a proxykonfigurációt. Csak Node.js környezetekben releváns. Hozzáadva az 1.4.0-s verzióhoz.

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

Paraméterek

proxyHostName

string

A proxykiszolgáló állomásneve a protokollséma nélkül (http://)

proxyPort

number

A proxykiszolgáló portszáma.

proxyUserName

string

A proxykiszolgáló felhasználóneve.

proxyPassword

string

A proxykiszolgáló jelszava.

setServiceProperty(string, string, UriQueryParameter)

Beállít egy tulajdonságértéket, amely a megadott csatornával lesz átadva a szolgáltatásnak. Hozzáadva az 1.7.0-s verzióhoz.

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

Paraméterek

name

string

value

string

channel

UriQueryParameter