クラス 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 );

指定したサブスクリプション キーとリージョンを使用して、音声翻訳構成のインスタンスを作成します。

パラメーター

戻り値

音声翻訳構成インスタンスへの共有ポインター。

FromAuthorizationToken

構文: public inline static std::shared_ptr< SpeechTranslationConfig > FromAuthorizationToken ( const std::string & authToken , const std::string & 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 インスタンスへの共有ポインター。