次の方法で共有


SpeechConfig クラス

音声/意図認識、または音声合成の構成を定義するクラス。

メンバー

EmbeddedSpeechConfig

構文: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

構文: public friend HybridSpeechConfig;

演算子 SPXSPEECHCONFIGHANDLE

構文: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

基になるハンドル値を取得するために使用される内部演算子。

戻り値

ハンドル。

SetSpeechRecognitionLanguage

構文: public inline void SetSpeechRecognitionLanguage ( const std::string & lang );

入力言語を音声認識エンジンに設定します。

パラメーター

  • lang BCP-47 形式で認識される音声言語の名前を指定します。

GetSpeechRecognitionLanguage

構文: public inline std::string GetSpeechRecognitionLanguage ( ) const;

音声認識への入力言語を取得します。 言語は BCP-47 形式で指定されています。

戻り値

音声認識言語。

SetSpeechSynthesisLanguage

構文: public inline void SetSpeechSynthesisLanguage ( const std::string & lang );

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

パラメーター

  • lang 言語の名前を指定します (例: en-US)

GetSpeechSynthesisLanguage

構文: public inline std::string GetSpeechSynthesisLanguage ( ) const;

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

戻り値

音声合成言語。

SetSpeechSynthesisVoiceName

構文: public inline void SetSpeechSynthesisVoiceName ( const std::string & voiceName );

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

パラメーター

  • voiceName 音声の名前を指定します

GetSpeechSynthesisVoiceName

構文: public inline std::string GetSpeechSynthesisVoiceName ( ) const;

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

戻り値

音声合成音声名。

SetSpeechSynthesisOutputFormat

構文: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

音声合成出力形式 (Riff16Khz16BitMonoPcm など) を設定します。 バージョン 1.4.0 で追加されました。

パラメーター

  • formatId 出力形式 ID を指定します

GetSpeechSynthesisOutputFormat

構文: public inline std::string GetSpeechSynthesisOutputFormat ( ) const;

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

戻り値

音声合成出力形式。

SetEndpointId

構文: public inline void SetEndpointId ( const std::string & endpointId );

Custom Speech または Custom Voice のエンドポイント ID を設定します。

パラメーター

  • endpointId エンドポイント ID。

GetEndpointId

構文: public inline std::string GetEndpointId ( ) const;

Custom Speech または Custom Voice のエンドポイント ID を取得します。

戻り値

エンドポイント ID。

SetAuthorizationToken

構文: public inline void SetAuthorizationToken ( const std::string & token );

サービスに接続する承認トークンを設定します。 注: 呼び出し元は、承認トークンが有効であることを確認する必要があります。 認証トークンの有効期限が切れる前に、呼び出し元は、新しい有効なトークンを使用してこのセッターを呼び出すことによって、認証トークンを更新する必要があります。 新しい認識エンジンの作成時に構成値がコピーされるため、新しいトークン値は既に作成されている認識エンジンには適用されません。 以前に作成された認識エンジンの場合、トークンを更新するには、対応する認識エンジンの承認トークンを設定する必要があります。 それ以外の場合、認識中に認識エンジンでエラーが発生します。

パラメーター

  • token 承認トークン。

GetAuthorizationToken

構文: public inline std::string GetAuthorizationToken ( ) const;

サービスに接続するための承認トークンを取得します。

戻り値

承認トークン。

GetSubscriptionKey

構文: public inline std::string GetSubscriptionKey ( ) const;

Speech Recognizer または Intent Recognizer、Translation Recognizer、Speech シンセサイザーの作成に使用されるサブスクリプション キーを取得します。

戻り値

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

GetRegion

構文: public inline std::string GetRegion ( ) const;

Speech Recognizer または Intent Recognizer、Translation Recognizer、Speech シンセサイザーの作成に使用するリージョン キーを取得します。

戻り値

地域。

GetOutputFormat

構文: public inline OutputFormat GetOutputFormat ( ) const;

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

戻り値

音声認識の出力形式。

SetOutputFormat

構文: public inline void SetOutputFormat ( OutputFormat format );

音声認識の出力形式 (単純または詳細) を設定します。 注: この出力形式は音声認識の結果用です。合成オーディオ出力形式を設定するには、 SpeechConfig::SetSpeechSynthesisOutputFormat を使用します。

パラメーター

  • format 音声認識の出力形式

SetProfanity

構文: public inline void SetProfanity ( ProfanityOption profanity );

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

パラメーター

  • profanity 不適切な表現オプションの値。

EnableAudioLogging

構文: public inline void EnableAudioLogging ( );

サービスでオーディオ ログを有効にします。 バージョン 1.5.0 で追加されました。

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

RequestWordLevelTimestamps

構文: public inline void RequestWordLevelTimestamps ( );

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

EnableDictation

構文: public inline void EnableDictation ( );

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

SetProxy

構文: public inline void SetProxy ( const std::string & proxyHostName , uint32_t proxyPort , const std::string & proxyUserName , const std::string & proxyPassword );

