IAgentCharacterEx::GetTTSModeID
[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない場合があります。]
HRESULT GetTTSModeID(
BSTR * pbszModeID // address of TTS engine ID
);
文字に設定されている TTS エンジンのモード ID を取得します。
- 操作が成功したことを示すS_OKを返します。
-
pbszModeID
-
文字の TTS エンジンのモード ID 設定を受け取る BSTR のアドレス。
この設定は、文字の読み上げ出力の TTS (テキスト読み上げ) エンジン モード ID を返します。 TTS エンジンのモード ID は、エンジンを一意に識別する音声ベンダーによって定義された GUID (中かっことダッシュで書式設定) の文字列表現です。 詳細については、 Microsoft Speech SDK のドキュメントを参照してください。 このプロパティのクエリを実行すると、関連付けられているエンジンがまだ読み込まれていない場合に読み込まれます。
文字に TTS エンジン モード ID を設定しない場合、サーバーは、文字のコンパイルされた TTS 設定と文字の現在の言語設定に一致するエンジンを返そうとします (Microsoft Speech API インターフェイスを使用)。 これらが異なる場合、文字の言語設定は作成モードの設定をオーバーライドします。 文字の言語設定を設定していない場合、文字の言語はユーザーの既定の言語 ID であり、サーバーはその言語 ID に基づいて一致を試みます。
IAgentAudioObjectProperties::GetEnabled が False を返した場合、この関数は失敗しません。
このプロパティは、クライアント アプリケーションによる 文字の使用にのみ適用されます。設定は、文字の他のクライアントやクライアント アプリケーションの他の文字には影響しません。
Microsoft エージェントの音声エンジンの要件は、Microsoft Speech API に基づいています。 Microsoft エージェントの SAPI 要件をサポートするエンジンは、エージェントと共にインストールして使用できます。
参照
IAgentCharacterEx::SetTTSModeID