SpeechTranslationConfig class

音声翻訳の構成。

Extends

プロパティ

authorizationToken

承認トークンを取得または設定します。 注: 呼び出し元は、承認トークンが有効であることを確認する必要があります。 認証トークンの有効期限が切れる前に、呼び出し元は、新しい有効なトークンを使用してこのセッターを呼び出すことによって、認証トークンを更新する必要があります。

endpointId

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

outputFormat

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

region
speechRecognitionLanguage

音声認識言語を取得または設定します。

speechSynthesisLanguage

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

speechSynthesisOutputFormat

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

speechSynthesisVoiceName

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

subscriptionKey
targetLanguages

翻訳先の (テキスト) ターゲット言語を取得します。

voiceName

選択した音声名を取得します。

メソッド

addTargetLanguage(string)

翻訳先の (テキスト) ターゲット言語を追加します。

close()

関連付けられているリソースを破棄します。

fromAuthorizationToken(string, string)

承認トークンとサービス リージョンを渡すことによって返される SpeechTranslationConfig の静的インスタンス。 注: 呼び出し元は、承認トークンが有効であることを確認する必要があります。 承認トークンの有効期限が切れる前に、呼び出し元はプロパティ authorizationToken に新しい有効なトークンを設定して更新する必要があります。 そうしないと、この SpeechTranslationConfig インスタンスによって作成されたすべての認識エンジンで、認識中にエラーが発生します。 新しい認識エンジンの作成時に構成値がコピーされるため、新しいトークン値は既に作成されている認識エンジンには適用されません。 以前に作成された認識エンジンの場合、トークンを更新するには、対応する認識エンジンの承認トークンを設定する必要があります。 そうしないと、認識中に認識エンジンでエラーが発生します。

fromEndpoint(URL, string)

エンドポイントとサブスクリプション キーを指定して、音声翻訳構成のインスタンスを作成します。 このメソッドは、標準以外のサービス エンドポイントまたはパラメーターを使用するユーザーのみを対象としています。 注: エンドポイント URL で指定されたクエリ プロパティは、他の API によって設定されている場合でも変更されません。 たとえば、uri で language がクエリ パラメーター "language=de-DE" として定義され、speechRecognitionLanguage プロパティによっても設定されている場合、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)

サブスクリプション キーとサービス リージョンを渡すことによって返される SpeechTranslationConfig の静的インスタンス。

setProperty(string | PropertyId, string)

名前付きプロパティを値として設定します

継承されたメソッド

enableAudioLogging()

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

enableDictation()

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

getProperty(string, string)

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

requestWordLevelTimestamps()

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

setProfanity(ProfanityOption)

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

setProxy(string, number)

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

setProxy(string, number, string, string)

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

setServiceProperty(string, string, UriQueryParameter)

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

プロパティの詳細

authorizationToken

承認トークンを取得または設定します。 注: 呼び出し元は、承認トークンが有効であることを確認する必要があります。 認証トークンの有効期限が切れる前に、呼び出し元は、新しい有効なトークンを使用してこのセッターを呼び出すことによって、認証トークンを更新する必要があります。

void authorizationToken

プロパティ値

void

endpointId

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

string endpointId

プロパティ値

string

エンドポイント ID

outputFormat

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

OutputFormat outputFormat

プロパティ値

出力形式を返します。

region

string region

プロパティ値

string

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

speechRecognitionLanguage

音声認識言語を取得または設定します。

void speechRecognitionLanguage

プロパティ値

void

speechSynthesisLanguage

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

string speechSynthesisLanguage

プロパティ値

string

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

speechSynthesisOutputFormat

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

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

プロパティ値

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

speechSynthesisVoiceName

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

string speechSynthesisVoiceName

プロパティ値

string

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

subscriptionKey

string subscriptionKey

プロパティ値

string

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

targetLanguages

翻訳先の (テキスト) ターゲット言語を取得します。

string[] targetLanguages

プロパティ値

string[]

voiceName

選択した音声名を取得します。

string voiceName

プロパティ値

string

音声名。

メソッドの詳細

addTargetLanguage(string)

翻訳先の (テキスト) ターゲット言語を追加します。

function addTargetLanguage(value: string)

パラメーター

value

string

de-DE などの言語

close()

関連付けられているリソースを破棄します。

function close()

fromAuthorizationToken(string, string)

承認トークンとサービス リージョンを渡すことによって返される SpeechTranslationConfig の静的インスタンス。 注: 呼び出し元は、承認トークンが有効であることを確認する必要があります。 承認トークンの有効期限が切れる前に、呼び出し元はプロパティ authorizationToken に新しい有効なトークンを設定して更新する必要があります。 そうしないと、この SpeechTranslationConfig インスタンスによって作成されたすべての認識エンジンで、認識中にエラーが発生します。 新しい認識エンジンの作成時に構成値がコピーされるため、新しいトークン値は既に作成されている認識エンジンには適用されません。 以前に作成された認識エンジンの場合、トークンを更新するには、対応する認識エンジンの承認トークンを設定する必要があります。 そうしないと、認識中に認識エンジンでエラーが発生します。

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

パラメーター

authorizationToken

string

承認トークン。

region

string

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

戻り値

音声翻訳の構成。

fromEndpoint(URL, string)

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

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

パラメーター

endpoint

URL

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

subscriptionKey

string

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

戻り値

音声構成インスタンス。

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

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

戻り値

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

fromSubscription(string, string)

サブスクリプション キーとサービス リージョンを渡すことによって返される SpeechTranslationConfig の静的インスタンス。

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

パラメーター

subscriptionKey

string

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

region

string

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

戻り値

音声翻訳の構成。

setProperty(string | PropertyId, string)

名前付きプロパティを値として設定します

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

パラメーター

name

string | PropertyId

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

value

string

プロパティの新しい値。

継承済みメソッドの詳細

enableAudioLogging()

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

function enableAudioLogging()

SpeechConfig.enableAudioLoggingから継承

enableDictation()

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

function enableDictation()

SpeechConfig.enableDictationから継承

getProperty(string, string)

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

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

パラメーター

name

string

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

def

string

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

戻り値

string

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

SpeechConfig.getPropertyから継承

requestWordLevelTimestamps()

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

function requestWordLevelTimestamps()

SpeechConfig.requestWordLevelTimestampsから継承

setProfanity(ProfanityOption)

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

function setProfanity(profanity: ProfanityOption)

パラメーター

profanity
ProfanityOption

SpeechConfig.setProfanityから継承

setProxy(string, number)

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

function setProxy(proxyHostName: string, proxyPort: number)

パラメーター

proxyHostName

string

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

proxyPort

number

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

SpeechConfig.setProxyから継承

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

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

SpeechConfig.setProxyから継承

setServiceProperty(string, string, UriQueryParameter)

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

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

パラメーター

name

string

value

string

SpeechConfig.setServicePropertyから継承