バージョン 1.1.0 で追加されたプロキシ構成を設定します。

注: macOS ではプロキシ機能を使用できません。 この関数は、このプラットフォームには影響しません。

パラメーター

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

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

  • proxyUserName プロキシ サーバーのユーザー名

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

SetProperty

構文: public inline void SetProperty ( const std::string & name , const std::string & value );

名前でプロパティ値を設定します。

パラメーター

  • name プロパティ名。

  • value プロパティ値。

GetProperty

構文: public inline std::string GetProperty ( const std::string & name ) const;

名前でプロパティ値を取得します。

パラメーター

  • name パラメーター名。

戻り値

プロパティ値。

GetProperty

構文: public inline std::string GetProperty ( PropertyId id ) const;

ID でプロパティ値を取得します。

パラメーター

  • id パラメーター ID。

戻り値

プロパティ値。

SetProperty

構文: public inline void SetProperty ( PropertyId id , const std::string & value );

ID でプロパティ値を設定します。

パラメーター

  • id プロパティ ID。

  • value プロパティ値。

SetServiceProperty

構文: public inline void SetServiceProperty ( const std::string & name , const std::string & value , ServicePropertyChannel channel );

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

パラメーター

  • name プロパティ名。

  • value プロパティ値。

  • channel 指定したプロパティをサービスに渡すために使用されるチャネル。

~SpeechConfig

構文: public inline virtual ~SpeechConfig ( );

オブジェクトを破棄します。

FromSubscription

構文: public inline static std::shared_ptr< SpeechConfig > FromSubscription ( const std::string & subscription , const std::string & region );

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

パラメーター

戻り値

新しい音声構成インスタンスへの共有ポインター。

FromAuthorizationToken

構文: public inline static std::shared_ptr< SpeechConfig > FromAuthorizationToken ( const std::string & authToken , const std::string & region );

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

パラメーター

戻り値

新しい音声構成インスタンスへの共有ポインター。

FromEndpoint

構文: public inline static std::shared_ptr< SpeechConfig > 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&) を使用し、作成された SpeechConfig インスタンスで SetAuthorizationToken() を呼び出します。

パラメーター

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

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

戻り値

新しい音声構成インスタンスへの共有ポインター。

FromEndpoint

構文: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint );

指定したエンドポイントを使用して SpeechConfig のインスタンスを作成します。 このメソッドは、標準以外のサービス エンドポイントを使用するユーザーのみを対象としています。 注: エンドポイント URI で指定されたクエリ パラメーターは、他の API によって設定されている場合でも変更されません。 特定のクエリ パラメーターがサポートされているかどうかは、エンドポイントとシナリオによって異なります。 たとえば、認識言語が URI でクエリ パラメーター "language=de-DE" として定義され、SetSpeechRecognitionLanguage("en-US") によっても設定されている場合、URI の言語設定が優先され、有効な言語は "de-DE" になります。 この例は、エンドポイントとシナリオの組み合わせでクエリ パラメーターとして言語がサポートされている場合にのみ適用されます。 他の API では、エンドポイント URI で指定されていないパラメーターのみを設定できます。 注: エンドポイントで認証にサブスクリプション キーが必要な場合は、FromEndpoint(const SPXSTRING&、const SPXSTRING&) を使用して、サブスクリプション キーをパラメーターとして渡します。 FromEndpoint で承認トークンを使用するには、このメソッドを使用して SpeechConfig インスタンスを作成し、作成された SpeechConfig インスタンスで SetAuthorizationToken() を呼び出します。 注: バージョン 1.5.0 で追加されました。

パラメーター

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

戻り値

新しい音声構成インスタンスへの共有ポインター。

FromHost

構文: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host , const std::string & subscription );

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

パラメーター

  • host 接続するサービス ホスト。 形式は "protocol://host:port" で、":p ort" は省略可能です。

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

戻り値

新しい音声構成インスタンスへの共有ポインター。

FromHost

構文: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host );

指定したホストを使用して SpeechConfig のインスタンスを作成します。 このメソッドは、既定以外のサービス ホストを使用するユーザーのみを対象としています。 標準リソース パスが想定されます。 標準以外のリソース パスを持つサービスまたはパスがまったくないサービスの場合は、代わりに FromEndpoint を使用します。 注: クエリ パラメーターはホスト URI では許可されず、他の API で設定する必要があります。 注: ホストで認証にサブスクリプション キーが必要な場合は、FromHost(const SPXSTRING&、const SPXSTRING&) を使用して、サブスクリプション キーをパラメーターとして渡します。 FromHost で承認トークンを使用するには、このメソッドを使用して SpeechConfig インスタンスを作成し、作成された SpeechConfig インスタンスで SetAuthorizationToken() を呼び出します。 注: バージョン 1.8.0 で追加されました。

パラメーター

  • host 接続するサービス ホスト URI。 形式は "protocol://host:port" で、":p ort" は省略可能です。

戻り値

新しい音声構成インスタンスへの共有ポインター。