次の方法で共有


IAgentCharacterEx::SetTTSModeID

[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない可能性があります。]

HRESULT SetTTSModeID(
   BSTR bszModeID  // TTS engine ID
);

文字に設定されている TTS エンジンのモード ID を設定します。

  • 操作が成功したことを示すS_OKを返します。

bszModeID

文字の TTS エンジンのモード ID 設定。

手記

IAgentCharacterEx:SetTTSModeID は、Speech.dll がインストールされておらず、指定したエンジンが文字のコンパイル済み TTS モード設定と一致しない場合に失敗する可能性があります。

 

この設定により、キャラクターの音声 TTS 出力の優先エンジン モードが決まります。 TTS (テキスト読み上げ) エンジンのモード ID は、(中かっことダッシュで書式設定された) エンジンのモードを一意に識別する音声ベンダーによって定義された GUID です。 詳細については、Microsoft Speech SDK のドキュメントを参照してください。

TTS モード ID を設定すると、文字のコンパイル済み TTS モード ID、現在のシステム言語 ID、および文字の現在の言語 ID に基づいて、音声エンジンとの照合がサーバーによってオーバーライドされます。 ただし、ユーザーが Microsoft Agent プロパティ シートで音声出力を無効にした場合、または関連付けられているエンジンがインストールされていないときにモード ID を設定しようとすると、この呼び出しは失敗します。

文字の TTS エンジン モード ID を設定しない場合、サーバーは文字の言語設定に一致するエンジンを設定します (Microsoft Speech API インターフェイスを使用)。 このプロパティを設定すると、関連付けられているエンジンがまだ読み込まれていない場合に読み込まれます。

このプロパティは、クライアント アプリケーションによる文字の使用にのみ適用されます。この設定は、文字の他のクライアントやクライアント アプリケーションの他の文字には影響しません。

Microsoft エージェントの音声エンジンの要件は、Microsoft Speech API に基づいています。 Microsoft エージェントの SAPI 要件をサポートするエンジンは、エージェントと共にインストールして使用できます。

関連項目

IAgentCharacterEx:GetTTSModeID