SpeechConfigImpl class

  • リファレンス
パッケージ:
microsoft-cognitiveservices-speech-sdk
Extends
SpeechConfig

プロパティ

authorizationToken

承認トークンを取得します。
autoDetectSourceLanguages
endPoint
endpointId

音声認識に使用されるカスタマイズされた音声モデルのエンドポイント ID を取得します。
outputFormat

音声認識の出力形式 (単純または詳細) を取得します。 注: この出力形式は音声認識の結果を対象とします。合成されたオーディオ出力形式を取得するには、[SpeechConfig.speechSynthesisOutputFormat] を使用します。
properties
region
speechRecognitionLanguage

構成された言語を返します。
speechSynthesisLanguage

音声シンセサイザーの言語を取得します。 バージョン 1.11.0 で追加されました。
speechSynthesisOutputFormat

音声合成の出力形式を取得します。 バージョン 1.11.0 で追加されました。
speechSynthesisVoiceName

音声シンセサイザーの音声を取得します。 バージョン 1.11.0 で追加されました。
subscriptionKey

メソッド

clone()
enableAudioLogging()

サービスでオーディオ ログを有効にします。 オーディオ ログとコンテンツ ログは、Microsoft が所有するストレージ、または Cognitive Services サブスクリプションにリンクされている独自のストレージ アカウント (Bring Your Own Storage (BYOS) 対応 Speech リソース) のいずれかに格納されます。 ログは 30 日後に削除されます。 バージョン 1.7.0 で追加されました。
enableDictation()

ディクテーションを有効にします。 音声認識でのみサポートされます。 バージョン 1.7.0 で追加されました。
getProperty(string | PropertyId, string)

任意のプロパティの現在の値を返します。
requestWordLevelTimestamps()

単語レベルのタイムスタンプが含まれます。 バージョン 1.7.0 で追加されました。
setProfanity(ProfanityOption)

不適切な表現オプションを設定します。 バージョン 1.7.0 で追加されました。
setProperty(string | PropertyId, string)

任意のプロパティを設定します。
setProxy(string, number)

プロキシ構成を設定します。 Node.js 環境でのみ関連します。 バージョン 1.4.0 で追加されました。
setProxy(string, number, string, string)

プロキシ構成を設定します。 Node.js 環境でのみ関連します。 バージョン 1.4.0 で追加されました。
setServiceProperty(string, string)

指定したチャネルを使用してサービスに渡されるプロパティ値を設定します。 バージョン 1.7.0 で追加されました。

継承されたメソッド

close()

構成を閉じます。
fromAuthorizationToken(string, string)

指定した初期承認トークンとリージョンを使用して、音声ファクトリのインスタンスを作成します。 注: 呼び出し元は、承認トークンが有効であることを確認する必要があります。 認証トークンの有効期限が切れる前に、呼び出し元は、新しい有効なトークンを使用してこのセッターを呼び出すことによって、認証トークンを更新する必要があります。 注: 意図認識エンジンを使用する場合は、LanguageUnderstanding サブスクリプション キーから派生したトークンを使用してください。 新しい認識エンジンの作成時に構成値がコピーされるため、新しいトークン値は既に作成されている認識エンジンには適用されません。 以前に作成された認識エンジンの場合、トークンを更新するには、対応する認識エンジンの承認トークンを設定する必要があります。 そうしないと、認識中に認識エンジンでエラーが発生します。
fromEndpoint(URL, string)

指定したエンドポイントとサブスクリプション キーを使用して、音声構成のインスタンスを作成します。 このメソッドは、標準以外のサービス エンドポイントまたはパラメーターを使用するユーザーのみを対象としています。 注: 意図認識エンジンを使用する場合は、LanguageUnderstanding サブスクリプション キーを使用してください。 注: エンドポイント URL で指定されたクエリ パラメーターは、他の API によって設定されている場合でも変更されません。 たとえば、uri で language がクエリ パラメーター "language=de-DE" として定義され、SpeechConfig.speechRecognitionLanguage = "en-US" によっても設定されている場合、uri の言語設定が優先され、有効な言語は "de-DE" になります。 エンドポイント URL で指定されていないパラメーターのみを他の API で設定できます。 注: fromEndpoint で承認トークンを使用するには、fromEndpoint メソッドの subscriptionKey に空の文字列を渡し、作成された SpeechConfig インスタンスで authorizationToken="token" を設定して承認トークンを使用します。
fromHost(URL, string)

