SpeechTranslationConfig class
音声翻訳の構成。
- Extends
プロパティ
authorization |
承認トークンを取得または設定します。 注: 呼び出し元は、承認トークンが有効であることを確認する必要があります。 認証トークンの有効期限が切れる前に、呼び出し元は、新しい有効なトークンを使用してこのセッターを呼び出すことによって、認証トークンを更新する必要があります。 |
endpoint |
音声認識に使用されるカスタマイズされた音声モデルのエンドポイント ID を取得します。 |
output |
音声認識の出力形式 (単純または詳細) を取得します。 注: この出力形式は音声認識の結果を対象とします。合成されたオーディオ出力形式を取得するには、[SpeechConfig.speechSynthesisOutputFormat] を使用します。 |
region | |
speech |
音声認識言語を取得または設定します。 |
speech |
音声シンセサイザーの言語を取得します。 バージョン 1.11.0 で追加されました。 |
speech |
音声合成出力形式を取得します。 バージョン 1.11.0 で追加されました。 |
speech |
音声シンセサイザーの音声を取得します。 バージョン 1.11.0 で追加されました。 |
subscription |
|
target |
翻訳先の (テキスト) ターゲット言語を取得します。 |
voice |
選択した音声名を取得します。 |
メソッド
add |
翻訳先の (テキスト) ターゲット言語を追加します。 |
close() | 関連付けられているリソースを破棄します。 |
from |
承認トークンとサービス リージョンを渡すことによって返される SpeechTranslationConfig の静的インスタンス。 注: 呼び出し元は、承認トークンが有効であることを確認する必要があります。 承認トークンの有効期限が切れる前に、呼び出し元はプロパティ authorizationToken に新しい有効なトークンを設定して更新する必要があります。 そうしないと、この SpeechTranslationConfig インスタンスによって作成されたすべての認識エンジンで、認識中にエラーが発生します。 新しい認識エンジンの作成時に構成値がコピーされるため、新しいトークン値は既に作成されている認識エンジンには適用されません。 以前に作成された認識エンジンの場合、トークンを更新するには、対応する認識エンジンの承認トークンを設定する必要があります。 そうしないと、認識中に認識エンジンでエラーが発生します。 |
from |
エンドポイントとサブスクリプション キーを指定して、音声翻訳構成のインスタンスを作成します。 このメソッドは、標準以外のサービス エンドポイントまたはパラメーターを使用するユーザーのみを対象としています。 注: エンドポイント URL で指定されたクエリ プロパティは、他の API によって設定されている場合でも変更されません。 たとえば、uri で language がクエリ パラメーター "language=de-DE" として定義され、speechRecognitionLanguage プロパティによっても設定されている場合、uri の言語設定が優先され、有効な言語は "de-DE" になります。 エンドポイント URL で指定されていないプロパティのみを他の API で設定できます。 注: fromEndpoint で承認トークンを使用するには、fromEndpoint メソッドの subscriptionKey に空の文字列を渡し、作成された SpeechConfig インスタンスで authorizationToken="token" を設定して承認トークンを使用します。 |
from |
指定したホストキーとサブスクリプション キーを使用して、音声構成のインスタンスを作成します。 このメソッドは、既定以外のサービス ホストを使用するユーザーのみを対象としています。 標準リソース パスが想定されます。 標準以外のリソース パスを持つサービス、またはパスがまったくないサービスの場合は、代わりに fromEndpoint を使用してください。 注: クエリ パラメーターはホスト URI では許可されず、他の API で設定する必要があります。 注: fromHost で承認トークンを使用するには、fromHost(URL) を使用し、作成された SpeechConfig インスタンスに AuthorizationToken プロパティを設定します。 注: バージョン 1.9.0 で追加されました。 |
from |
サブスクリプション キーとサービス リージョンを渡すことによって返される SpeechTranslationConfig の静的インスタンス。 |
set |
名前付きプロパティを値として設定します |
継承されたメソッド
enable |
サービスでオーディオ ログを有効にします。 オーディオ ログとコンテンツ ログは、Microsoft が所有するストレージ、または Cognitive Services サブスクリプションにリンクされている独自のストレージ アカウント (Bring Your Own Storage (BYOS) 対応 Speech リソース) のいずれかに格納されます。 ログは 30 日後に削除されます。 バージョン 1.7.0 で追加されました。 |
enable |
ディクテーションを有効にします。 音声認識でのみサポートされます。 バージョン 1.7.0 で追加されました。 |
get |
任意のプロパティの現在の値を返します。 |
request |
単語レベルのタイムスタンプが含まれます。 バージョン 1.7.0 で追加されました。 |
set |
不適切な表現オプションを設定します。 バージョン 1.7.0 で追加されました。 |
set |
プロキシ構成を設定します。 Node.js 環境でのみ関連します。 バージョン 1.4.0 で追加されました。 |
set |
プロキシ構成を設定します。 Node.js 環境でのみ関連します。 バージョン 1.4.0 で追加されました。 |
set |
指定したチャネルを使用してサービスに渡されるプロパティ値を設定します。 バージョン 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()
enableDictation()
ディクテーションを有効にします。 音声認識でのみサポートされます。 バージョン 1.7.0 で追加されました。
function enableDictation()
getProperty(string, string)
任意のプロパティの現在の値を返します。
function getProperty(name: string, def?: string): string
パラメーター
- name
-
string
クエリを実行するプロパティの名前。
- def
-
string
プロパティが不明な場合に返す値。
戻り値
string
指定されたプロパティの現在の値 (指定された既定値)。
requestWordLevelTimestamps()
単語レベルのタイムスタンプが含まれます。 バージョン 1.7.0 で追加されました。
function requestWordLevelTimestamps()
setProfanity(ProfanityOption)
不適切な表現オプションを設定します。 バージョン 1.7.0 で追加されました。
function setProfanity(profanity: ProfanityOption)
パラメーター
- profanity
- ProfanityOption
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, UriQueryParameter)
指定したチャネルを使用してサービスに渡されるプロパティ値を設定します。 バージョン 1.7.0 で追加されました。
function setServiceProperty(name: string, value: string, channel: UriQueryParameter)
パラメーター
- name
-
string
- value
-
string
- channel
- UriQueryParameter