クラス Translation::SpeechTranslationConfig
class Translation::SpeechTranslationConfig
: public SpeechConfig
音声入力を使用した翻訳の構成を定義するクラス。
メンバー
AddTargetLanguage
構文: public inline void AddTargetLanguage ( const std::string & language );
翻訳のターゲット言語を追加します。
パラメーター
language
追加する翻訳ターゲット言語。
RemoveTargetLanguage
構文: public inline void RemoveTargetLanguage ( const std::string & language );
翻訳対象の言語を削除します。 リリース 1.7.0 で追加されました。
パラメーター
language
削除する翻訳ターゲット言語。
GetTargetLanguages
構文: public inline std::vector< std::string > GetTargetLanguages ( ) const;
翻訳のターゲット言語を取得します。
戻り値
翻訳ターゲット言語のベクター。
SetVoiceName
構文: public inline void SetVoiceName ( const std::string & voice );
出力音声名を設定します。
パラメーター
voice
設定する音声名。
GetVoiceName
構文: public inline std::string GetVoiceName ( ) const;
出力音声名を取得します。
戻り値
音声名を出力します。
FromSubscription
構文: public inline static std::shared_ptr< SpeechTranslationConfig > FromSubscription ( const std::string & subscription , const std::string & region );
指定したサブスクリプション キーとリージョンを使用して、音声翻訳構成のインスタンスを作成します。
パラメーター
subscription
サブスクリプション キー。region
リージョン名 ( リージョン ページを参照)。
戻り値
音声翻訳構成インスタンスへの共有ポインター。
FromAuthorizationToken
構文: public inline static std::shared_ptr< SpeechTranslationConfig > FromAuthorizationToken ( const std::string & authToken , const std::string & region );
指定した承認トークンとリージョンを使用して、音声翻訳構成のインスタンスを作成します。
パラメーター
authToken
承認トークン。region
リージョン名 ( リージョン ページを参照)。
戻り値
音声翻訳構成インスタンスへの共有ポインター。
FromEndpoint
構文: public inline static std::shared_ptr< SpeechTranslationConfig > FromEndpoint ( const std::string & endpoint , const std::string & subscription );
エンドポイントとサブスクリプションを指定して、音声翻訳構成のインスタンスを作成します。 このメソッドは、標準以外のサービス エンドポイントを使用するユーザーのみを対象としています。 注: エンドポイント URI で指定されたクエリ パラメーターは、他の API によって設定されている場合でも変更されません。 たとえば、認識言語が URI でクエリ パラメーター "language=de-DE" として定義され、SetSpeechRecognitionLanguage("en-US") によっても設定されている場合、URI の言語設定が優先され、有効な言語は "de-DE" になります。 他の API では、エンドポイント URI で指定されていないパラメーターのみを設定できます。 注: FromEndpoint で承認トークンを使用するには、FromEndpoint(const SPXSTRING&) を使用し、作成された SpeechTranslationConfig インスタンスで SetAuthorizationToken() を呼び出してください。
パラメーター
endpoint
接続するサービス エンドポイント。subscription
サブスクリプション キー。
戻り値
新しい SpeechTranslationConfig インスタンスへの共有ポインター。
FromEndpoint
構文: public inline static std::shared_ptr< SpeechTranslationConfig > FromEndpoint ( const std::string & endpoint );
指定したエンドポイントを使用して音声翻訳構成のインスタンスを作成します。 このメソッドは、標準以外のサービス エンドポイントを使用するユーザーのみを対象としています。 注: エンドポイント URI で指定されたクエリ パラメーターは、他の API によって設定されている場合でも変更されません。 たとえば、認識言語が URI でクエリ パラメーター "language=de-DE" として定義され、SetSpeechRecognitionLanguage("en-US") によっても設定されている場合、URI の言語設定が優先され、有効な言語は "de-DE" になります。 他の API では、エンドポイント URI で指定されていないパラメーターのみを設定できます。 注: エンドポイントで認証にサブスクリプション キーが必要な場合は、FromEndpoint(const SPXSTRING&、const SPXSTRING&) を使用して、サブスクリプション キーをパラメーターとして渡してください。 FromEndpoint で承認トークンを使用するには、このメソッドを使用して SpeechTranslationConfig インスタンスを作成し、作成された SpeechTranslationConfig インスタンスで SetAuthorizationToken() を呼び出します。 注: バージョン 1.5.0 で追加されました。
パラメーター
endpoint
接続するサービス エンドポイント。
戻り値
新しい SpeechTranslationConfig インスタンスへの共有ポインター。
FromHost
構文: public inline static std::shared_ptr< SpeechTranslationConfig > FromHost ( const std::string & host , const std::string & subscription );
指定したホストとサブスクリプションを使用して音声翻訳構成のインスタンスを作成します。 このメソッドは、既定以外のサービス ホストを使用するユーザーのみを対象としています。 標準リソース パスが想定されます。 標準以外のリソース パスを持つサービスまたはパスがまったくないサービスの場合は、代わりに FromEndpoint を使用します。 注: クエリ パラメーターはホスト URI では許可されず、他の API で設定する必要があります。 注: FromHost で承認トークンを使用するには、FromHost(const SPXSTRING&) を使用し、作成された SpeechTranslationConfig インスタンスで SetAuthorizationToken() を呼び出します。 注: バージョン 1.8.0 で追加されました。
パラメーター
host
接続するサービス ホスト。 形式は "protocol://host:port" で、":p ort" は省略可能です。subscription
サブスクリプション キー。
戻り値
新しい SpeechTranslationConfig インスタンスへの共有ポインター。
FromHost
構文: public inline static std::shared_ptr< SpeechTranslationConfig > FromHost ( const std::string & host );
指定したホストを使用して音声翻訳構成のインスタンスを作成します。 このメソッドは、既定以外のサービス ホストを使用するユーザーのみを対象としています。 標準リソース パスが想定されます。 標準以外のリソース パスを持つサービスまたはパスがまったくないサービスの場合は、代わりに FromEndpoint を使用します。 注: クエリ パラメーターはホスト URI では許可されず、他の API で設定する必要があります。 注: ホストで認証にサブスクリプション キーが必要な場合は、FromHost(const SPXSTRING&、const SPXSTRING&) を使用して、サブスクリプション キーをパラメーターとして渡します。 FromHost で承認トークンを使用するには、このメソッドを使用して SpeechTranslationConfig インスタンスを作成し、作成された SpeechTranslationConfig インスタンスで SetAuthorizationToken() を呼び出します。 注: バージョン 1.8.0 で追加されました。
パラメーター
host
接続するサービス ホスト。 形式は "protocol://host:port" で、":p ort" は省略可能です。
戻り値
新しい SpeechTranslationConfig インスタンスへの共有ポインター。