指定したホストキーとサブスクリプション キーを使用して、音声構成のインスタンスを作成します。 このメソッドは、既定以外のサービス ホストを使用するユーザーのみを対象としています。 標準リソース パスが想定されます。 標準以外のリソース パスを持つサービス、またはパスがまったくないサービスの場合は、代わりに fromEndpoint を使用してください。 注: クエリ パラメーターはホスト URI では許可されず、他の API で設定する必要があります。 注: fromHost で承認トークンを使用するには、fromHost(URL) を使用し、作成された SpeechConfig インスタンスに AuthorizationToken プロパティを設定します。 注: バージョン 1.9.0 で追加されました。
fromSubscription(string, string)

subscriptionKey とサービス リージョンを渡すことによって返される SpeechConfig の静的インスタンス。 注: 意図認識エンジンを使用する場合は、LanguageUnderstanding サブスクリプション キーを使用してください。

プロパティの詳細

authorizationToken

承認トークンを取得します。

string authorizationToken

プロパティ値

string

autoDetectSourceLanguages 

string autoDetectSourceLanguages

プロパティ値

string

endPoint 

URL endPoint

プロパティ値

URL

endpointId

音声認識に使用されるカスタマイズされた音声モデルのエンドポイント ID を取得します。

string endpointId

プロパティ値

string

エンドポイント ID

outputFormat

音声認識の出力形式 (単純または詳細) を取得します。 注: この出力形式は音声認識の結果を対象とします。合成されたオーディオ出力形式を取得するには、[SpeechConfig.speechSynthesisOutputFormat] を使用します。

OutputFormat outputFormat

プロパティ値

OutputFormat

出力形式を返します。

properties 

PropertyCollection properties

プロパティ値

PropertyCollection

region 

string region

プロパティ値

string

構成で設定されたリージョン。

speechRecognitionLanguage

構成された言語を返します。

string speechRecognitionLanguage

プロパティ値

string

speechSynthesisLanguage

音声シンセサイザーの言語を取得します。 バージョン 1.11.0 で追加されました。

string speechSynthesisLanguage

プロパティ値

string

音声合成言語を返します。

speechSynthesisOutputFormat

音声合成の出力形式を取得します。 バージョン 1.11.0 で追加されました。

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

プロパティ値

SpeechSynthesisOutputFormat

音声合成の出力形式を返します

speechSynthesisVoiceName

音声シンセサイザーの音声を取得します。 バージョン 1.11.0 で追加されました。

string speechSynthesisVoiceName

プロパティ値

string

音声合成音声を返します。

subscriptionKey 

string subscriptionKey

プロパティ値

string

構成で設定されたサブスクリプション キー。

メソッドの詳細

clone() 

function clone(): SpeechConfigImpl

戻り値

SpeechConfigImpl

enableAudioLogging()

サービスでオーディオ ログを有効にします。 オーディオ ログとコンテンツ ログは、Microsoft が所有するストレージ、または Cognitive Services サブスクリプションにリンクされている独自のストレージ アカウント (Bring Your Own Storage (BYOS) 対応 Speech リソース) のいずれかに格納されます。 ログは 30 日後に削除されます。 バージョン 1.7.0 で追加されました。

function enableAudioLogging()

enableDictation()

ディクテーションを有効にします。 音声認識でのみサポートされます。 バージョン 1.7.0 で追加されました。

function enableDictation()

getProperty(string | PropertyId, string)

任意のプロパティの現在の値を返します。

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

パラメーター

name

string | PropertyId

クエリを実行するプロパティの名前。

def

string

プロパティが不明な場合に返す値。

戻り値

string

指定されたプロパティの現在の値 (指定された既定値)。

requestWordLevelTimestamps()

単語レベルのタイムスタンプが含まれます。 バージョン 1.7.0 で追加されました。

function requestWordLevelTimestamps()

setProfanity(ProfanityOption)

不適切な表現オプションを設定します。 バージョン 1.7.0 で追加されました。

function setProfanity(profanity: ProfanityOption)

パラメーター

profanity
ProfanityOption

setProperty(string | PropertyId, string)

任意のプロパティを設定します。

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

パラメーター

name

string | PropertyId

設定するプロパティの名前。

value

string

プロパティの新しい値。

setProxy(string, number)

プロキシ構成を設定します。 Node.js 環境でのみ関連します。 バージョン 1.4.0 で追加されました。

function setProxy(proxyHostName: string, proxyPort: number)

パラメーター

proxyHostName

string

プロキシ サーバーのホスト名。

proxyPort

number

プロキシ サーバーのポート番号。

setProxy(string, number, string, string)

プロキシ構成を設定します。 Node.js 環境でのみ関連します。 バージョン 1.4.0 で追加されました。

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

パラメーター

proxyHostName

string

プロトコル スキームを使用しないプロキシ サーバーのホスト名 (http://)

proxyPort

number

プロキシ サーバーのポート番号。

proxyUserName

string

プロキシ サーバーのユーザー名。

proxyPassword

string

プロキシ サーバーのパスワード。

setServiceProperty(string, string)

指定したチャネルを使用してサービスに渡されるプロパティ値を設定します。 バージョン 1.7.0 で追加されました。

function setServiceProperty(name: string, value: string)

パラメーター

name

string

value

string

継承済みメソッドの詳細

close()

構成を閉じます。

function close()

SpeechConfig.closeから継承

fromAuthorizationToken(string, string)

指定した初期承認トークンとリージョンを使用して、音声ファクトリのインスタンスを作成します。 注: 呼び出し元は、承認トークンが有効であることを確認する必要があります。 認証トークンの有効期限が切れる前に、呼び出し元は、新しい有効なトークンを使用してこのセッターを呼び出すことによって、認証トークンを更新する必要があります。 注: 意図認識エンジンを使用する場合は、LanguageUnderstanding サブスクリプション キーから派生したトークンを使用してください。 新しい認識エンジンの作成時に構成値がコピーされるため、新しいトークン値は既に作成されている認識エンジンには適用されません。 以前に作成された認識エンジンの場合、トークンを更新するには、対応する認識エンジンの承認トークンを設定する必要があります。 そうしないと、認識中に認識エンジンでエラーが発生します。

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

パラメーター

authorizationToken

string

最初の承認トークン。

region

string

リージョン名 ( リージョン ページを参照)。

戻り値

SpeechConfig

音声ファクトリ インスタンス。

SpeechConfig.fromAuthorizationToken から継承

fromEndpoint(URL, string)

指定したエンドポイントとサブスクリプション キーを使用して、音声構成のインスタンスを作成します。 このメソッドは、標準以外のサービス エンドポイントまたはパラメーターを使用するユーザーのみを対象としています。 注: 意図認識エンジンを使用する場合は、LanguageUnderstanding サブスクリプション キーを使用してください。 注: エンドポイント URL で指定されたクエリ パラメーターは、他の API によって設定されている場合でも変更されません。 たとえば、uri で language がクエリ パラメーター "language=de-DE" として定義され、SpeechConfig.speechRecognitionLanguage = "en-US" によっても設定されている場合、uri の言語設定が優先され、有効な言語は "de-DE" になります。 エンドポイント URL で指定されていないパラメーターのみを他の API で設定できます。 注: fromEndpoint で承認トークンを使用するには、fromEndpoint メソッドの subscriptionKey に空の文字列を渡し、作成された SpeechConfig インスタンスで authorizationToken="token" を設定して承認トークンを使用します。

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

パラメーター

endpoint

URL

接続するサービス エンドポイント。

subscriptionKey

string

サブスクリプション キー。 サブスクリプション キーを指定しない場合は、承認トークンを設定する必要があります。

戻り値

SpeechConfig

音声ファクトリ インスタンス。

SpeechConfig.fromEndpoint から継承

fromHost(URL, string)

指定したホストキーとサブスクリプション キーを使用して、音声構成のインスタンスを作成します。 このメソッドは、既定以外のサービス ホストを使用するユーザーのみを対象としています。 標準リソース パスが想定されます。 標準以外のリソース パスを持つサービス、またはパスがまったくないサービスの場合は、代わりに fromEndpoint を使用してください。 注: クエリ パラメーターはホスト URI では許可されず、他の API で設定する必要があります。 注: fromHost で承認トークンを使用するには、fromHost(URL) を使用し、作成された SpeechConfig インスタンスに AuthorizationToken プロパティを設定します。 注: バージョン 1.9.0 で追加されました。

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

パラメーター

hostName

URL

subscriptionKey

string

サブスクリプション キー。 サブスクリプション キーを指定しない場合は、承認トークンを設定する必要があります。

戻り値

SpeechConfig

音声ファクトリ インスタンス。

SpeechConfig.fromHost から継承

fromSubscription(string, string)

subscriptionKey とサービス リージョンを渡すことによって返される SpeechConfig の静的インスタンス。 注: 意図認識エンジンを使用する場合は、LanguageUnderstanding サブスクリプション キーを使用してください。

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

パラメーター

subscriptionKey

string

サブスクリプション キー。

region

string

リージョン名 ( リージョン ページを参照)。

戻り値

SpeechConfig

音声ファクトリ

SpeechConfig.fromSubscription から継承